Circle.so MCP. Manage community data from your chat window.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Circle.so MCP Server connects your AI agent directly to your online community. Use this to manage members, review posts, and check event details without opening the Circle dashboard.
Your agent can list all community spaces, track recent discussions, and pull member profiles via natural conversation.
What your AI agents can do
Get my circle profile
Retrieves the profile data for the authenticated admin user.
List community events
Lists all events, including upcoming and past dates.
List community members
Retrieves a comprehensive list of all community members.
Retrieves the specific profile information for the authenticated administrator user.
Pulls a list of both upcoming and past events hosted in the community.
Retrieves a list of every member currently enrolled in the community.
Pulls a list of the latest content posts made across the community.
Retrieves all the main spaces (sub-communities) that make up the larger community.
Retrieves the organizational groups that structure the various community spaces.
Fetches all comments made specifically on a single, identified post.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Circle.so MCP Server: 8 Tools for Community Management
These tools let your AI agent read and structure core data from your Circle.so community, covering members, posts, spaces, and events.
019d756fget my circle profile
Retrieves the profile data for the authenticated admin user.
019d756flist community events
Lists all events, including upcoming and past dates.
019d756flist community members
Retrieves a comprehensive list of all community members.
019d756flist community posts
Lists the most recent general posts made by community members.
019d756flist community spaces
Retrieves all major sub-communities or spaces within Circle.
019d756flist community topics
Lists the main discussion topics currently active in the community.
019d756flist post comments
Fetches all comments that belong to a specific community post.
019d756flist space groups
Lists the organizational groups that structure the community spaces.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Circle.so, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Your AI agent connects straight to your Circle.so community. You'll manage everything—members, posts, and events—without ever opening the Circle dashboard. Your agent can list every space, track recent discussions, and pull member profiles just by talking to it.
Get Admin Profile Info
Retrieves the profile data for the authenticated admin user.
List Community Events
Pulls a list of every event, both upcoming and past, hosted in the community.
List All Community Members
Grabs a list of every single member in the community.
List Recent Posts
Pulls the latest content posts made across the community.
List Community Spaces
Retrieves all the main sub-communities, or spaces, that make up the bigger community.
List Discussion Groups
Lists the organizational groups that structure the various community spaces.
List Comments on a Post
Fetches all comments made specifically on one post.
How Circle.so MCP Works
- 1 Subscribe to the Circle.so MCP Server on Vinkius and get your Circle API Token.
- 2 Input the API Token into your AI client (Claude, Cursor, etc.).
- 3 Tell your agent what you need—for example, 'Show me the last 5 posts in the General Discussion space.'—and it executes the necessary tools.
The bottom line is, your AI client uses the provided tools to talk to Circle.so, bringing community data into your chat window.
Who Is Circle.so MCP For?
This is for Community Managers and Membership Owners who spend too much time clicking through dashboards just to get status updates. If you need to audit member activity, check event schedules, or track discussion trends without logging into Circle, this saves hours of manual clicking.
Uses the agent to track member engagement and review recent posts using natural language prompts, instead of browsing the content feed.
Audits student profiles and space activity by calling list_community_members and list_community_spaces, bypassing the need to open the full dashboard.
Quickly looks up member details and discussion history by using the agent to call get_my_circle_profile or list_post_comments directly from their chat interface.
What Changes When You Connect
- See who's active: Call
list_community_membersto get a full roster of your community without navigating to the member tab. You get the data instantly. - Track discussions: Use
list_community_poststo get the latest community activity feed directly in your agent chat. No more refreshing the dashboard. - Check event status: Run
list_community_eventsto quickly verify upcoming event dates and details. Great for event coordinators who need quick access. - Audit content: Call
list_community_spacesandlist_space_groupsto map out your entire community structure. This is faster than manually clicking through the dashboard hierarchy. - Deep dive into posts: Use
list_post_commentsto get all comments for a specific post. This lets you analyze discussion sentiment without leaving the chat. - Get admin context:
get_my_circle_profileretrieves your own admin data, confirming your role and basic metadata within the agent.
Real-World Use Cases
The Membership Owner Needs a Roster Check
A membership owner needs to see if a specific user is in the community and check their last few posts. Instead of going to the member directory, they prompt their agent: 'List all community members and show me the 3 most recent posts for Jane Doe.' The agent uses list_community_members and list_community_posts to deliver the data instantly.
Course Creator Needs a Space Audit
A course creator needs to know which spaces exist and what groups structure them. They ask the agent to run list_community_spaces and then list_space_groups. The agent returns the full organizational map, letting them know if they need to create new sections without opening the backend.
Event Coordinator Needs a Quick Calendar Check
The event coordinator needs to confirm the dates for next month's workshops. They prompt the agent to run list_community_events. The agent returns a clean list of upcoming and past events, letting them share the schedule right away.
Moderator Needs to Review a Thread
A moderator spots a suspicious post and needs to see the conversation history. They ask the agent to use list_community_posts to get the post ID, and then immediately use list_post_comments to pull the full discussion thread. This saves copy-pasting dozens of comments.
The Tradeoffs
Manual Dashboard Browsing
Opening Circle.so, navigating to 'Members,' scrolling, copying names, then opening 'Content,' scrolling, and cross-referencing post dates to build a report.
→
Use the agent. Prompt it to 'List all community members and show me the last 10 posts.' The agent calls list_community_members and list_community_posts and gives you a single, combined result set.
Guessing the API Path
Trying to figure out if member data lives in the 'Users' endpoint or the 'Profile' endpoint, wasting time reading documentation and making guesses.
→
Just ask the agent. It handles the calls. Ask it to 'Get my profile details.' The agent uses get_my_circle_profile and you get the correct data, every time.
Sequential Data Pulling
Calling list_community_spaces first, and then having to write a separate script to call list_space_groups for every single space ID returned in the first call.
→
Tell the agent what you need: 'Show me the groups within the main Discussion space.' The agent handles the sequence, calling list_community_spaces then list_space_groups automatically.
When It Fits, When It Doesn't
Use this if your workflow requires you to pull multiple, related data points from Circle.so—like posts, comments, and member lists—into a single chat conversation. It's best for auditing, reporting, or quick data checks. Don't use it if you only need to know how to write a new post or if you need to update member details (this server only reads data). If you need to build a dedicated front-end dashboard that requires complex, real-time state management, you might still need to build that yourself, but for data retrieval, this is the fastest way to get answers.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Circle.so. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 8 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Getting a full picture of your community used to mean opening five different tabs.
Today, if you want to know who's active, what topics they're discussing, and what events are coming up, you open the Circle dashboard. You click the Members tab, then the Posts tab, then the Events calendar, and maybe the Spaces directory. You spend twenty minutes just gathering the raw data, then you copy and paste it into a spreadsheet to make sense of it.
Now, you just talk to your agent. You ask, 'What's the activity and the plan for the next month?' The agent calls `list_community_members`, `list_community_posts`, and `list_community_events` in sequence. It spits out a clean summary, so you get the data you need in one go.
list_community_spaces: Map your entire community structure in seconds.
Before, understanding your community's hierarchy meant clicking 'View Spaces' and then clicking into every single sub-community to see which groups were active. It was slow, tedious, and you often missed the deeper connections.
Now, you ask the agent to run `list_community_spaces` and `list_space_groups`. It immediately provides the full map of your content organization. You see the structure and know exactly where everything lives, fast.
Common Questions About Circle.so MCP
Can I use list_community_posts to see posts from only one specific space? +
The agent handles this filtering. You just tell it, 'Show me the last 10 posts in the Announcements space.' The agent uses list_community_posts but scopes the query to the correct space.
How do I get a list of all users with the get_my_circle_profile tool? +
You don't. get_my_circle_profile only retrieves the data for the admin who is authenticated. To get all users, you must use the list_community_members tool instead.
What is the difference between list_community_spaces and list_space_groups? +
Spaces are the main containers for discussions. Groups are the organizational units that structure those spaces. The agent uses list_community_spaces to show the major areas, and list_space_groups to show how those areas are segmented.
Can I check upcoming events using list_community_events? +
Yes. You can ask the agent to list upcoming and past events with one prompt. This tool pulls all relevant metadata into a single list for you to review.
How do I use list_community_members to check a member's discussion history? +
The list_community_members tool provides basic profile data. To see a member's discussion history, you must first use list_community_posts, then provide the post ID to list_post_comments.
What information does get_my_circle_profile provide? +
get_my_circle_profile returns the authenticated admin user's profile details. This includes core metadata and the user's current admin status within the community.
Are there any limits when I use list_community_topics? +
Yes, the tool has default rate limits set by Circle. You might need to handle pagination or use a dedicated script if you are retrieving more than 100 topics.
Does list_space_groups help me organize my community structure? +
list_space_groups lists the containers that organize spaces. This helps you understand the hierarchy of sub-communities before you run list_community_spaces.
Can I see who the most recent members to join are? +
Yes! Use the list_community_members tool. The agent will return a list of members, and you can see their join dates and profile details directly.
How do I see the comments for a specific post? +
Use the list_post_comments tool with the unique post ID. Your agent will fetch all comments, allowing you to review the discussion without leaving your chat.
Where do I find my Circle API Token? +
Log in to your Circle community as an admin, go to Settings, and select API. You can generate and copy your token from that section.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Learn Amp
Combine learning, engagement, and performance in one people development platform that helps employees grow and organizations thrive.
HotDocs
Automate document assembly via HotDocs Advance — list templates, create work items, conduct interviews, and generate documents directly from any AI agent.
EasySendy
Send high-volume email campaigns through multiple delivery servers with list hygiene tools that protect your sender score.
You might also like
Etherscan
Query Ethereum and EVM-compatible blockchain data—check balances, transaction history, and token transfers directly from your AI agent.
EBI PDBe
Explore 3D protein structures, ligand interactions, and molecular assemblies from the Protein Data Bank in Europe.
DoorDash Drive
Equip your AI agent to manage deliveries, track dashers, and monitor order status via the DoorDash Drive API.