# Circle.so MCP for AI Agents AI Agent Connect

> Circle.so MCP lets you manage your online community directly from your AI agent. You can pull member data, check recent posts, and look at upcoming events without leaving your chat interface. It turns your community dashboard into a conversational workspace for faster moderation and member support.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_WPG0eviavio8QhUeOjpyNpuD4FMu1mWJ9XgVqjGj/ai-agent-connect
- **Tags:** community-management, online-courses, member-engagement, discussion-forums, creator-economy, space-management

## Description

Managing a community often feels like jumping between tabs to see who's active, what's being said in different spaces, and when the next event is happening. This Connector changes that by letting your agent do the heavy lifting. You can ask about specific member details or get a summary of recent discussions without ever opening the Circle dashboard. It's about having a bird's-eye view of your community's health and engagement while staying in your primary workspace. If you're looking to scale your community management, finding this Connector in the Vinkius catalog is the fastest way to get your agent connected. You can quickly grab metadata for your spaces, check out what people are talking about in specific topics, and keep your event schedule organized. It makes the admin side of community building feel like a conversation rather than a chore.

## Tools

### list_community_topics
List all discussion topics. This helps you see the breadth of conversations happening in your community.

### get_my_circle_profile
Retrieve your own admin profile details. Use this to quickly check your own permissions or account info.

### list_post_comments
List all comments on a specific post. This is great for gauging sentiment on a particular thread.

### list_community_events
List upcoming and past community events. You'll always know what's coming up next on your calendar.

### list_community_members
List all members in the community. This makes it easy to see your total reach at a glance.

### list_community_posts
List recent posts in the community. Use this to stay on top of the most recent activity from your members.

### list_space_groups
List groups that organize spaces. This helps you understand your community's architecture and hierarchy.

### list_community_spaces
List every sub-community and space in your Circle. You'll know exactly how your community is organized.

## Prompt Examples

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

**Response:** 
```
Retrieving recent posts from General Discussion...

| Post Title | Author | Comments |
| :--- | :--- | :--- |
| **Welcome to the community!** | Jane Smith | 12 |
| **First Day Tips** | Mike Ross | 4 |
| **Help with Module 1** | Sarah Lee | 8 |
| **Intro Thread** | Alex Chen | 2 |
| **Question about Dates** | John Doe | 1 |

The most popular post is 'Welcome to the community!' with 12 comments.
```

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

**Response:** 
```
Checking the event calendar... You have 2 upcoming events:

*   **Weekly Office Hours**
    *   Date: Tomorrow at 2 PM
    *   Description: Live Q&A for all members.
*   **Monthly Guest Speaker**
    *   Date: Next Friday at 10 AM
    *   Description: Special guest talk on community growth.
```

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

**Response:** 
```
I found 8 spaces in your community:

1.  **Announcements**
2.  **General Discussion**
3.  **Course Module 1**
4.  **Course Module 2**
5.  **Q&A**
6.  **Resource Library**
7.  **Member Lounge**
8.  **Beta Testers**
```

## Capabilities

### Pull member profile data
Get detailed information about any community member directly in your chat.

### List all community spaces
See all the sub-communities and organized areas within your Circle.

### Track recent community posts
Monitor the latest activity and discussions happening in your community.

### View upcoming and past events
Check your community calendar to see what's happening now or what's coming up.

### Monitor discussion topics
See the breadth of conversations to understand what your members care about.

### Get admin profile details
Retrieve your own admin account information and metadata instantly.

### List comments on specific posts
See the feedback and engagement on a particular community thread.

### See space groups
Understand how your various spaces are grouped and organized.

## Use Cases

### Checking member activity in a specific space
A manager needs to know who's active in a group. They ask the agent to list members in a space to see who's participating.

### Auditing engagement on a new announcement
A creator wants to see if a new course post is getting traction. They ask the agent to pull comments on the latest announcement.

### Verifying the upcoming community schedule
An admin needs to check the upcoming schedule. They ask the agent to show the full list of community events.

### Identifying high-traffic discussion areas
A moderator wants to see what people are talking about. They ask the agent to pull the latest discussion topics.

## Benefits

- Faster member lookups: Get member profiles instantly without navigating through multiple menus.
- Real-time content monitoring: Keep an eye on discussions by pulling recent posts and comments.
- Organized space oversight: See your entire community structure and group organization at a glance.
- Better event tracking: Pull your full schedule of past and future events to keep your calendar updated.
- Topic analysis: See what your members are actually interested in by pulling discussion topics.
- Quick admin checks: Grab your own account details to verify your status or permissions quickly.

## How It Works

The bottom line is you get a conversational interface for your entire Circle.so community.

1. Get your Circle API token from the Settings menu in your dashboard.
2. Enter the token into your Connector client to establish the connection.
3. Ask your agent to pull member lists, check recent posts, or view events.

## Frequently Asked Questions

**How does Circle.so MCP help with community management?**
It lets you ask your agent to pull member lists, check recent posts, and see events directly in your chat. This means you can stay updated on community activity without having to constantly switch back to the Circle dashboard.

**Can I use Circle.so MCP to see recent posts?**
Yes, the Connector can pull recent posts and comments for you. You can ask your agent to show you what's happening in specific spaces or give you a summary of the latest discussions.

**Is Circle.so MCP good for course creators?**
It's a great tool for course creators who need to audit student activity. You can quickly check member profiles and see which spaces are most active to understand where your students are spending their time.

**How do I see my community events with Circle.so MCP?**
Your agent can pull a full list of all past and upcoming events. This helps you keep your schedule organized and quickly verify dates and descriptions during conversations.

**Can Circle.so MCP find member profiles?**
Yes, it can list all members in your community and retrieve their profile details. This is perfect for quickly looking up information when helping a member in your chat.

**Does Circle.so MCP show me my admin profile?**
Yes, it can pull your own admin profile metadata. This allows you to quickly check your own account status or permissions without navigating through your settings menu.

**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.