{
  "version": 3,
  "summary": "AgentMail is the email API for AI agents — programmatic inboxes to send, receive, reply, search, and manage threaded email. Integrate over the hosted MCP server, the REST API, or the CLI. Real-time delivery is also available over WebSocket (AsyncAPI at https://docs.agentmail.to/asyncapi.json).",
  "credentials": {
    "api_key": {
      "type": "api_key",
      "label": "AgentMail API key",
      "generateUrl": "https://console.agentmail.to",
      "setup": "Generate a key in the dashboard at https://console.agentmail.to, or sign up programmatically with `POST https://api.agentmail.to/v0/agent/sign-up` (the response includes the key, shown once). Keys look like `am_us_…`. Send it as `Authorization: Bearer <key>` on REST requests, as an `x-api-key` header (or `?apiKey=` query) on the MCP server, or via the `AGENTMAIL_API_KEY` environment variable for the SDKs and CLI."
    },
    "oauth": {
      "type": "oauth2",
      "label": "AgentMail OAuth (console identity)",
      "setup": "The hosted MCP server at https://mcp.agentmail.to/mcp is OAuth-protected. The authorization server is https://clerk.console.agentmail.to (RFC 9728 metadata at https://mcp.agentmail.to/.well-known/oauth-protected-resource); the client signs in through console.agentmail.to and the browser OAuth flow runs automatically."
    }
  },
  "surfaces": [
    {
      "type": "mcp",
      "slug": "agentmail-mcp",
      "name": "AgentMail MCP server",
      "url": "https://mcp.agentmail.to/mcp",
      "transports": [
        "streamable-http"
      ],
      "docs": "https://docs.agentmail.to/integrations/mcp",
      "source": "https://github.com/agentmail-to/agentmail-mcp",
      "basis": {
        "via": "declared",
        "source": "https://agentmail.to/.well-known/integrations.json"
      },
      "auth": {
        "status": "required",
        "entries": [
          {
            "use": [
              {
                "id": "oauth",
                "mechanics": {
                  "source": "well-known"
                }
              }
            ],
            "basis": {
              "via": "declared",
              "source": "https://agentmail.to/.well-known/integrations.json"
            }
          },
          {
            "use": [
              {
                "id": "api_key",
                "mechanics": {
                  "source": "http",
                  "in": "header",
                  "headerName": "x-api-key"
                }
              }
            ],
            "basis": {
              "via": "declared",
              "source": "https://agentmail.to/.well-known/integrations.json"
            }
          }
        ]
      }
    },
    {
      "type": "http",
      "slug": "agentmail-rest-api",
      "name": "AgentMail REST API",
      "url": "https://api.agentmail.to",
      "spec": "https://agentmail.to/openapi.json",
      "docs": "https://docs.agentmail.to",
      "basis": {
        "via": "declared",
        "source": "https://agentmail.to/.well-known/integrations.json"
      },
      "auth": {
        "status": "required",
        "entries": [
          {
            "use": [
              {
                "id": "api_key",
                "mechanics": {
                  "source": "http",
                  "in": "header",
                  "headerName": "Authorization",
                  "scheme": "Bearer"
                }
              }
            ],
            "basis": {
              "via": "declared",
              "source": "https://agentmail.to/.well-known/integrations.json"
            }
          }
        ]
      }
    },
    {
      "type": "cli",
      "slug": "agentmail-cli",
      "name": "AgentMail CLI",
      "command": "agentmail",
      "docs": "https://docs.agentmail.to/integrations/cli",
      "packages": [
        {
          "registryType": "npm",
          "identifier": "agentmail-cli",
          "runtimeHint": "npx"
        }
      ],
      "basis": {
        "via": "declared",
        "source": "https://agentmail.to/.well-known/integrations.json"
      },
      "auth": {
        "status": "required",
        "entries": [
          {
            "use": [
              {
                "id": "api_key",
                "mechanics": {
                  "source": "cli",
                  "env": [
                    "AGENTMAIL_API_KEY"
                  ]
                }
              }
            ],
            "basis": {
              "via": "declared",
              "source": "https://agentmail.to/.well-known/integrations.json"
            }
          }
        ]
      }
    },
    {
      "type": "mcp",
      "slug": "agentmail-docs-mcp",
      "name": "AgentMail docs MCP",
      "url": "https://docs.agentmail.to/_mcp/server",
      "transports": [
        "streamable-http"
      ],
      "docs": "https://docs.agentmail.to",
      "basis": {
        "via": "declared",
        "source": "https://agentmail.to/.well-known/integrations.json"
      },
      "auth": {
        "status": "none",
        "basis": {
          "via": "declared",
          "source": "https://agentmail.to/.well-known/integrations.json"
        }
      }
    }
  ]
}