# Circle.so MCP

> Circle.so MCP gives your AI client full control over online community management. Monitor member activity, track discussions across all spaces, and manage events without ever leaving your chat window. It handles listing members, tracking posts, and checking event schedules for you.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** community-management, online-courses, member-engagement, discussion-forums, creator-economy, space-management

## Description

Managing a large online community shouldn't require juggling multiple dashboards. This MCP connects your favorite AI client directly to Circle.so’s core data, letting you handle complex administrative tasks through natural conversation. You can ask questions like, 'Who posted about the Q4 strategy this week?' or 'What are the next three events?' and get an immediate answer, without clicking a single link.

It lets your agent retrieve lists of all community members and their profiles, monitor discussions by pulling recent posts and comments across specific spaces. You can also check out upcoming event schedules or audit group structures to see how content is organized. If you use Vinkius for other connectors, this MCP gives you a single point of control over your entire digital workspace. It turns tedious data retrieval into simple conversation.

## Tools

### list_community_posts
Pulls a list of recent posts across your community for quick review.

### list_space_groups
Retrieves the organizational groups that manage various spaces within the community.

### list_community_spaces
Lists every distinct space (sub-community) available in your Circle account.

### list_community_topics
Shows a list of current discussion topics being covered by members.

### get_my_circle_profile
Retrieves specific details and metadata about the administrative user account linked to this MCP.

### list_post_comments
Grabs all comments associated with a specific community post for sentiment analysis or review.

### list_community_events
Gets comprehensive details on both past and upcoming events hosted by the community.

### list_community_members
Generates a complete roster of all members registered in your online community.

## Prompt Examples

**Prompt:** 
```
List all spaces in my Circle community.
```

**Response:** 
```
Retrieving your community spaces... I found 8 spaces including 'Announcements', 'General Discussion', 'Course Module 1', and 'Q&A'. Which one would you like to see posts for?
```

**Prompt:** 
```
Show me the last 5 posts in the 'General Discussion' space.
```

**Response:** 
```
Retrieving recent posts from General Discussion... I found 5 items. The most popular one is 'Welcome to the community!' by Jane Smith with 12 comments.
```

**Prompt:** 
```
What are the upcoming community events?
```

**Response:** 
```
Checking the event calendar... You have 2 upcoming events: 'Weekly Office Hours' (Tomorrow at 2 PM) and 'Monthly Guest Speaker' (Next Friday at 10 AM).
```

## Capabilities

### Audit Community Membership
Get full lists of all users and their profile details to track engagement.

### Track Discussion Activity
Pull recent posts, comments, and discussion topics across your community for monitoring trends.

### Map Community Structure
View all organized spaces and the groups that manage them to understand how content is siloed.

### Monitor Events
Retrieve detailed information about both upcoming and past community events.

### Review Admin Data
Pull core metadata, including your own administrator profile details.

## Use Cases

### Identifying a Content Gap
A course creator needs to know if students are discussing Module 3 or if the conversation has moved entirely to Module 4. Instead of checking five different spaces, they ask their agent to check `list_community_topics` and then run `list_community_posts` for the relevant areas.

### Pre-Event Prep
An event coordinator needs attendee numbers and a schedule review. They use their agent to call `list_community_events`, confirming dates, and then run `list_community_members` to cross-reference the registered participants.

### Auditing User Profiles
A membership owner needs to verify a user's history. They use their agent to call `list_community_members` and then ask for specific details about that member, getting all profile data in one query.

### Monitoring Viral Discussions
A community manager wants to know if a recent announcement got traction. They run `list_community_posts`, find the post ID, and then use `list_post_comments` to gauge the overall sentiment from dozens of replies.

## Benefits

- You can instantly get a full roster of users using `list_community_members`. Stop spending time clicking through member lists just to check names or join dates.
- Track discussions across the board by listing community posts with `list_community_posts`. You see what's trending in minutes, not hours.
- Understand your whole content structure when you call `list_community_spaces` and `list_space_groups`. It shows you exactly how content is organized without needing to browse every folder.
- Never miss a meeting or deadline. Use `list_community_events` to get immediate details on upcoming events, including dates and times.
- Deep dive into engagement by listing comments for specific posts using `list_post_comments`. This lets you see the full conversation flow attached to one item.
- Get an overview of all discussion points by calling `list_community_topics`, letting you quickly grasp what your community is focused on right now.

## How It Works

The bottom line is that you talk to your AI client like talking to an admin assistant; it talks to Circle.so's API for you.

1. Subscribe to this MCP and provide your Circle API Token. You must obtain this token from the platform's settings.
2. Connect your AI client (like Cursor or Claude) using the Vinkius integration. This authorizes access to your community data.
3. Tell your agent what you need—for example, 'List all members who haven't posted in a month.' The agent executes the necessary tool calls and delivers the results.

## Frequently Asked Questions

**How do I list all members using the Circle.so MCP?**
You use the `list_community_members` tool. This function pulls a complete roster of every user in your community, letting you quickly audit who's active and who isn't.

**Can I see all my spaces with Circle.so MCP?**
Yes. The `list_community_spaces` tool gives you a clear list of every distinct sub-community space in your account, helping you understand your content organization.

**What does the `list_post_comments` tool do?**
This function retrieves all comments associated with one specific post. It's perfect for gauging sentiment or understanding the full conversation thread surrounding a key topic.

**Can I find out about future events using Circle.so MCP?**
Absolutely. Call `list_community_events`. This tool provides details on both scheduled upcoming meetings and records of past community gatherings.

**Is the data from `get_my_circle_profile` only about me?**
It retrieves core metadata and profile information specifically for the administrative user account linked to your API token. This confirms your permissions within Circle.