Circle
Connect Circle to run your community: find members, post to spaces, manage events, courses and tags, and review subscriptions.
You paste one value into PopMCP: an Admin V2 token from Settings, Developers, Tokens in Circle. One token belongs to one community, so there is nothing to choose afterwards. Two more tokens are optional, for acting as a member and for the Data API.
Paid plan required before this connector works
No one reviews you, but Circle's APIs start at the Business plan. The Professional plan does not include them, and Circle answers 403 until the community's plan does.
- Typical wait
- None. A token works as soon as the community is on the Business plan and you create it.
- Cost
- From Circle's pricing page: Business is $199/month and Scale is $419/month. Business includes 5,000 Admin API requests a month and Scale 30,000, and extra requests cost $.005 each on Business and $.002 on Scale. The optional member tools are measured by monthly active members: 100 on Business, then $0.50 each. The Data API is a paid add-on arranged with Circle's sales team.
- Blocked until approved
- Everything through the API. Your community itself keeps working on any plan.
- Works meanwhile
- Nothing through the API. You can read Circle's docs and plan what you want the AI to do.
Where to apply: No form. Move the community to Business or higher in Circle, then create an Admin V2 token under Settings, Developers, Tokens.
- Every call counts toward the monthly requests, including ones Circle refuses, except a wrong token (401) and its own errors (5xx).
- Going past the monthly allowance is billed, not refused. Watch usage under Settings, Developers.
- A wrong type of token answers the same 401 as a bad one: it has to be Admin V2.
- Setup time
- 2 min
- Auth
- API credentials
- API base URL
- https://app.circle.so/api/admin/v2
Before you begin
- A Circle community on the Business plan or higher: the Professional plan does not include Circle's APIs
- Admin access to the community, since only admins can create tokens
- Nothing to apply for: the token works straight away
- This is Circle the community platform at circle.so, not Circle the payments company
Get your credentials
Open Developers in your community's settings
Sign in to your Circle community as an admin. Go to Settings, then Developers, then Tokens. The address depends on your community, so go through the menu.
Tokens
Create an Admin V2 token
Create a new token and set its type to Admin V2. The type matters: Admin V1 and Headless Auth tokens look the same but do not work on this API. Copy the token, and keep it private, because it can read and change everything in your community.
New token
Connect in PopMCP
Paste the token into PopMCP's Circle form and click Connect. PopMCP reads your community's details once to check it, and labels the connection with your community's name.
Check it is connected
The Circle card in PopMCP reads Connected, with your community's name. New connections start read-only, so posting, inviting members and sending messages wait until an owner or admin allows write actions in PopMCP.
Circle
- Status
- Connected
- Account
- Acme Community
- Access
- Read only
Optional: add the member and data tools
Most people can stop here. Under More options on the form you can add two things. A Headless Auth token with one member's email adds tools that act as that member: their notifications, bookmarks, chats and likes. Each member who uses them counts toward Circle's monthly active member allowance. A Data API token adds your community's event history, and the Data API is a paid add-on you arrange with Circle.
Connect in PopMCP
Open your workspace, choose Circle in the marketplace, and fill in the connect dialog:
| Field | What to enter |
|---|---|
| Admin V2 tokensecret | In Circle: Settings, Developers, Tokens, then create one with the type Admin V2. Stored encrypted.Encrypted with AES-256-GCM on save and never shown again. |
| Headless Auth tokensecret | Adds tools that act as one member: their notifications, bookmarks, chats and likes. A token with the type Headless Auth, from the same page.Encrypted with AES-256-GCM on save and never shown again. |
| Member to act astext | The email of the one member those tools act as. Needed with a Headless Auth token. |
| Data API tokensecret | Adds tools that read your community's event history. The Data API is a paid add-on from Circle.Encrypted with AES-256-GCM on save and never shown again. |
PopMCP verifies the credential against Circle immediately. On success the connection flips to Verified and its MCP tools are provisioned.
Verify it worked
PopMCP shows the Circle connector as Connected, labelled with your community's name, after one read of your community's details.
Troubleshooting
Circle did not accept this token
Why: The token's type is Admin V1 or Headless Auth, it was copied only in part, or it was deleted.
Fix: Under Settings, Developers, Tokens, create a token with the type Admin V2, and paste that in full.
Circle says this community's plan does not include the Admin API
Why: The community is on the Professional plan. Circle answers 403 until the plan includes its APIs.
Fix: Move to the Business plan or higher in Circle, then connect again.
Circle found no member with that email
Why: The email under More options is not a member of this community.
Fix: Use the email that member signs in with, or leave both member fields empty.
The Headless Auth token belongs to a different community
Why: The two tokens came from two communities.
Fix: Create both under Settings, Developers, Tokens in the same community.
A tool answers that it needs a Headless Auth or Data API token
Why: It is a member or data tool, and those tokens are optional.
Fix: Reconnect Circle and add the token under More options. Most member actions also have an admin tool that needs nothing extra.
Circle is limiting requests
Why: Circle allows 2000 requests per 5 minutes from one address, and PopMCP also keeps each connection to a fair share of that.
Fix: Wait a few minutes and try again, and ask for fewer things at once.
Your request count is higher than expected
Why: Every call counts toward your plan's monthly requests, including ones Circle refuses, and requests past the allowance are billed. It takes about five minutes to show.
Fix: Watch usage under Settings, Developers. Keep write actions off and ask for what you need with a filter rather than whole lists.
A post could not be created in a space
Why: Basic posts go only in discussion spaces. Event, course, chat and image spaces take their own kinds of content.
Fix: Pick a discussion space, or ask for an event, a lesson or an image post instead.