{
  "serverInfo": {
    "name": "circles",
    "title": "Circles: the hosted WhatsApp MCP for your personal number",
    "version": "0.1.0"
  },
  "description": "Circles is a hosted WhatsApp MCP server for your personal number. It links your existing WhatsApp as a linked device and serves only the chats you choose to your AI agents: read, search, voice notes transcribed (Hebrew and English), photos and documents on request, and sending only in chats you open for it, capped per day and never retried. Not a WhatsApp or Meta product.",
  "websiteUrl": "https://usecircles.app",
  "documentationUrl": "https://usecircles.app/en/api-mcp-docs",
  "transport": {
    "type": "streamable-http",
    "url": "https://app.usecircles.app/api/mcp",
    "note": "Stateless JSON-RPC over HTTP POST: one request, one JSON response, no event stream."
  },
  "remotes": [
    {
      "type": "streamable-http",
      "url": "https://app.usecircles.app/api/mcp"
    }
  ],
  "authentication": {
    "required": true,
    "schemes": [
      "oauth2",
      "bearer"
    ],
    "oauth2": {
      "version": "2.1",
      "protectedResourceMetadata": "https://app.usecircles.app/.well-known/oauth-protected-resource",
      "authorizationServerMetadata": "https://app.usecircles.app/.well-known/oauth-authorization-server",
      "pkce": "S256",
      "dynamicClientRegistration": true,
      "scopes": [
        "chats:read",
        "media:read",
        "chats:send"
      ]
    },
    "bearer": {
      "header": "Authorization",
      "tokenPrefix": "circ_",
      "note": "A token the person creates on the Agents page in Circles, for clients that take a config file."
    }
  },
  "capabilities": {
    "tools": {}
  },
  "tools": {
    "discovery": "runtime",
    "note": "Listed per caller with tools/list: send appears only with the chats:send scope and a chat open for sending, get_media only with media:read.",
    "names": [
      "allowed_chats",
      "activity",
      "people",
      "catch_up",
      "search",
      "documents",
      "group_members",
      "get_media",
      "send"
    ]
  },
  "pricing": {
    "model": "subscription",
    "plans": [
      {
        "name": "Free",
        "price": "0",
        "currency": "USD",
        "period": "month"
      },
      {
        "name": "Starter",
        "price": "9.90",
        "currency": "USD",
        "period": "month"
      },
      {
        "name": "Pro",
        "price": "29",
        "currency": "USD",
        "period": "month"
      },
      {
        "name": "Free",
        "price": "0",
        "currency": "ILS",
        "period": "month",
        "region": "IL"
      },
      {
        "name": "Starter",
        "price": "29",
        "currency": "ILS",
        "period": "month",
        "region": "IL"
      },
      {
        "name": "Pro",
        "price": "99",
        "currency": "ILS",
        "period": "month",
        "region": "IL"
      }
    ],
    "freeTrialDays": 14,
    "url": "https://usecircles.app/en/pricing",
    "regional": [
      {
        "countries": [
          "CO"
        ],
        "currency": "COP",
        "starter": "24900",
        "pro": "59900",
        "period": "month"
      },
      {
        "countries": [
          "BR"
        ],
        "currency": "BRL",
        "starter": "49.90",
        "pro": "99.90",
        "period": "month"
      },
      {
        "countries": [
          "ES"
        ],
        "currency": "EUR",
        "starter": "8.90",
        "pro": "19.90",
        "period": "month"
      },
      {
        "countries": [
          "MX"
        ],
        "currency": "MXN",
        "starter": "149",
        "pro": "349",
        "period": "month"
      },
      {
        "countries": [
          "CL"
        ],
        "currency": "CLP",
        "starter": "7990",
        "pro": "17990",
        "period": "month"
      },
      {
        "countries": [
          "PE"
        ],
        "currency": "PEN",
        "starter": "24.90",
        "pro": "59.90",
        "period": "month"
      },
      {
        "countries": [
          "AR",
          "EC"
        ],
        "currency": "USD",
        "starter": "7.90",
        "pro": "17.90",
        "period": "month"
      },
      {
        "countries": [
          "UY",
          "CR",
          "PA"
        ],
        "currency": "USD",
        "starter": "8.90",
        "pro": "19.90",
        "period": "month"
      }
    ],
    "regionNote": "Starter and Pro are charged in the billing country the person chooses when they pay; the site's language never decides it. Countries not listed pay the USD prices, Israel the ILS ones. A subscription keeps the price it started on."
  },
  "links": {
    "skill": "https://usecircles.app/SKILL.md",
    "llms": "https://usecircles.app/llms.txt",
    "openapi": "https://app.usecircles.app/api/openapi.json",
    "security": "https://usecircles.app/en/security",
    "privacy": "https://app.usecircles.app/privacy",
    "terms": "https://app.usecircles.app/terms",
    "guides": {
      "en": "https://usecircles.app/en/for-agents",
      "he": "https://usecircles.app/for-agents",
      "pt-BR": "https://usecircles.app/pt-br/for-agents",
      "es": "https://usecircles.app/es/for-agents"
    }
  },
  "icons": [
    {
      "src": "https://usecircles.app/brand/favicon.svg",
      "mimeType": "image/svg+xml",
      "sizes": [
        "any"
      ]
    },
    {
      "src": "https://usecircles.app/brand/apple-touch-icon.png",
      "mimeType": "image/png",
      "sizes": [
        "180x180"
      ]
    }
  ],
  "provider": {
    "name": "3Peaks Dev, Inc.",
    "url": "https://usecircles.app",
    "email": "mayanc@3peaks.dev"
  },
  "updated": "2026-10-27",
  "languages": [
    "en",
    "he",
    "pt-BR",
    "es"
  ]
}