{
  "version": 3,
  "summary": "Samva is a developer email API for product teams: deliverability, versioned templates, inbound threading, and signed webhooks behind one typed send call.",
  "credentials": {
    "samva_api_key": {
      "type": "api_key",
      "label": "Samva API key",
      "generateUrl": "https://samva.dev/docs/developers/authentication",
      "setup": "Create a key in the dashboard under Developers → API Keys. Production keys start with `samva_sk_live_`. Send it as the `X-API-Key` header. The organization is derived from the key."
    },
    "samva_mcp_oauth": {
      "type": "oauth2",
      "label": "Samva MCP OAuth",
      "setup": "Connect an OAuth-capable MCP client to the hosted MCP URL with no headers. The client discovers the Authorization Server from the protected-resource metadata on the MCP host."
    },
    "samva_cli_oauth": {
      "type": "oauth2",
      "label": "Samva CLI login",
      "setup": "Run `samva login` to complete the OAuth 2.0 device flow, then `samva org use <slug>` to select the organization. The session is user-scoped."
    }
  },
  "surfaces": [
    {
      "slug": "samva-api",
      "name": "Samva API",
      "type": "http",
      "docs": "https://samva.dev/docs/developers/rest-api",
      "url": "https://api.samva.dev/v1",
      "basis": {
        "via": "declared",
        "source": "https://samva.dev/.well-known/integrations.json"
      },
      "auth": {
        "status": "required",
        "entries": [
          {
            "use": [
              {
                "id": "samva_api_key",
                "mechanics": {
                  "source": "http",
                  "in": "header",
                  "headerName": "X-API-Key"
                }
              }
            ],
            "basis": {
              "via": "declared",
              "source": "https://samva.dev/.well-known/integrations.json"
            }
          }
        ]
      }
    },
    {
      "slug": "samva-mcp",
      "name": "Samva MCP",
      "type": "mcp",
      "docs": "https://samva.dev/docs/developers/mcp",
      "url": "https://mcp.samva.dev",
      "transports": [
        "streamable-http"
      ],
      "basis": {
        "via": "declared",
        "source": "https://samva.dev/.well-known/integrations.json"
      },
      "auth": {
        "status": "required",
        "entries": [
          {
            "use": [
              {
                "id": "samva_mcp_oauth",
                "mechanics": {
                  "source": "well-known"
                }
              }
            ],
            "basis": {
              "via": "declared",
              "source": "https://samva.dev/.well-known/integrations.json"
            }
          },
          {
            "use": [
              {
                "id": "samva_api_key",
                "mechanics": {
                  "source": "http",
                  "in": "header",
                  "headerName": "X-API-Key"
                }
              }
            ],
            "basis": {
              "via": "declared",
              "source": "https://samva.dev/.well-known/integrations.json"
            }
          }
        ]
      }
    },
    {
      "slug": "samva-cli",
      "name": "Samva CLI",
      "type": "cli",
      "docs": "https://samva.dev/docs/developers/cli",
      "command": "samva",
      "packages": [
        {
          "registryType": "npm",
          "identifier": "@samva/cli",
          "runtimeHint": "npx"
        }
      ],
      "basis": {
        "via": "declared",
        "source": "https://samva.dev/.well-known/integrations.json"
      },
      "auth": {
        "status": "required",
        "entries": [
          {
            "use": [
              {
                "id": "samva_api_key",
                "mechanics": {
                  "source": "cli",
                  "env": [
                    "SAMVA_API_KEY"
                  ]
                }
              }
            ],
            "basis": {
              "via": "declared",
              "source": "https://samva.dev/.well-known/integrations.json"
            }
          },
          {
            "use": [
              {
                "id": "samva_cli_oauth",
                "mechanics": {
                  "source": "cli",
                  "command": "samva login"
                }
              }
            ],
            "basis": {
              "via": "declared",
              "source": "https://samva.dev/.well-known/integrations.json"
            }
          }
        ]
      }
    }
  ]
}