{
  "aid_version": "1.0",
  "identity": {
    "name": "newsletterfit",
    "description": "Newsletter intelligence API and MCP server: search publications, articles, sponsors, topics and entities across the newsletter ecosystem.",
    "version": "1.0.0",
    "deprecated": false
  },
  "connection": {
    "protocol": "mcp",
    "transport": "streamable-http",
    "url": "https://newsletterfit.com/mcp"
  },
  "auth": {
    "type": "bearer",
    "header_name": "Authorization",
    "scheme": "Bearer",
    "scopes": [
      "search:read",
      "publications:read",
      "entities:read",
      "exports:write",
      "alerts:read",
      "watchlist:read",
      "mcp:use"
    ],
    "documentation": "https://newsletterfit.com/auth.md",
    "oauth2": {
      "authorization_server": "https://newsletterfit.com/api/auth",
      "protected_resource_metadata": "https://newsletterfit.com/.well-known/oauth-protected-resource/mcp",
      "scopes": [
        "mcp:read"
      ],
      "pkce": "S256",
      "dynamic_client_registration": true
    }
  },
  "capabilities": {
    "supports_streaming": true,
    "actions": [
      {
        "name": "search-newsletters-tool",
        "intent": "query",
        "semantics": "read"
      },
      {
        "name": "search-articles-tool",
        "intent": "query",
        "semantics": "read"
      },
      {
        "name": "search-entities-tool",
        "intent": "query",
        "semantics": "read"
      },
      {
        "name": "get-newsletter-tool",
        "intent": "query",
        "semantics": "read"
      },
      {
        "name": "get-newsletter-articles-tool",
        "intent": "query",
        "semantics": "read"
      },
      {
        "name": "get-newsletter-intel-tool",
        "intent": "query",
        "semantics": "read"
      },
      {
        "name": "get-article-tool",
        "intent": "query",
        "semantics": "read"
      },
      {
        "name": "get-sponsor-tool",
        "intent": "query",
        "semantics": "read"
      },
      {
        "name": "list-topics-tool",
        "intent": "query",
        "semantics": "read"
      },
      {
        "name": "search-topics-tool",
        "intent": "query",
        "semantics": "read"
      },
      {
        "name": "search-sponsors-tool",
        "intent": "query",
        "semantics": "read"
      },
      {
        "name": "list-alerts-tool",
        "intent": "query",
        "semantics": "read"
      },
      {
        "name": "list-watchlist-tool",
        "intent": "query",
        "semantics": "read"
      },
      {
        "name": "get-topic-tool",
        "intent": "query",
        "semantics": "read"
      },
      {
        "name": "get-rising-newsletters-tool",
        "intent": "query",
        "semantics": "read"
      },
      {
        "name": "get-entity-tool",
        "intent": "query",
        "semantics": "read"
      },
      {
        "name": "create-export-tool",
        "intent": "transaction",
        "semantics": "write"
      }
    ]
  }
}