Mcp Circle

List spaces in the Circle community. Returns paginated results with space details including name, type, URL, and settings. Use page/per_page for pagination and sort for ordering.

Retrieve a single Circle space by its numeric ID. Returns full space details including name, type, URL, visibility settings, and configuration. Use circle_list_spaces to discover space IDs.

List posts in the Circle community. Returns paginated results with full post details including title, content (HTML and TipTap), author info, and engagement metrics (likes_count, comments_count). Filter by space_id, space_group_id, status (draft/published/scheduled), or search...

Retrieve a single Circle post by its numeric ID. Returns full post details including title, HTML body, structured TipTap body, author info, and engagement metrics. Use circle_list_posts to discover post IDs.

List community members in Circle. Returns paginated results with member details including name, email, profile URL, activity stats, and profile fields. Filter by status to include inactive members (default returns active only, use "all" for everyone).

Search across the Circle community. Returns lightweight summary objects with id, name, slug, and type. Results are NOT full resource objects — use circle_get_space, circle_get_post, or circle_get_comment for full details on individual results. Filter by type (posts, members, c...

List comments in the Circle community. Filter by post_id to get comments on a specific post, or by space_id to get comments across all posts in a space. Returns paginated results with comment text, author info, and engagement metrics.

Retrieve a single Circle comment by its numeric ID. Returns full comment details including body text, author info, and engagement metrics. Use circle_list_comments to discover comment IDs.

List all topics (tags/categories) in the Circle community. Topics are used to categorize posts. Returns paginated results with topic name, slug, and post count.

Retrieve community-level metadata for the connected Circle community. Returns the community name, URL, slug, branding info, locale, and settings. No parameters required — uses the configured API token to identify the community.

No parameter schema in public metadata yet.

List space groups in the Circle community. Space groups organize spaces into navigational categories (e.g., 'Getting Started', 'Resources'). Returns paginated results with group name, position, and the IDs of spaces within each group.

Detect posts with zero comments — potential unanswered questions or unengaged content. Fetches published posts from the Circle API and filters client-side to those with comments_count === 0. Optionally limit to a specific space. All numbers come directly from the Circle API —...

Generate a community health snapshot by aggregating data from multiple Circle API endpoints. Fetches community info, space count, post count, and member count in parallel, then assembles a summary. All numbers come directly from Circle API pagination metadata — no opaque score...

No parameter schema in public metadata yet.

Create a new post in a Circle space. Requires space_id (use circle_list_spaces to find IDs), a title (name), and HTML body content. Posts default to 'published' status. Set status to 'draft' to save without publishing. Use skip_notifications: true for test or bulk content. Ret...

Update an existing Circle post. Requires post_id (use circle_list_posts or circle_get_post to find IDs). Only provided fields are updated — omitted fields remain unchanged. Note: Published posts CANNOT be reverted to draft status; attempting to set status='draft' on a publishe...

Create a comment on a Circle post. Requires post_id (use circle_list_posts or circle_get_post to find IDs) and HTML body content. Note: The Circle Admin API may restrict comment creation depending on your API token permissions. If you receive a permission error, create comment...