Circle MCP Server
Provides tools for interacting with the Circle community platform via its Admin API V2, enabling management of community members, spaces, posts, comments, events, courses, access groups, messages, forms, paywalls, and workflows. It exposes read operations and confirmed write operations for administering a Circle community.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Circle MCP Server show me my community's spaces and the latest posts in each one"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Circle MCP Server & CLI
Circle MCP server and CLI for Claude Code, Codex and AI agents. 170 tools: 66 reads and 104 confirmed writes for community members, spaces, posts, comments, events, courses, access groups, messages, forms, paywalls and workflows.
One package gives you two ways in: circle-mcp connects the tools to your AI app, and circle-cli makes the same tools shell commands. Claude Desktop also has a bundled .mcpb extension.
Built and maintained by Navid Moazzez. Built on Slipway, which turns one definition of each tool into the MCP server and the CLI. Complete installation and private account setup are in INSTALL.md.
The terminal illustrates shipped tools and the draft workflow. It is a presentation preview, not a verified live account operation.
You need a private Circle Admin V2 API token and eligible Admin API access. Community permissions and plan limits apply. The community wrapper preserves AGPL-3.0-or-later licensing; Circle service charges remain separate. This is not a Circle-endorsed product.
Circle already has an official hosted MCP with broad Admin API coverage and community MCP alternatives. No dedicated task CLI was identified in the official pages reviewed. The comparison below records the evidence; this package makes no unsupported claim of broader coverage or measured efficiency.
Two ways to use it
Command line
npm install -g @thenavidm/circle-mcp-cli@latest
circle-cli
circle-cli list-spaces --help
circle-cli schema create-post
circle-cli list-spaces --per-page 5 --agentConfigure credentials privately first. Every write needs --confirm; --agent and --yes never authorize changes.
MCP server, for your AI app
claude mcp add --scope user circle -- npx -y @thenavidm/circle-mcp-cli@latestThen ask: Show this community's spaces and the latest posts in the space I choose. Full client/OS wiring is in INSTALL.md.
Which one
Where you work | Surface |
Claude Code, Codex, Cursor or another shell agent | MCP, CLI or both |
Claude Desktop chat | Local MCP or desktop bundle |
Scripts/CI | CLI or an MCP client |
Remote-URL-only web clients | Official hosted Circle MCP |
Related MCP server: Discord MCP - Discord server management MCP for AI agents
Features
Capability | CLI | MCP |
Community and spaces | circle-cli get-community / list-spaces | get_community / list_spaces |
Members | circle-cli list-members / search-member | list_members / search_member |
Draft posts | circle-cli create-post / get-post | create_post / get_post |
Courses and events | circle-cli list-course-lessons / list-events | list_course_lessons / list_events |
Workflow reads | circle-cli list-workflows | list_workflows |
Access groups | circle-cli list-access-groups | list_access_groups |
Private account labels | circle-cli list-accounts | list_accounts |
Diagnosis | circle-cli doctor | CLI utility |
Contents
Number | Section | Covers |
1 | Prompts and coverage | |
2 | MCP, CLI and desktop | |
3 | Tokens, plans and auth discrepancy | |
4 | Clients and OS routes | |
5 | Doctor and first read | |
6 | Inputs, JSON and scripting | |
7 | Actual usage measurement | |
8 | All tools and arguments | |
9 | Drafts, members, events and messages | |
10 | Pages, quota and direct uploads | |
11 | Named credentials | |
12 | Confirmation and logs | |
13 | Shared source and maintenance | |
14 | Hosts and private data | |
15 | Credential/safety/tuning settings | |
16 | Updating and revoking | |
17 | Symptoms and remedies | |
18 | Official and community alternatives | |
19 | Version history and migration | |
20 | Accordion questions |
1. What you can ask it
Show this community's spaces and member directory.
Find an existing member before changing their access.
Read the latest posts and identify unanswered questions.
Draft the community post I requested, leaving it unpublished.
Inspect course sections, lessons, events and form submissions.
Read an existing workflow before the activation I requested.
The pinned Admin API v2 snapshot contains 169 operations. With the private account helper, this package exposes 170 tools: 66 reads and 104 confirmed writes. It covers members, access groups, community settings, basic/image posts, comments, events, courses, tags, forms, search, transcripts, messages, paywalls and workflows.
Circle already has an official hosted MCP. It is a useful OAuth connection with broad Admin API coverage. This implementation offers a local shared task CLI, named private tokens, predictable JSON and explicit bounded page retrieval. Tool counts do not establish broader coverage or efficiency. Live account outcomes and desktop GUI installation remain unverified.
2. Quick install
npm install -g @thenavidm/circle-mcp-cli@latest
circle-cli --version
circle-cli login
circle-cli doctor
circle-cli toolsNode 22 or newer is required for manual MCP and CLI installation. Set the API token privately before a network request. The release supplies a circle-2.0.0.mcpb archive for a compatible Claude Desktop host. It bundles production dependencies, no account credentials. See INSTALL.md for client and OS configuration.
For Claude Code, after private configuration:
claude mcp add --scope user circle -- npx -y @thenavidm/circle-mcp-cli@latest
claude mcp list3. Set up Circle access
Obtain an Admin V2 token
Sign in to the intended Circle community as an admin.
Open Settings > Developers > Tokens.
Create a token with type Admin V2 on an eligible plan.
Store it only in private shell/client settings as
CIRCLE_API_TOKEN, or use the private file route below.Run
circle-cli doctor, thencircle-cli doctor --networkfor a community read.
Follow the current quick start. Never use a Circle password, browser cookies, a member access token or a Google OAuth client as a substitute. The Admin API is intended for administrative integrations; member-facing experiences use the separate Headless APIs. The local package does not perform OAuth or host an authorization callback. login prints instructions without opening a browser or saving credentials.
Authentication discrepancy
The pinned OpenAPI security scheme specifies Authorization: Token AUTH_TOKEN; the quick-start prose and examples use Bearer. This version defaults to Token, preserving the schema and existing implementation. Explicitly set CIRCLE_AUTH_SCHEME=Bearer if your account requires the prose's scheme. Named accounts accept auth_scheme. No automatic auth fallback or write resubmission occurs. Both choices need live account validation; fixture checks establish only the outgoing request shape.
The token identifies the community. Requests use the fixed HTTPS origin app.circle.so, with its normal Host header. No arbitrary base URL or legacy community-ID override is exposed.
Private token file
Save only the token text in a regular file outside the checkout. Set CIRCLE_TOKEN_FILE to its absolute path. It takes precedence over the environment token, is limited to 64 KB, and refuses symlinks. Protect POSIX files with mode 0600 and Windows files/folders with user-only ACLs. The process caches the token in memory: restart after rotation. No automatic .env loader is included, and GUI clients may not inherit terminal variables.
Plans, usage and revocation
The official MCP is for admins on Business plans and above. Admin API allowances are Business 5,000; Enterprise/Circle Plus 30,000; Circle Plus Platform 250,000 requests/month. The documented rate limit is 2,000 requests per five minutes per IP and may change. Official MCP actions, local CLI calls, retries and every retrieved page consume the same community allowance. Many 4xx responses count too; usage may appear about five minutes later. Do not treat the old January 2025 enforcement paragraph as a current grace period.
Default local pacing is 200 ms per account/process; it is not a global quota manager. Other processes and tools share limits. Revoke a token through Circle and remove private client settings to disconnect. Uninstalling npm does not revoke access or delete community data.
4. Connect your client
INSTALL.md includes Claude Code, Codex, Claude Desktop extension/manual settings, Cursor, VS Code/Copilot, Windsurf, Zed, Gemini CLI, Docker and other local stdio clients on macOS, Windows and Linux. All examples use placeholders or environment forwarding; actual values belong in private user settings.
The local MCP launches with npx -y @thenavidm/circle-mcp-cli@latest. A client that only accepts a remote URL needs the official OAuth MCP at https://app.circle.so/api/mcp. It does not accept this package's local launch command. Keep the two server entries distinct if you configure both. Browser-only setup and official OAuth permissions are separate from this package's private Admin token.
Agents with a shell can install the CLI and make SKILL.md available using the client's supported skills location. The package does not register skills automatically. Ask your agent to read INSTALL.md, verify Node/binaries, help you configure credentials privately and run discovery/doctor. Installing the package is not proof of account access.
5. Check it works
circle-cli --version
circle-cli doctor
circle-cli doctor --network
circle-cli list-accounts --agent
circle-cli list-spaces --per-page 5 --agentDiscovery and schema inspection work without credentials. The network doctor makes a community-details read without printing private community content. It does not invite members, publish posts or change billing. Success proves only access to that read with the selected credentials. Read-only discovery exposes 66 tools.
6. Output, flags and exit codes
Tool names become dashed commands; underscores are accepted too. Path parameter names follow the discovered schema, such as post_id → --post-id. Body tools accept individual top-level flags, complete --payload JSON, or --payload-file pointing to a regular JSON body file up to 5 MB. Do not mix those body routes. Path/query flags remain separate. Nested objects take JSON and array flags repeat once per item; a whole array is not a single item.
circle-cli get-post --help
circle-cli schema create-post
circle-cli list-members --member-tag-ids 3 --member-tag-ids 4 --per-page 10 --agent
circle-cli search --query "onboarding" --filters '{"space_ids":["7"]}' --agentIDs above are illustrative; use discovered resources from your own community. Nullable fields require an actual JSON null inside payload; --field null is a string. Nested Tiptap properties preserve upstream extensibility; unknown top-level body fields are refused. Body-required fields are validated during execution even when the wrapper schema allows an alternative payload route. Operations whose upstream request body is required need body flags or an explicit payload; a deliberately supplied empty object is sent as JSON, never omitted.
Flag | Behavior |
--help / schema COMMAND | Current argument help / full JSON Schema |
--json | Structured JSON |
--compact | One-line JSON |
--agent | Compact JSON and no prompts; never confirms a write |
--select a,b.c | Keep selected fields, including nested objects/arrays |
--no-color / --no-input | Noninteractive house flags |
--yes | Never replaces write confirmation |
--confirm | Confirm only the requested mutation |
--account NAME | Select private local credentials |
--payload JSON / --payload-file PATH | Complete request body, mutually exclusive with body flags |
Exit | Meaning |
0 | Success |
1 | Unexpected error |
2 | Invalid arguments or refused write, an unknown command or a hidden write |
3 | Resource not found |
4 | Authentication/permission failure |
5 | API/transport failure |
7 | Rate limit |
10 | Missing or invalid private configuration |
Results go to stdout, errors as JSON to stderr. Selection changes local output, not the original API response or quota charge. API success is not proof of notification delivery or a completed export.
7. MCP or CLI and token cost
MCP and CLI are built by Slipway from each tool's one definition, so they share schemas, validation and HTTP handlers; there is no second API implementation.
Measured on 2026-10-05 against 2.0.1, the same day, with Claude Code 2.1.286 on Claude Opus 5.5 (one short prompt with and without the server connected, the difference read from the API's own usage figures) and Codex 0.159.3 on gpt-6.1-sol:
Cost | 2.0.1 | 3.0.0 |
Claude Code, every tool loaded, every message | 93,800 | 84,415 |
Claude Code's default, tool search, every message | 2,499 | 2,499 |
| 903 | 940 |
Codex over the CLI, one task, median of five | 86,128 | 82,915 |
Codex over MCP, the same task, median of five | 77,642 | 77,488 |
The task was "find the command that refunds a member's charge, and the flags it requires". Every tool loaded costs less because many write bodies appeared twice, as their own fields and inside payload, and 3.0.0 writes each repeated part once under $defs. Over the CLI, every 3.0.0 run asked which (315 characters) where 2.0.1's read the full command list (11,631). Over MCP, Codex prints its own TypeScript rendering of the tool list and cuts it to about 10,000 tokens; the full rendering is 2,046 tokens longer on 3.0.0, while the part Codex kept was a little shorter, and two 2.0.1 runs printed only the tool names. SKILL.md costs 37 more because it now says how approval works over MCP.
API quota and service costs remain separate, and no other offering was measured.
8. Every tool and argument
All 169 API operations come from the pinned official v2 snapshot. list_accounts is the local helper. The tables document every top-level operation argument. schema returns all nested requirements, unions, nullable values and enums. A body marked required is required in the body, whether supplied by flags or payload.
Tool | API | Mode |
|
| Write, confirms |
|
| Write, confirms |
|
| Read |
|
| Read |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Write, confirms |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Write, confirms |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Read |
|
| Read |
|
| Write, confirms |
|
| Write, confirms |
|
| Write, confirms |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Write, confirms |
|
| Write, confirms |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Write, confirms |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Write, confirms |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Read |
|
| Read |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Write, confirms |
|
| Write, confirms |
|
| Read |
|
| Read |
|
| Read |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Write, confirms |
|
| Read |
|
| Read |
|
| Write, confirms |
|
| Write, confirms |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Write, confirms |
|
| Write, confirms |
|
| Write, confirms |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Write, confirms |
|
| Write, confirms |
|
| Write, confirms |
|
| Write, confirms |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Write, confirms |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Write, confirms |
|
| Write, confirms |
|
| Read |
|
| Read |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Write, confirms |
|
| Write, confirms |
|
| Read |
|
| Read |
|
| Read |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Write, confirms |
|
| Write, confirms |
|
| Read |
|
| Read |
|
| Read |
|
| Write, confirms |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Read |
|
| Write, confirms |
|
| Write, confirms |
|
| Write, confirms |
|
| Write, confirms |
|
| Read |
|
| Read |
| Local settings | Read |
Shared arguments
All API tools accept account; all writes accept confirm. Tools with body properties accept payload or payload_file instead of body flags. Only the 33 reads with native page/per_page input expose all_pages and max_items. list_accounts takes no arguments.
Complete arguments
add_to_access_group
Add Member to Access Group. Changes community state and requires confirm=true for the user-requested action.
circle-cli add-to-access-group --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Access group id (path input). minimum: |
| string | Body | Email (body input). |
remove_from_access_group
Remove Access Group Member. Changes community state and requires confirm=true for the user-requested action.
circle-cli remove-from-access-group --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Access group id (path input). minimum: |
| string | Yes |
list_access_group_community_members
List Access Group Community Members. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli list-access-group-community-members --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Access Group ID minimum: |
| integer | No | Page number minimum: |
| integer | No | Number of records per page minimum: |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
get_access_group_community_member
Show Access Group Community Member. Reads community data.
circle-cli get-access-group-community-member --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Access Group ID minimum: |
| string | Yes |
create_access_group
Create Access Group. Changes community state and requires confirm=true for the user-requested action.
circle-cli create-access-group --helpArgument | Type | Required | Meaning and constraints |
| object | Body | Access group (body input). Object requires: |
list_access_groups
List Access Groups. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli list-access-groups --helpArgument | Type | Required | Meaning and constraints |
| integer | No | Page number minimum: |
| integer | No | Number of records per page minimum: |
| string | No | Filter by access group status Values: |
| array | No | Filter by access group ids Array items: integer. |
| string | No | Filter by access group name |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
archive_access_group
Archive Access Group. Changes community state and requires confirm=true for the user-requested action.
circle-cli archive-access-group --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Access Group ID minimum: |
update_access_group
Update Access Group. Changes community state and requires confirm=true for the user-requested action.
circle-cli update-access-group --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Access Group ID minimum: |
| object | Body | Access group (body input). |
unarchive_access_group
Unarchive Access Group. Changes community state and requires confirm=true for the user-requested action.
circle-cli unarchive-access-group --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Access Group ID minimum: |
search
Advanced Search. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli search --helpArgument | Type | Required | Meaning and constraints |
| integer | No | Page number minimum: |
| integer | No | Number of records per page minimum: |
| string | Yes | Search query |
| string | No | Search type Values: |
| string | No | Mention scope Values: |
| object | No | Filters |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
update_chat_preferences
Update Chat Preferences. Changes community state and requires confirm=true for the user-requested action.
circle-cli update-chat-preferences --helpArgument | Type | Required | Meaning and constraints |
| boolean | No | Enable or disable messaging for the community |
| boolean | No | Enable or disable group messaging for the community |
| boolean | No | Enable or disable voice messages for the community |
| boolean | No | Enable or disable member-to-member messaging for the community |
import_chat_room_message
Import Chat Room Message. Changes community state and requires confirm=true for the user-requested action.
circle-cli import-chat-room-message --helpArgument | Type | Required | Meaning and constraints |
| string | Body | UUID of the target chat room (from a chat space) |
| string | Body | Email of the community member who is the message sender |
| object | Body | TipTap rich text body, wrapped as |
| string | Body | Timestamp for the imported message. Required and must not be in the future. format: |
| integer/null | No | ID of the parent message when creating a thread reply |
create_comment
Create Comment. Changes community state and requires confirm=true for the user-requested action.
circle-cli create-comment --helpArgument | Type | Required | Meaning and constraints |
| string | Body | Body (body input). |
| integer | Body | Post id (body input). |
| integer | No | Parent comment id (body input). |
| string | No | Created at (body input). format: |
| string | No | Updated at (body input). format: |
| boolean | No | Skip notifications (body input). |
list_comments
List Comments. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli list-comments --helpArgument | Type | Required | Meaning and constraints |
| integer | No | Page number minimum: |
| integer | No | Number of records per page minimum: |
| integer | No | Space ID |
| integer | No | Post ID |
| string | No | Search text |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
delete_comment
Destroy Comment. Changes community state and requires confirm=true for the user-requested action.
circle-cli delete-comment --helpArgument | Type | Required | Meaning and constraints |
| string | Yes | Comment id (path input). |
get_comment
Show Comment. Reads community data.
circle-cli get-comment --helpArgument | Type | Required | Meaning and constraints |
| string | Yes | Comment id (path input). |
get_community
Get community details. Reads community data.
circle-cli get-community --helpArgument | Type | Required | Meaning and constraints |
None | Not applicable | No | Shared account/confirmation controls only. |
update_community
Update Community. Changes community state and requires confirm=true for the user-requested action.
circle-cli update-community --helpArgument | Type | Required | Meaning and constraints |
| object | No | Community (body input). |
| object | No | Community setting (body input). |
create_lead
Create a non-member contact (lead). To add a full community member instead, use create_community_member.. Changes community state and requires confirm=true for the user-requested action.
circle-cli create-lead --helpArgument | Type | Required | Meaning and constraints |
| string | Body | Email address of the contact. Must not already belong to a member or an existing non-member contact in this community. |
| string | No | Display name of the contact. |
| array | No | IDs of existing member tags to apply to the new contact. Use the member_tags endpoints to look these up. Array items: integer. |
delete_lead
Delete a non-member contact (lead). To delete a full community member instead, use destroy_community_member.. Changes community state and requires confirm=true for the user-requested action.
circle-cli delete-lead --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Numeric id of the non-member contact to delete minimum: |
export_community_member_charges
Export Community Member Charges. Changes community state and requires confirm=true for the user-requested action.
circle-cli export-community-member-charges --helpArgument | Type | Required | Meaning and constraints |
| string | No | Filter by community member email (partial match) |
| integer | No | Filter by community member ID |
| string | No | Filter by community member public UID |
| string | No | Filter by billing info business name (partial match) |
| string | No | Comma-separated list of paywall price types (e.g. subscription,onetime,installments) |
| string | No | Filter by exact processor (charge) ID |
| string | No | Filter by exact subscription processor ID |
| string | No | Filter by exact invoice processor ID |
| string | No | Comma-separated list of currency codes |
| string | No | Comma-separated list of paywall IDs |
| string | No | Comma-separated list of statuses (e.g. paid,refunded,partial_refunded) |
| string | No | Comma-separated list of platforms (web, app_store, play_store) |
| integer | No | Minimum charge amount (in currency subunits) |
| integer | No | Maximum charge amount (in currency subunits) |
| string | No | Only include charges created on/after this date (ISO8601) |
| string | No | Only include charges created on/before this date (ISO8601) |
| string | No | Comma-separated list of CSV columns to include |
| string | No | Timezone used to render dates in the CSV (defaults to Etc/UTC) |
list_charges
Community Member Charges List. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli list-charges --helpArgument | Type | Required | Meaning and constraints |
| integer | No | Page number minimum: |
| integer | No | Records per page (max 100) minimum: |
| string | No | Free-text search |
| string | No | Filter by community member email (partial match) |
| integer | No | Filter by community member ID |
| string | No | Filter by community member public UID |
| string | No | Filter by billing info business name (partial match) |
| string | No | Comma-separated list of paywall price types (e.g. subscription,onetime,installments) |
| string | No | Filter by exact processor (charge) ID |
| string | No | Filter by exact subscription processor ID |
| string | No | Filter by exact invoice processor ID |
| string | No | Comma-separated list of currency codes |
| string | No | Comma-separated list of paywall IDs |
| string | No | Comma-separated list of statuses (e.g. paid,refunded,partial_refunded) |
| string | No | Comma-separated list of platforms (web, app_store, play_store) |
| integer | No | Minimum charge amount (in currency subunits) |
| integer | No | Maximum charge amount (in currency subunits) |
| string | No | Only include charges created on/after this date (ISO8601) |
| string | No | Only include charges created on/before this date (ISO8601) |
| string | No | Sort field. Defaults to created_at. Values: |
| string | No | Sort direction. Defaults to desc. Values: |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
refund_community_member_charge
Refund Community Member Charge. Changes community state and requires confirm=true for the user-requested action.
circle-cli refund-community-member-charge --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Community Member Charge ID minimum: |
| integer | No | Amount to refund (in currency subunits). Omit for a full refund. |
| string | Body | Refund reason. Required, 255 characters max. maxLength: |
list_member_spaces
List Community Member Spaces. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli list-member-spaces --helpArgument | Type | Required | Meaning and constraints |
| integer | No | Page number minimum: |
| integer | No | Number of records per page minimum: |
| integer | No | Community member id (query input). |
| string | No | User email (query input). |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
cancel_community_member_subscription
Cancel Community Member Subscription. Changes community state and requires confirm=true for the user-requested action.
circle-cli cancel-community-member-subscription --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Community Member Subscription ID minimum: |
| string | Body | Cancellation timing: 'now' or 'at_period_end'. |
| string | No | Optional refund type when canceling immediately: 'prorated' or 'full'. |
export_community_member_subscriptions
Export Community Member Subscriptions. Changes community state and requires confirm=true for the user-requested action.
circle-cli export-community-member-subscriptions --helpArgument | Type | Required | Meaning and constraints |
| string | No | Filter by community member email (partial match) |
| integer | No | Filter by community member ID |
| string | No | Filter by community member public UID |
| string | No | Filter by billing info business name (partial match) |
| string | No | Comma-separated list of paywall price types (e.g. subscription,onetime,installments) |
| string | No | Filter by paywall price billing interval (e.g. month, year) |
| string | No | Filter by exact subscription processor ID |
| string | No | Comma-separated list of currency codes |
| string | No | Comma-separated list of paywall IDs |
| string | No | Comma-separated list of statuses (e.g. active,trial,canceled) |
| boolean | No | Filter by whether the subscription is scheduled to cancel |
| string | No | Comma-separated list of platforms (web, app_store, play_store) |
| integer | No | Minimum total amount paid (in currency subunits) |
| integer | No | Maximum total amount paid (in currency subunits) |
| string | No | Only include subscriptions started on/after this date (ISO8601) |
| string | No | Only include subscriptions started on/before this date (ISO8601) |
| string | No | Comma-separated list of CSV columns to include |
| string | No | Timezone used to render dates in the CSV (defaults to Etc/UTC) |
list_subscriptions
Community Member Subscriptions List. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli list-subscriptions --helpArgument | Type | Required | Meaning and constraints |
| integer | No | Page number minimum: |
| integer | No | Records per page (max 100) minimum: |
| string | No | Free-text search |
| string | No | Filter by community member email (partial match) |
| integer | No | Filter by community member ID |
| string | No | Filter by community member public UID |
| string | No | Filter by billing info business name (partial match) |
| string | No | Comma-separated list of paywall price types (e.g. subscription,onetime,installments) |
| string | No | Filter by paywall price billing interval (e.g. month, year) |
| string | No | Filter by exact subscription processor ID |
| string | No | Comma-separated list of currency codes |
| string | No | Comma-separated list of paywall IDs |
| string | No | Comma-separated list of statuses (e.g. active,trial,canceled) |
| boolean | No | Filter by whether the subscription is scheduled to cancel |
| string | No | Comma-separated list of platforms (web, app_store, play_store) |
| integer | No | Minimum total amount paid (in currency subunits) |
| integer | No | Maximum total amount paid (in currency subunits) |
| string | No | Only include subscriptions started on/after this date (ISO8601) |
| string | No | Only include subscriptions started on/before this date (ISO8601) |
| string | No | Sort field (one of: charges_quantity, subscription_term, renews_on, community_member_name, paywall_name, platform, status, created_at). Defaults to created_at |
| string | No | Sort direction (asc or desc). Defaults to desc |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
resume_community_member_subscription
Resume Community Member Subscription. Changes community state and requires confirm=true for the user-requested action.
circle-cli resume-community-member-subscription --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Community Member Subscription ID minimum: |
list_member_access_groups
List Community Member's Access Groups. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli list-member-access-groups --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Community Member ID minimum: |
| integer | No | Page number minimum: |
| integer | No | Number of records per page minimum: |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
ban_community_member
Ban Community Member. Changes community state and requires confirm=true for the user-requested action.
circle-cli ban-community-member --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Community member ID to ban minimum: |
create_member
Create/Invite a community member. Changes community state and requires confirm=true for the user-requested action.
circle-cli create-member --helpArgument | Type | Required | Meaning and constraints |
| string | Body | Email (body input). |
| string | No | Password (body input). |
| boolean | No | Skip invitation (body input). |
| string | No | signed_id of the avatar returned from the direct upload endpoint |
| string | No | Name (body input). |
| string | No | Headline (body input). |
| boolean | No | Is flagged (body input). |
| object | No | Preferences (body input). |
| array | No | Space ids (body input). Array items: integer. |
| array | No | Space group ids (body input). Array items: integer. |
| array | No | Member tag ids (body input). Array items: integer. |
| object | No | Profile fields key value pairs |
list_members
List Community Members. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli list-members --helpArgument | Type | Required | Meaning and constraints |
| integer | No | Page number minimum: |
| integer | No | Number of records per page minimum: |
| string | No | Filter by member status. Defaults to |
| array | No | Filter by Member Tag IDs (OR logic, comma-separated) Array items: integer. |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
delete_community_member
Delete Community Member. Changes community state and requires confirm=true for the user-requested action.
circle-cli delete-community-member --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Community member ID to delete minimum: |
remove_member
Deactivate a community member. Changes community state and requires confirm=true for the user-requested action.
circle-cli remove-member --helpArgument | Type | Required | Meaning and constraints |
| string | Yes | ID of the community member |
get_member
Show a community member. Reads community data.
circle-cli get-member --helpArgument | Type | Required | Meaning and constraints |
| string | Yes | ID of the community member |
update_member
Update a community member. Changes community state and requires confirm=true for the user-requested action.
circle-cli update-member --helpArgument | Type | Required | Meaning and constraints |
| string | Yes | ID of the community member |
| string | No | signed_id of the avatar returned from the direct upload endpoint |
| string | No | Name (body input). |
| string | No | Headline (body input). |
| boolean | No | Is flagged (body input). |
| string | No | Effective "member since" / joined date. Cannot be in the future. format: |
| object | No | Preferences (body input). |
| array | No | Space ids (body input). Array items: integer. |
| array | No | Space group ids (body input). Array items: integer. |
| array | No | Member tag ids (body input). Array items: integer. |
| object | No | Profile fields key value pairs |
search_member
Search a community member. Reads community data.
circle-cli search-member --helpArgument | Type | Required | Meaning and constraints |
| string | Yes | Email of the community member |
create_community_segment
Create a community segment. Changes community state and requires confirm=true for the user-requested action.
circle-cli create-community-segment --helpArgument | Type | Required | Meaning and constraints |
| string | Body | Title (body input). |
| boolean | Body | Visible (body input). |
| object | Body | Rules (body input). Object requires: |
| object | No | Community segment consumer attributes (body input). |
list_segments
List Community Segments. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli list-segments --helpArgument | Type | Required | Meaning and constraints |
| integer | No | Page number minimum: |
| integer | No | Number of records per page minimum: |
| string | No | Filter by title |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
delete_community_segment
Delete a community segment. Changes community state and requires confirm=true for the user-requested action.
circle-cli delete-community-segment --helpArgument | Type | Required | Meaning and constraints |
| string | Yes | ID of the community segment to delete |
update_community_segment
Update a community segment. Changes community state and requires confirm=true for the user-requested action.
circle-cli update-community-segment --helpArgument | Type | Required | Meaning and constraints |
| string | Yes | ID of the community segment to update |
| string | Body | Title (body input). |
| boolean | Body | Visible (body input). |
| object | Body | Rules (body input). Object requires: |
| object | No | Community segment consumer attributes (body input). |
duplicate_community_segment
Duplicate a community segment. Changes community state and requires confirm=true for the user-requested action.
circle-cli duplicate-community-segment --helpArgument | Type | Required | Meaning and constraints |
| string | Yes | ID of the community segment to duplicate |
| string | Yes | Title for the duplicated community segment |
create_contact_note
Create Contact Note. Changes community state and requires confirm=true for the user-requested action.
circle-cli create-contact-note --helpArgument | Type | Required | Meaning and constraints |
| string | Yes | Contact ID or sqid |
| object | Body | Rich text note in Tiptap document format Object requires: |
list_contact_notes
List Contact Notes. Reads community data.
circle-cli list-contact-notes --helpArgument | Type | Required | Meaning and constraints |
| string | Yes | Contact ID or sqid |
| integer | No | Page number minimum: |
update_course_progress
Update Course Lesson Progress. Changes community state and requires confirm=true for the user-requested action.
circle-cli update-course-progress --helpArgument | Type | Required | Meaning and constraints |
| integer | Body | Lesson id (body input). |
| string | Body | Member email (body input). |
| string | Body | Status (body input). Values: |
create_course_lesson
Create a course lesson. Changes community state and requires confirm=true for the user-requested action.
circle-cli create-course-lesson --helpArgument | Type | Required | Meaning and constraints |
| integer | Body | Section id (body input). |
| string | Body | Name (body input). |
| string | No | Status (body input). Values: |
| string | No | Body html (body input). |
| boolean | No | Is comments enabled (body input). |
| boolean | No | Is featured media enabled (body input). |
| boolean | No | Is featured media download enabled (body input). |
| string | No | signed_id of the lesson thumbnail image returned from the direct upload endpoint |
| string | No | signed_id of the lesson featured media file returned from the direct upload endpoint |
| object | No | Rich text body (body input). |
list_course_lessons
List course lessons. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli list-course-lessons --helpArgument | Type | Required | Meaning and constraints |
| integer | No | Page number minimum: |
| integer | No | Number of records per page minimum: |
| integer | No | Section ID |
| integer | No | Space ID |
| string | No | Status Values: |
| string | No | Sorting parameters (sort by name in ascending order, name in descending order, and by newest. Default is oldest) Values: |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
delete_course_lesson
Delete a course lesson. Changes community state and requires confirm=true for the user-requested action.
circle-cli delete-course-lesson --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Course lesson ID minimum: |
get_course_lesson
Show a course lesson. Reads community data.
circle-cli get-course-lesson --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | ID of the course lesson minimum: |
update_course_lesson
Update a course lesson. Changes community state and requires confirm=true for the user-requested action.
circle-cli update-course-lesson --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | ID of the course lesson minimum: |
| string | No | Name (body input). |
| string | No | Status (body input). Values: |
| string | No | Body html (body input). |
| boolean | No | Is comments enabled (body input). |
| boolean | No | Is featured media enabled (body input). |
| boolean | No | Is featured media download enabled (body input). |
| string | No | signed_id of the lesson thumbnail image returned from the direct upload endpoint |
| string | No | signed_id of the lesson featured media file returned from the direct upload endpoint |
| object | No | Rich text body (body input). |
reorder_course_lessons
Reorder course lessons. Changes community state and requires confirm=true for the user-requested action.
circle-cli reorder-course-lessons --helpArgument | Type | Required | Meaning and constraints |
| integer | Body | ID of the course space |
| array | Body | All course sections and lessons in their final order Array items: object. |
create_course_section
Create a course section. Changes community state and requires confirm=true for the user-requested action.
circle-cli create-course-section --helpArgument | Type | Required | Meaning and constraints |
| string | Body | Name (body input). |
| integer | Body | Space id (body input). |
list_course_sections
List Course Sections. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli list-course-sections --helpArgument | Type | Required | Meaning and constraints |
| integer | No | Page number minimum: |
| integer | No | Number of records per page minimum: |
| integer | No | Space ID of the course section |
| string | No | Sorting parameters (sort by name in ascending order, name in descending order, and by newest. Default is oldest) Values: |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
delete_course_section
Delete a course section. Changes community state and requires confirm=true for the user-requested action.
circle-cli delete-course-section --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Course section ID minimum: |
get_course_section
Show a course section. Reads community data.
circle-cli get-course-section --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | ID of the course section minimum: |
update_course_section
Update a course section. Changes community state and requires confirm=true for the user-requested action.
circle-cli update-course-section --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | ID of the course section minimum: |
| string | Body | Name (body input). |
create_direct_upload
Create Direct Upload. Changes community state and requires confirm=true for the user-requested action.
circle-cli create-direct-upload --helpArgument | Type | Required | Meaning and constraints |
| object | Body | Blob (body input). Object requires: |
create_embed
Create Embed. Changes community state and requires confirm=true for the user-requested action.
circle-cli create-embed --helpArgument | Type | Required | Meaning and constraints |
| string | Body | The URL to embed (e.g., YouTube, Vimeo, etc.) |
get_embed
Get Embed. Reads community data.
circle-cli get-embed --helpArgument | Type | Required | Meaning and constraints |
| string | Yes | The sgid of the embed |
create_event_attendee
Create Event Attendee. Changes community state and requires confirm=true for the user-requested action.
circle-cli create-event-attendee --helpArgument | Type | Required | Meaning and constraints |
| string | No | Member Email |
| string | No | Event ID |
delete_event_attendee
Delete Event Attendee. Changes community state and requires confirm=true for the user-requested action.
circle-cli delete-event-attendee --helpArgument | Type | Required | Meaning and constraints |
| string | No | Member Email |
| string | No | Event ID |
list_event_attendees
List Event Attendees. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli list-event-attendees --helpArgument | Type | Required | Meaning and constraints |
| string | Yes | Event ID |
| integer | No | Page number minimum: |
| integer | No | Number of records per page minimum: |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
create_event
Create Event. Changes community state and requires confirm=true for the user-requested action.
circle-cli create-event --helpArgument | Type | Required | Meaning and constraints |
| object | Body | Event (body input). Object requires: |
| integer | Body | Space id (body input). |
list_events
List Events. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli list-events --helpArgument | Type | Required | Meaning and constraints |
| integer | No | Page number minimum: |
| integer | No | Number of records per page minimum: |
| integer | No | Filter events by event space ID |
| string | No | Start date for filtering events (format: YYYY-MM-DD) format: |
| string | No | End date for filtering events (format: YYYY-MM-DD) format: |
| string | No | Sort events - oldest (by created_at), start_date (by starts_at ascending), start_date_desc (by starts_at descending), default is newest (by published_at) Values: |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
delete_event
Delete Event. Changes community state and requires confirm=true for the user-requested action.
circle-cli delete-event --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Event ID minimum: |
| integer | Yes | Space ID |
get_event
Get Event. Reads community data.
circle-cli get-event --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Event ID minimum: |
update_event
Update Event. Changes community state and requires confirm=true for the user-requested action.
circle-cli update-event --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Event ID minimum: |
| object | Body | Event (body input). Object requires: |
| integer | Body | Space id (body input). |
duplicate_event
Duplicate Event. Changes community state and requires confirm=true for the user-requested action.
circle-cli duplicate-event --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Space ID minimum: |
| integer | Yes | Event ID minimum: |
| object | Body | Event (body input). Object requires: |
get_filter_configuration
Get the filters currently shown on the member directory or a member space. Reads community data.
circle-cli get-filter-configuration --helpArgument | Type | Required | Meaning and constraints |
| string | Yes | Surface to inspect. Use member_directory for the community directory or member_space for a specific members space. Values: |
| integer | No | Members space ID. Required when context is member_space. |
create_filter_control
Create a member filter control. Changes community state and requires confirm=true for the user-requested action.
circle-cli create-filter-control --helpArgument | Type | Required | Meaning and constraints |
| string | Body | Filter to control; profile_field requires profile_field_id Values: |
| boolean | Body | Whether to show the filter |
| integer | No | Member space ID; omit for the member directory |
| integer | No | Profile field ID; allowed only when key is profile_field |
| integer | No | Optional ordering position; lower values sort first |
list_filter_controls
List member directory and member space filter controls. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli list-filter-controls --helpArgument | Type | Required | Meaning and constraints |
| integer | No | Only controls for this member space |
| boolean | No | Only member-directory controls that are not scoped to a space |
| boolean | No | Only enabled or disabled controls |
| string | No | Only controls for this filter key Values: |
| integer | No | Only controls for this profile field |
| integer | No | Page number minimum: |
| integer | No | Number of records per page (max 100) minimum: |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
delete_filter_control
Delete a filter control. Changes community state and requires confirm=true for the user-requested action.
circle-cli delete-filter-control --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | ID of the filter control to delete minimum: |
get_filter_control
Get a filter control. Reads community data.
circle-cli get-filter-control --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Filter control ID minimum: |
update_filter_control
Update a member directory or member space filter control. Changes community state and requires confirm=true for the user-requested action.
circle-cli update-filter-control --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Filter control ID. Use list_filter_kit_controls if the ID is unknown. minimum: |
| string | No | Filter to control. Values: |
| boolean | No | Whether the filter is shown. Set false to hide it. |
| integer | No | Member space ID to move this control to. |
| integer | No | Profile field ID for a profile_field control. |
| integer | No | Ordering position; lower values sort first. |
report_flagged_content
Report Flagged Content. Changes community state and requires confirm=true for the user-requested action.
circle-cli report-flagged-content --helpArgument | Type | Required | Meaning and constraints |
| object | Body | Flagged content (body input). Object requires: |
list_flagged_content
List Flagged Contents. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli list-flagged-content --helpArgument | Type | Required | Meaning and constraints |
| integer | No | Page number minimum: |
| integer | No | Number of records per page minimum: |
| string | No | Status. Default: 'all'. Values: |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
delete_form
Delete a form. Changes community state and requires confirm=true for the user-requested action.
circle-cli delete-form --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Form ID minimum: |
get_form
Show a form. Reads community data.
circle-cli get-form --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Form ID minimum: |
update_form
Update a form. Changes community state and requires confirm=true for the user-requested action.
circle-cli update-form --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Form ID minimum: |
| string | No | Name (body input). |
| string | No | After submission action (body input). Values: |
| string | No | Embed display format (body input). Values: |
| string/null | No | Redirect url (body input). |
| string | No | Status (body input). Values: |
| string/null | No | Thank you page title (body input). |
| string/null | No | Thank you page body (body input). |
| integer | No | Popup delay (body input). |
| integer | No | Popup frequency (body input). |
| object/null | No | Embed styles (body input). |
| object/null | No | Standalone page styles (body input). |
| array | No | Elements (body input). Array items: object. |
duplicate_form
Duplicate a form. Changes community state and requires confirm=true for the user-requested action.
circle-cli duplicate-form --helpArgument | Type | Required | Meaning and constraints |
| string | Yes | ID of the form to duplicate |
list_forms
List Forms. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli list-forms --helpArgument | Type | Required | Meaning and constraints |
| integer | No | Page number minimum: |
| integer | No | Number of records per page minimum: |
| string | No | Filter by form name |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
create_form_submission
Create a form submission. Changes community state and requires confirm=true for the user-requested action.
circle-cli create-form-submission --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Form ID minimum: |
| array | Body | Elements (body input). Array items: object. |
| string/null | No | Email of the contact on behalf of which the submission is being created |
get_form_submissions
List form submissions. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli get-form-submissions --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Form ID minimum: |
| integer | No | Page number minimum: |
| integer | No | Number of records per page minimum: |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
get_leaderboard
Show Leaderboard. Reads community data.
circle-cli get-leaderboard --helpArgument | Type | Required | Meaning and constraints |
| string | No | Leaderboard period, default is all time Values: |
create_image_post
Create Image Post. Changes community state and requires confirm=true for the user-requested action.
circle-cli create-image-post --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Image space ID minimum: |
| string | No | Slug (body input). |
| string | No | Status (body input). Values: |
| boolean | No | Is liking enabled (body input). |
| boolean | No | Is comments enabled (body input). |
| array | No | Topics (body input). Array items: integer. |
| object | No | Tiptap body (body input). |
| object | Body | Gallery attributes (body input). |
| string | No | email of the author (preferred over user_id) |
| integer | No | id of the author |
| boolean | No | whether the post should be pinned to the top |
list_image_posts
List Image Posts. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli list-image-posts --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Image space ID minimum: |
| integer | No | Page number minimum: |
| integer | No | Number of records per page minimum: |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
delete_image_post
Delete Image Post. Changes community state and requires confirm=true for the user-requested action.
circle-cli delete-image-post --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Image space ID minimum: |
| integer | Yes | Image post ID minimum: |
get_image_post
Show Image Post. Reads community data.
circle-cli get-image-post --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Image space ID minimum: |
| integer | Yes | Image post ID minimum: |
duplicate_image_post
Duplicate Image Post. Changes community state and requires confirm=true for the user-requested action.
circle-cli duplicate-image-post --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Image space ID minimum: |
| integer | Yes | Image post ID minimum: |
| object | No | Post (body input). |
create_invitation
Create invitation link. Changes community state and requires confirm=true for the user-requested action.
circle-cli create-invitation --helpArgument | Type | Required | Meaning and constraints |
| string | Body | Name for the invitation link |
| integer | No | ID of the space to open after signup |
| array | No | Access group IDs to attach. Presence, including an empty array, selects access-group mode Array items: integer. |
| array | No | Member tag IDs to apply when the link is used Array items: integer. |
| object/null | No | Optional paywall configuration |
list_invitations
List Invitation Links. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli list-invitations --helpArgument | Type | Required | Meaning and constraints |
| integer | No | Page number minimum: |
| integer | No | Number of records per page minimum: |
| string | No | Filter by invitation link name |
| string | No | Filter by invitation link status Values: |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
delete_invitation_link
Delete invitation link. Changes community state and requires confirm=true for the user-requested action.
circle-cli delete-invitation-link --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Invitation link ID minimum: |
update_invitation_link
Update invitation link. Changes community state and requires confirm=true for the user-requested action.
circle-cli update-invitation-link --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Invitation link ID minimum: |
| string | No | Name for the invitation link |
| integer/null | No | ID of the space to open after signup. Set to null to remove the existing redirect |
| array | No | Access group IDs to attach; fully replaces the current set (empty array detaches all) Array items: integer. |
| array | No | Member tag IDs to apply when the link is used Array items: integer. |
| object/null | No | Paywall configuration. Set to null to remove the existing paywall configuration |
revoke_invitation_link
Revoke invitation link. Changes community state and requires confirm=true for the user-requested action.
circle-cli revoke-invitation-link --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Invitation link ID minimum: |
list_live_rooms
List Live Rooms. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli list-live-rooms --helpArgument | Type | Required | Meaning and constraints |
| integer | No | Page number minimum: |
| integer | No | Number of records per page minimum: |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
list_live_room_transcripts
List Live Room Transcripts. Reads community data.
circle-cli list-live-room-transcripts --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Live Room ID minimum: |
search_locations
Search locations. Reads community data.
circle-cli search-locations --helpArgument | Type | Required | Meaning and constraints |
| string | Yes | Free-text location query (e.g. 'San Francisco, CA' or 'Berlin'). |
create_member_tag
Create Member Tag. Changes community state and requires confirm=true for the user-requested action.
circle-cli create-member-tag --helpArgument | Type | Required | Meaning and constraints |
| string | No | Color (body input). |
| string | No | Display format (body input). Values: |
| string | No | Emoji (body input). |
| boolean | No | Is background enabled (body input). |
| boolean | No | Is public (body input). |
| string | No | Name (body input). |
| object | No | Display locations (body input). |
| object | No | Custom emoji (body input). |
list_member_tags
Member Tags List. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli list-member-tags --helpArgument | Type | Required | Meaning and constraints |
| integer | No | Page number minimum: |
| integer | No | Number of records per page minimum: |
| string | No | Name of the member tag |
| boolean | No | Whether the member tag is public |
| string | No | Sorting parameters (sort by name in ascending order, name in descending order, and by newest. Default is oldest) Values: |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
delete_member_tag
Deletes a member tag. Changes community state and requires confirm=true for the user-requested action.
circle-cli delete-member-tag --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Member tag ID minimum: |
get_member_tag
Shows a member tag's details. Reads community data.
circle-cli get-member-tag --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Member tag ID minimum: |
update_member_tag
Update member tag. Changes community state and requires confirm=true for the user-requested action.
circle-cli update-member-tag --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Member tag ID minimum: |
| string | No | Color (body input). |
| string | No | Display format (body input). Values: |
| string | No | Emoji (body input). |
| boolean | No | Is background enabled (body input). |
| boolean | No | Is public (body input). |
| string | No | Name (body input). |
| object | No | Display locations (body input). |
| object | No | Custom emoji (body input). |
send_message
Create Message. Changes community state and requires confirm=true for the user-requested action.
circle-cli send-message --helpArgument | Type | Required | Meaning and constraints |
| object/null | No | Rich text body (body input). |
| string | No | User email (body input). |
| array | No | User emails (body input). Array items: string. |
| string | No | Chat room uuid (body input). |
| integer | No | Parent message id (body input). |
list_page_profile_fields
Get Page Profile Fields. Reads community data.
circle-cli list-page-profile-fields --helpArgument | Type | Required | Meaning and constraints |
| string | Yes | Page name Values: |
get_payment_method_settings
Retrieves the community's payment method preferences. Reads community data.
circle-cli get-payment-method-settings --helpArgument | Type | Required | Meaning and constraints |
None | Not applicable | No | Shared account/confirmation controls only. |
export_paywall_affiliate_payouts
Export Paywall Affiliate Payouts. Changes community state and requires confirm=true for the user-requested action.
circle-cli export-paywall-affiliate-payouts --helpArgument | Type | Required | Meaning and constraints |
| array | No | Community member IDs to scope the export to (max 20 per request). Omit to export all processing payouts. maxItems: |
mark_paywall_affiliate_payouts_paid
Mark Paywall Affiliate Payouts Paid. Changes community state and requires confirm=true for the user-requested action.
circle-cli mark-paywall-affiliate-payouts-paid --helpArgument | Type | Required | Meaning and constraints |
| array | No | Community member IDs to scope the mark-paid to (max 20 per request). Omit to mark all processing payouts as paid. maxItems: |
start_paywall_affiliate_payouts
Start Paywall Affiliate Payouts. Changes community state and requires confirm=true for the user-requested action.
circle-cli start-paywall-affiliate-payouts --helpArgument | Type | Required | Meaning and constraints |
| array | No | Community member IDs to scope the start to (max 20 per request). Omit to start all due payouts. maxItems: |
list_paywall_affiliates
Paywall Affiliates List. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli list-paywall-affiliates --helpArgument | Type | Required | Meaning and constraints |
| integer | No | Page number minimum: |
| integer | No | Records per page (max 100) minimum: |
| object | No | Filters |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
invite_paywall_affiliates
Invite Paywall Affiliates. Changes community state and requires confirm=true for the user-requested action.
circle-cli invite-paywall-affiliates --helpArgument | Type | Required | Meaning and constraints |
| array | Body | Community member IDs to invite (max 20 per request). Must belong to the current community. maxItems: |
update_paywall_affiliate
Update Paywall Affiliate. Changes community state and requires confirm=true for the user-requested action.
circle-cli update-paywall-affiliate --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Affiliate ID minimum: |
| string | No | Status (body input). |
delete_paywall_coupon
Deletes a paywall coupon. Changes community state and requires confirm=true for the user-requested action.
circle-cli delete-paywall-coupon --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Paywall coupon ID minimum: |
create_paywall_group
Create Subscription Group. Changes community state and requires confirm=true for the user-requested action.
circle-cli create-paywall-group --helpArgument | Type | Required | Meaning and constraints |
| string | Body | Name (body input). |
| integer | Body | ID of the currency the group's paywalls are priced in |
update_paywall_group
Update Subscription Group. Changes community state and requires confirm=true for the user-requested action.
circle-cli update-paywall-group --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Subscription group ID minimum: |
| string | No | Name (body input). |
| integer | No | ID of the currency the group's paywalls are priced in |
search_paywalls
Search Paywalls. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli search-paywalls --helpArgument | Type | Required | Meaning and constraints |
| integer | No | Page number minimum: |
| integer | No | Records per page (max 100) minimum: |
| string | No | Filter by paywall name or display name (partial match) |
| string | No | Comma-separated list of statuses (e.g. draft,active,inactive) |
| string | No | Comma-separated list of currency codes |
| string | No | Comma-separated list of paywall IDs to include |
| string | No | Comma-separated list of paywall IDs to exclude |
| string | No | Comma-separated list of subscription group IDs to include |
| string | No | Comma-separated list of subscription group IDs to exclude |
| string | No | Sort field (one of: title, status, created_at). Defaults to created_at |
| string | No | Sort direction (asc or desc). Defaults to desc. Only takes effect when sort is also given -- direction alone is ignored |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
delete_paywall
Deletes a paywall. Changes community state and requires confirm=true for the user-requested action.
circle-cli delete-paywall --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Paywall ID minimum: |
archive_paywall
Archives a paywall. Changes community state and requires confirm=true for the user-requested action.
circle-cli archive-paywall --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Paywall ID minimum: |
publish_paywall
Publishes a paywall. Changes community state and requires confirm=true for the user-requested action.
circle-cli publish-paywall --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Paywall ID minimum: |
unarchive_paywall
Unarchives a paywall. Changes community state and requires confirm=true for the user-requested action.
circle-cli unarchive-paywall --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Paywall ID minimum: |
unfollow_post
Unfollow a post. Changes community state and requires confirm=true for the user-requested action.
circle-cli unfollow-post --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Post ID minimum: |
| integer | Yes | Community Member ID |
create_post
Create Basic Post. Changes community state and requires confirm=true for the user-requested action.
circle-cli create-post --helpArgument | Type | Required | Meaning and constraints |
| integer | Body | Space id (body input). |
| string | No | Status (body input). Values: |
| string | Body | Name (body input). |
| string | No | Slug (body input). |
| object | No | Tiptap body (body input). |
| string | No | signed_id of the cover image |
| string | No | Internal custom html (body input). |
| boolean | No | Is truncation disabled (body input). |
| boolean | No | Is comments closed (body input). |
| boolean | No | Is comments enabled (body input). |
| boolean | No | Is liking enabled (body input). |
| boolean | No | Hide meta info (body input). |
| boolean | No | Hide from featured areas (body input). |
| string | No | Meta title (body input). |
| string | No | Meta description (body input). |
| string | No | Opengraph title (body input). |
| string | No | Opengraph description (body input). |
| string | No | Published at (body input). |
| string | No | Created at (body input). |
| array | No | Topics (body input). Array items: integer. |
| boolean | No | Skip notifications (body input). |
| boolean | No | Is pinned (body input). |
| string | No | email of the author (preferred over user_id) |
| integer | No | id of the author |
list_posts
List Basic Posts. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli list-posts --helpArgument | Type | Required | Meaning and constraints |
| integer | No | Page number minimum: |
| integer | No | Number of records per page minimum: |
| integer | No | Basic type space ID |
| integer | No | Space Group ID |
| string | No | Post status Values: |
| string | No | Search text |
| string | No | Sort by Values: |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
delete_post
Delete Basic Post. Changes community state and requires confirm=true for the user-requested action.
circle-cli delete-post --helpArgument | Type | Required | Meaning and constraints |
| string | Yes | Post id (path input). |
get_post
Show Basic Post. Reads community data.
circle-cli get-post --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Post ID minimum: |
update_post
Update Basic Post. Changes community state and requires confirm=true for the user-requested action.
circle-cli update-post --helpArgument | Type | Required | Meaning and constraints |
| string | Yes | Post id (path input). |
| object | No | The Tiptap body will be updated only for posts that already contain a Tiptap body. If the post does not have a Tiptap body, the tiptap_body will be ignored. |
| string | No | Name (body input). |
| string | No | signed_id of the cover image |
| string | No | Internal custom html (body input). |
| boolean | No | Is truncation disabled (body input). |
| boolean | No | Is comments closed (body input). |
| boolean | No | Is comments enabled (body input). |
| boolean | No | Is liking enabled (body input). |
| boolean | No | Hide meta info (body input). |
| boolean | No | Hide from featured areas (body input). |
| string | No | Meta title (body input). |
| string | No | Meta description (body input). |
| string | No | Opengraph title (body input). |
| string | No | Opengraph description (body input). |
| string | No | Published at (body input). |
| array | No | Topics (body input). Array items: integer. |
| boolean | No | Skip notifications (body input). |
| boolean | No | Is pinned (body input). |
get_post_summary
Get Post Summary. Reads community data.
circle-cli get-post-summary --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Post ID minimum: |
archive_profile_field
Archive Profile Field. Changes community state and requires confirm=true for the user-requested action.
circle-cli archive-profile-field --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Profile field ID minimum: |
create_profile_field
Create Profile Field. Changes community state and requires confirm=true for the user-requested action.
circle-cli create-profile-field --helpArgument | Type | Required | Meaning and constraints |
| object | Body | Profile field (body input). Object requires: |
list_profile_fields
Profile Fields List. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli list-profile-fields --helpArgument | Type | Required | Meaning and constraints |
| integer | No | Page number minimum: |
| integer | No | Number of records per page minimum: |
| string | No | Filter by label (case-insensitive partial match) |
| string | No | Set to 'true' to search archived profile fields, omit or set to 'false' for active fields |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
delete_profile_field
Delete Profile Field. Changes community state and requires confirm=true for the user-requested action.
circle-cli delete-profile-field --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Archived profile field ID minimum: |
update_profile_field
Update Profile Field. Changes community state and requires confirm=true for the user-requested action.
circle-cli update-profile-field --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Profile field ID minimum: |
| object | Body | Profile field (body input). |
unarchive_profile_field
Unarchive Profile Field. Changes community state and requires confirm=true for the user-requested action.
circle-cli unarchive-profile-field --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Profile field ID minimum: |
get_connect_settings
Get Connect settings. Reads community data.
circle-cli get-connect-settings --helpArgument | Type | Required | Meaning and constraints |
None | Not applicable | No | Shared account/confirmation controls only. |
update_connect_settings
Update Connect settings. Changes community state and requires confirm=true for the user-requested action.
circle-cli update-connect-settings --helpArgument | Type | Required | Meaning and constraints |
| object | No | Connect (body input). |
| object | No | Member directory (body input). |
| object | No | Messaging (body input). |
create_space_group_member
Create Space Group Member. Changes community state and requires confirm=true for the user-requested action.
circle-cli create-space-group-member --helpArgument | Type | Required | Meaning and constraints |
| integer | Body | Space group id (body input). |
| string | Body | Email (body input). |
delete_space_group_member
Destroy Space Group Member. Changes community state and requires confirm=true for the user-requested action.
circle-cli delete-space-group-member --helpArgument | Type | Required | Meaning and constraints |
| string | Yes | Email of the user |
| integer | Yes | ID of the space group |
list_space_group_members
List Space Group Members. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli list-space-group-members --helpArgument | Type | Required | Meaning and constraints |
| integer | No | Page number minimum: |
| integer | No | Number of records per page minimum: |
| integer | Yes | Space Group ID |
| string | No | Space group member status. By default, it returns all members. Values: |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
get_space_group_member
Show Space Group Member. Reads community data.
circle-cli get-space-group-member --helpArgument | Type | Required | Meaning and constraints |
| string | Yes | Email of the user |
| integer | Yes | ID of the space group |
create_space_group
Create Space Group. Changes community state and requires confirm=true for the user-requested action.
circle-cli create-space-group --helpArgument | Type | Required | Meaning and constraints |
| string | Body | Name (body input). |
| string | Body | Slug (body input). |
| boolean | No | Is hidden from non members (body input). |
| boolean | No | Hide members count (body input). |
| boolean | No | Allow members to create spaces (body input). |
| boolean | No | Automatically add members to new spaces (body input). |
| boolean | No | Add members to space group on space join (body input). |
| boolean | No | Hide non member spaces from sidebar (body input). |
list_space_groups
List Space Groups. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli list-space-groups --helpArgument | Type | Required | Meaning and constraints |
| integer | No | Page number minimum: |
| integer | No | Number of records per page minimum: |
| string | No | Filter by name |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
delete_space_group
Delete Space Group. Changes community state and requires confirm=true for the user-requested action.
circle-cli delete-space-group --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Space Group ID minimum: |
get_space_group
Show Space Group. Reads community data.
circle-cli get-space-group --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Space Group ID minimum: |
update_space_group
Update Space Group. Changes community state and requires confirm=true for the user-requested action.
circle-cli update-space-group --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Space Group ID minimum: |
| string | No | Name (body input). |
| string | No | Slug (body input). |
| boolean | No | Is hidden from non members (body input). |
| boolean | No | Hide members count (body input). |
| boolean | No | Allow members to create spaces (body input). |
| boolean | No | Automatically add members to new spaces (body input). |
| boolean | No | Add members to space group on space join (body input). |
| boolean | No | Hide non member spaces from sidebar (body input). |
| array | No | Array of community member ids to add as moderators Array items: integer. |
add_space_member
Add Space Member. Changes community state and requires confirm=true for the user-requested action.
circle-cli add-space-member --helpArgument | Type | Required | Meaning and constraints |
| string | Body | Email (body input). |
| integer | Body | Space id (body input). |
remove_space_member
Remove Space Member. Changes community state and requires confirm=true for the user-requested action.
circle-cli remove-space-member --helpArgument | Type | Required | Meaning and constraints |
| string | Yes | |
| integer | Yes | Space ID |
list_space_members
List Space Members. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli list-space-members --helpArgument | Type | Required | Meaning and constraints |
| integer | No | Page number minimum: |
| integer | No | Number of records per page minimum: |
| integer | Yes | Space ID |
| string | No | Space member status. By default, it returns all members. Values: |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
get_space_member
Show Space Member. Reads community data.
circle-cli get-space-member --helpArgument | Type | Required | Meaning and constraints |
| string | Yes | |
| integer | Yes | Space ID |
get_space_ai_summaries
Summarize a space. Reads community data.
circle-cli get-space-ai-summaries --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Space ID minimum: |
| string | No | Filters messages created after the provided ISO8601 timestamp format: |
| integer | No | First unread message ID to include additional chat context |
create_space
Create Space. Changes community state and requires confirm=true for the user-requested action.
circle-cli create-space --helpArgument | Type | Required | Meaning and constraints |
| string | Body | Name (body input). |
| string | Body | Slug (body input). |
| string | No | signed_id of the cover image |
| boolean | No | Cover image visible (body input). |
| string | No | Cover image display style (body input). Values: |
| boolean | No | Is private (body input). |
| boolean | No | Is hidden from non members (body input). |
| boolean | No | Is hidden (body input). |
| string | No | Locked button url (body input). |
| string | No | Locked button label (body input). |
| string | No | Locked page heading (body input). |
| string | No | Locked page description (body input). |
| boolean | No | Is post disabled (body input). |
| string | No | Default sort (body input). |
| boolean | No | Hide sorting (body input). |
| integer | Body | Space group id (body input). |
| array | No | Topics (body input). Array items: integer. |
| object | No | Custom emoji (body input). |
| string | No | Space type (body input). Values: |
| boolean | No | Only for event spaces |
| string | No | Members will see an in-app notification when new events are posted Values: |
| string | No | Members will see a mobile notification when new events are posted Values: |
| string | No | Members will receive an email notification when new events are posted Values: |
| object | No | Course space configuration |
| string | No | signed_id of the thumbnail image for event spaces |
| string | No | Members will see an in-app notification when mentioned Values: |
| string | No | Members will see a mobile notification when mentioned Values: |
| boolean | No | Hide space from sidebar navigation |
| boolean | No | Hide right sidebar in space |
| boolean | No | Require topic selection when posting |
| string | No | Default display view for the space Values: |
| boolean | No | Prevent members from adding other members to the space |
| boolean | No | Hide space from featured areas |
| boolean | No | Disable cover images on member posts |
| boolean | No | Hide the member count display |
| string | No | Custom label for pinned posts |
| boolean | No | Show lock icon for non-members |
| boolean | No | Hide post settings |
| string | No | Default sort order for comments Values: |
| string | No | Default sort order for members Values: |
| string | No | Simple emoji string for the space |
| string | No | Default tab to show when entering the space |
| boolean | No | Show the tab bar navigation |
| boolean | No | Show next event information for event spaces |
| object | No | Visible tabs configuration for the space |
| object | No | SEO meta tag attributes |
list_spaces
List Spaces. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli list-spaces --helpArgument | Type | Required | Meaning and constraints |
| integer | No | Page number minimum: |
| integer | No | Number of records per page minimum: |
| string | No | Sort by Values: |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
delete_space
Delete a space. Changes community state and requires confirm=true for the user-requested action.
circle-cli delete-space --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Space ID minimum: |
get_space
Show a space. Reads community data.
circle-cli get-space --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Space ID minimum: |
update_space
Update Space. Changes community state and requires confirm=true for the user-requested action.
circle-cli update-space --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Space ID minimum: |
| string | No | Name (body input). |
| string | No | signed_id of the cover image |
| boolean | No | Cover image visible (body input). |
| string | No | Cover image display style (body input). Values: |
| boolean | No | Is private (body input). |
| boolean | No | Is hidden from non members (body input). |
| boolean | No | Only valid for course spaces; set to false to publish a course |
| boolean | No | Is hidden (body input). |
| string | No | Locked button url (body input). |
| string | No | Locked button label (body input). |
| string | No | Locked page heading (body input). |
| string | No | Locked page description (body input). |
| boolean | No | Is post disabled (body input). |
| string | No | Default sort (body input). |
| boolean | No | Hide sorting (body input). |
| integer | No | Space group id (body input). |
| array | No | Topics (body input). Array items: integer. |
| object | No | Custom emoji (body input). |
| boolean | No | Only for event spaces |
| string | No | Members will see an in-app notification when new events are posted Values: |
| string | No | Members will see a mobile notification when new events are posted Values: |
| string | No | Members will receive an email notification when new events are posted Values: |
| object | No | Course space configuration |
| string | No | signed_id of the thumbnail image for event spaces |
| string | No | Members will see an in-app notification when mentioned Values: |
| string | No | Members will see a mobile notification when mentioned Values: |
| boolean | No | Hide space from sidebar navigation |
| boolean | No | Hide right sidebar in space |
| boolean | No | Require topic selection when posting |
| string | No | Default display view for the space Values: |
| boolean | No | Prevent members from adding other members to the space |
| boolean | No | Hide space from featured areas |
| boolean | No | Disable cover images on member posts |
| boolean | No | Hide the member count display |
| string | No | Custom label for pinned posts |
| boolean | No | Show lock icon for non-members |
| boolean | No | Hide post settings |
| string | No | Default sort order for comments Values: |
| string | No | Default sort order for members Values: |
| string | No | Simple emoji string for the space |
| string | No | Default tab to show when entering the space |
| boolean | No | Show the tab bar navigation |
| boolean | No | Show next event information for event spaces |
| object | No | Visible tabs configuration for the space |
| object | No | SEO meta tag attributes |
| boolean | No | Show chat history to new members in chat spaces |
| string | No | Description for the chat room in chat spaces |
tag_member
Create Tagged Member. Changes community state and requires confirm=true for the user-requested action.
circle-cli tag-member --helpArgument | Type | Required | Meaning and constraints |
| integer | Body | Member tag id (body input). |
| string | Body | User email (body input). |
untag_member
Delete Tagged Member. Changes community state and requires confirm=true for the user-requested action.
circle-cli untag-member --helpArgument | Type | Required | Meaning and constraints |
| string | Yes | User Email |
| integer | Yes | Member Tag ID |
list_tagged_members
List Tagged Members. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli list-tagged-members --helpArgument | Type | Required | Meaning and constraints |
| integer | No | Page number minimum: |
| integer | No | Number of records per page minimum: |
| array | No | Filter by Member Tag IDs (OR logic, comma-separated) Array items: integer. |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
get_tagged_member
Get Tagged Member. Reads community data.
circle-cli get-tagged-member --helpArgument | Type | Required | Meaning and constraints |
| string | Yes | Tagged Member ID |
get_tax_settings
Get tax settings. Reads community data.
circle-cli get-tax-settings --helpArgument | Type | Required | Meaning and constraints |
None | Not applicable | No | Shared account/confirmation controls only. |
update_tax_settings
Update tax settings. Changes community state and requires confirm=true for the user-requested action.
circle-cli update-tax-settings --helpArgument | Type | Required | Meaning and constraints |
| object | No | Tax setting (body input). |
create_topic
Create a topic. Changes community state and requires confirm=true for the user-requested action.
circle-cli create-topic --helpArgument | Type | Required | Meaning and constraints |
| string | No | Name (body input). |
| boolean | No | Toggles if only admins and moderators can select this topic |
| array | No | Array of space IDs to be assigned to the topic Array items: integer. |
list_topics
List topics. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli list-topics --helpArgument | Type | Required | Meaning and constraints |
| integer | No | Page number minimum: |
| integer | No | Number of records per page minimum: |
| string | No | query by name |
| string | No | Sorting parameters (sort by name in ascending order, name in descending order, and by newest. Default is oldest) Values: |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
delete_topic
Delete a topic. Changes community state and requires confirm=true for the user-requested action.
circle-cli delete-topic --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Topic ID minimum: |
get_topic
Show topic details. Reads community data.
circle-cli get-topic --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Topic ID minimum: |
update_topic
Update a topic. Changes community state and requires confirm=true for the user-requested action.
circle-cli update-topic --helpArgument | Type | Required | Meaning and constraints |
| integer | Yes | Topic ID minimum: |
| string | No | Name (body input). |
| boolean | No | Toggles if only admins and moderators can select this topic |
| array | No | Array of space IDs to be assigned to the topic Array items: integer. |
activate_workflow
Activate an automation (dynamic) workflow so it starts running automatically. Changes community state and requires confirm=true for the user-requested action.
circle-cli activate-workflow --helpArgument | Type | Required | Meaning and constraints |
| string | Yes | UUID of the workflow to activate format: |
deactivate_workflow
Deactivate an automation (dynamic) workflow so it stops running automatically. Changes community state and requires confirm=true for the user-requested action.
circle-cli deactivate-workflow --helpArgument | Type | Required | Meaning and constraints |
| string | Yes | UUID of the workflow to deactivate format: |
duplicate_workflow
Duplicate a workflow. Changes community state and requires confirm=true for the user-requested action.
circle-cli duplicate-workflow --helpArgument | Type | Required | Meaning and constraints |
| string | Yes | UUID of the workflow to duplicate |
list_workflows
List a community's automations/workflows. Reads community data. Supports bounded all_pages; every page counts against the API quota.
circle-cli list-workflows --helpArgument | Type | Required | Meaning and constraints |
| string | No | Filter by workflow name (substring match). |
| string | No | Filter by status. Omit to include archived; use |
| string | No | Filter by type: dynamic (Automation), bulk_action (Bulk action), scheduled (Scheduled). Values: |
| integer | No | Page number (min 1) minimum: |
| integer | No | Records per page (max 100) minimum: |
| boolean | No | Bounded page retrieval; each page consumes quota. |
| integer | No | Max items (control input). minimum: |
get_workflow
Get Workflow. Reads community data.
circle-cli get-workflow --helpArgument | Type | Required | Meaning and constraints |
| string | Yes | UUID of the workflow format: |
list_accounts
Lists configured account labels, default choice and auth method without tokens, paths or network calls. No arguments.
9. Community workflows
Draft, inspect, then publish only when requested
Discover the intended basic space first. A basic post requires space_id and name; content uses tiptap_body and a nested Tiptap document rather than an invented plain body field. These illustrative IDs must be replaced with real discovered IDs:
circle-cli list-spaces --per-page 5 --agent
circle-cli create-post --space-id 7 --name "Community notes" --tiptap-body '{"body":{"type":"doc","content":[{"type":"paragraph","content":[{"type":"text","text":"Your actual post content."}]}]}}' --confirm --agent
circle-cli get-post --post-id 19 --agentThe wrapper defaults basic/image post creation to draft. Read that same post ID and inspect it in Circle. A later publishing/scheduling update needs the user's specific request and explicit status/confirmation. Review skip_notifications, timestamps and audience carefully. Do not overwrite a branded or complex document with a sample paragraph. See Tiptap concepts and rich text.
Members, invitations and messages
Search/read the intended member before access changes. create_member invites a member unless the supplied supported fields change that behavior; skip_invitation can suppress an invitation. Use documented member IDs, emails, access-group IDs and tags, not a user's password in a model prompt. remove_member deactivates a membership; delete_community_member is a distinct deletion operation. Read schemas before choosing one.
send_message uses rich_text_body and exactly one recipient route (user_email, user_emails or chat_room_uuid) per the pinned body union. Publishing, comments, messages, invitations, event reminders and workflow activation can contact people. Guard confirmation does not establish consent or successful delivery. Only perform the requested operation.
Events, courses and workflows
Events use a nested event object with event settings, location and reminder options, plus the operation's space input. Courses use current section/lesson IDs and documented bodies; progress updates have their own fields. Workflows use UUIDs, not the numeric IDs used by many other endpoints. Read and inspect the current workflow before confirmed activation. Deactivation, duplication and billing/subscription actions have different effects; tool availability never substitutes for the intended task.
10. Pagination, exports and uploads
Bounded pages
The 33 reviewed paginated reads use native page and per_page; no cursor is invented. all_pages starts at the requested page or page 1, keeps page size fixed, stops at max_items (default 1,000, maximum 10,000) or 100 requests, and refuses empty/repeated continuing pages. The local per_page cap is 100. Responses retain the provider's records/metadata and add collected/pages/truncated/resume.
circle-cli list-members --per-page 25 --agent
circle-cli list-members --all-pages --max-items 500 --per-page 25 --agentWhen a cap cuts through a page, resume contains that page, the fixed per_page and the count to skip after retrieving it again. When a full page is consumed, resume points to the next page with skip 0. Preserve the same query/filter/sort and do not change page size: doing so changes offset boundaries. This is not a consistent snapshot; concurrent community changes can shift records. The helper returns continuation state but does not offer an invented --skip API argument. One bounded result is not a complete backup guarantee.
Exports and quota
Export tools are confirmed writes that may enqueue jobs or return download links; acceptance is not proof of completion. Preserve returned IDs/status and follow the documented account workflow. Keep membership/billing data and download URLs private. Every page/retry consumes allowance; a long Retry-After is surfaced instead of shortened into an early retry.
File metadata and direct uploads
create_direct_upload creates the documented upload metadata/slot using blob key, filename, MIME type, byte_size and a Base64 MD5 checksum. It does not read a local file or complete the storage PUT for you. Follow the upload protocol: create metadata, upload the exact intended file to the returned signed storage URL with its returned headers, then use the returned signed_id where the content schema accepts it. The provider concept page illustrates Member API; this package uses the pinned Admin v2 direct_uploads route.
Never send the Admin token to the storage URL, expose private signed URLs in public output, or treat a slot as a completed upload. Embeds/SGIDs, basic-post covers, image galleries, lesson media and member avatars use different schema fields. This package does not host an uploader or webhook receiver; no incomplete file workflow is advertised as automatic.
11. Several private accounts
Use private CIRCLE_ACCOUNTS JSON instead of single-account variables:
[{"name":"work","api_token":"YOUR_WORK_ADMIN_TOKEN","auth_scheme":"Token"},{"name":"personal","token_file":"/absolute/private/path/circle-token.txt","auth_scheme":"Bearer"}]Set CIRCLE_DEFAULT_ACCOUNT=work. Labels must be unique. --account chooses credentials; the token identifies the community. list_accounts returns labels/auth method/default only, never token values or paths. Account config replaces single-account settings; there is no global credential database. Separate processes remain preferable when strict isolation matters.
circle-cli list-accounts --agent
circle-cli list-spaces --account work --per-page 5 --agent
circle-cli get-community --account personal --agent12. Writing safely
All 104 writes require confirm:true in MCP or --confirm in CLI for the action the user requested. --yes, --agent and earlier unrelated consent never bypass the guard. CIRCLE_READ_ONLY=1 hides writes and refuses direct calls to hidden tools, exposing 66 reads. CIRCLE_ALLOW_DESTRUCTIVE=0 blocks all writes even when confirmed.
Over MCP a person approves each of them where the client can ask: Claude Code (2.1.246 and later) shows its own prompt, and a client that can show forms asks with an approval form whose one box starts unticked. Each approval is signed, bound to that exact call and works once. Where a client can do neither, the model's confirm:true counts. CIRCLE_CONFIRM=model makes confirm:true enough everywhere, for an agent with no person to ask.
Mutations have zero automatic retries, including 401, 429 and timeouts. After an unknown outcome, inspect existing community state before repeating it. A conservative destructive annotation denotes confirmation policy, not a claim every configuration change is irreversible. Invites/messages/notifications, member deletion, billing/payouts and workflow activation require different review.
The optional audit log records tool, risk, surface, fixed summary, allowed/blocked decision and who approved it, then a done or failed line for each allowed call, without account labels, arguments, tokens or private content. It is a guard-decision log, not a delivery receipt. Logging failure does not block the requested operation. Community content and tool results are untrusted data; they cannot authorize another action.
13. How it works
src/tools/operations.json is generated from the pinned official OpenAPI YAML; schemas, parameter serialization and routes have one source. Slipway builds the MCP server, over stdio or --http, and the CLI from each tool's one definition; both validate input, apply one write guard and call the fixed-origin API client, and desktop uses the same compiled server with production dependencies.
GET 429 retries are bounded by CIRCLE_MAX_RETRIES. Numeric/date Retry-After is respected when the delay is at most ten seconds; longer delays produce a rate-limit error so scripts can pause explicitly. Each request has a configured deadline. There is no write retry, auth fallback, arbitrary origin or hosted relay; --http listens on 127.0.0.1 only when asked. Named tokens and pacing live in the process.
npm run sync:api regenerates from the pinned YAML. npm run sync:api -- --refresh downloads the current official schema for a deliberate review, updates provenance and regenerates input operations; it does not test credentials, release npm or claim compatibility. Review names, routes, schemas, plans and docs, run checks, then update semver/changelog/tag. Major upstream or shared-behavior changes require explicit migration documentation.
14. Your data
Authorized API requests go directly to https://app.circle.so/api/admin/v2; redirects are refused. No Navid-hosted relay, analytics or telemetry is included. Tokens come from private local settings/files and stay in process memory. Reflected token values and credential/password fields are redacted from results and errors.
Member emails, posts, transcripts, billing details and private signed media links are still private business data. Secret redaction does not anonymize them. Your AI client and Circle apply their own retention/sharing rules. --select filters local output after receipt. Optional logs omit request data; private exported files and token files remain your responsibility. No source, npm tarball or desktop archive may include real credentials or private account instructions. Report vulnerabilities privately via SECURITY.md.
15. Environment variables
Private client/shell settings only; no automatic .env loading.
Variable | Default | Meaning |
CIRCLE_API_TOKEN | Empty | Private Admin V2 token |
CIRCLE_TOKEN_FILE | Empty | Regular token-only file up to 64 KB; takes precedence |
CIRCLE_AUTH_SCHEME | Token | Explicit Token/Bearer scheme; no fallback |
CIRCLE_ACCOUNTS | Empty | Private named credential array; replaces single account |
CIRCLE_DEFAULT_ACCOUNT | First configured label | Default local account |
CIRCLE_READ_ONLY | 0 | Hide/refuse all writes |
CIRCLE_ALLOW_DESTRUCTIVE | 1 | 0 blocks all writes |
CIRCLE_AUDIT_LOG | None | Private guard-decision log |
CIRCLE_REQUEST_TIMEOUT_MS | 30000 | Integer request deadline, 100–300000 ms |
CIRCLE_MAX_RETRIES | 2 | GET 429 retries, 0–5 |
CIRCLE_MIN_REQUEST_INTERVAL_MS | 200 | Per-account/process pacing, 0–10000 ms |
CIRCLE_CONFIRM | human |
|
CIRCLE_SURFACE | full |
|
CIRCLE_TOOL_TIMEOUT_MS | None | Give up on any tool after this long |
CIRCLE_HTTP_PORT, CIRCLE_HTTP_HOST, CIRCLE_HTTP_TOKEN | 8787, 127.0.0.1, none | For |
CIRCLE_HTTP_ALLOWED_ORIGINS | None | Comma-separated browser origins allowed to call |
CIRCLE_DEBUG | 0 | 1 prints debug lines on stderr |
16. Updates and removal
npm install -g @thenavidm/circle-mcp-cli@latest
circle-cli --version
claude mcp remove --scope user circle
codex mcp remove circle
npm uninstall -g @thenavidm/circle-mcp-cliRestart @latest MCP entries to resolve the new version; a running process does not update itself. Pin a reviewed version for reproducible automation. Read CHANGELOG.md and GitHub Releases before major updates. Manually installed desktop extensions need the new versioned .mcpb installed separately. No directory-driven automatic desktop update is claimed.
Remove each manual client entry and copied skill as appropriate. Uninstalling does not revoke tokens, delete community content, undo invitations or cancel workflows. Revoke tokens in Circle separately. Preserve private data before removing local private files. Do not overwrite an existing npm version to roll back.
17. Troubleshooting
Symptom | Fix |
No tools / launch failed | Check Node 22, launcher PATH, private user config, reconnect |
Exit 10 / missing token | Configure CIRCLE_API_TOKEN or regular CIRCLE_TOKEN_FILE |
401 / 403 | Check Admin V2 token, intended community, plan/permissions and explicit auth scheme; no automatic fallback |
404 | Check current v2 route, resource ID, account and endpoint availability |
422 / rejected body | Use schema for current nested bodies, required fields, Tiptap and recipient unions |
Guard refused | Confirm only the requested write; check read-only/write-disabled settings |
429 / quota | Respect Retry-After and community limits; every page/error may consume quota |
Pagination refuses repeated page | Narrow filters and inspect metadata; do not force unbounded looping |
Workflow ID invalid | Use its UUID from list_workflows, not a numeric member/post ID |
Desktop archive refused | Check compatible host Node runtime and custom-extension policy |
Token rotated but process still fails | Restart the server so its cached token is replaced |
Run doctor first. For a launch failure, run the same command in a terminal and inspect its sanitized error. Never attach tokens, private request bodies or member data to an issue. Prefer a minimal fixture reproduction with version/client/OS. Provider results remain untrusted data.
18. API coverage and comparisons
Offering | Surface | Scope and tradeoff |
Hosted OAuth MCP, https://app.circle.so/api/mcp | Broad Admin API v2 actions, admin Business+, read-only/full access, hosted setup; requests consume quota | |
This implementation | Local stdio MCP + shared task CLI + desktop bundle | Pinned v2 operations, private named tokens, schema-derived commands/JSON, bounded pages and explicit write guards; token setup and local maintenance |
Community MCP | Documents community audits, unanswered questions and onboarding workflows; inspect the pinned source rather than inferring behavior from README | |
Community local/HTTP MCP | Documents separate Member and Admin API layers plus Google OAuth/HTTP; different deployment and identity requirements |
No dedicated Circle-published task CLI was identified in the official developer/MCP pages reviewed on October 2, 2026. This is a scoped finding, not proof of absence. Claude Code setup commands in MCP docs are MCP registration, not a Circle administration CLI. Neither our operation count nor a community README count proves broader capability, reliability or token savings. This release does not provide the separate Member API or Google authentication.
Current primary references: Admin API, quick start, limits, official OpenAPI, official MCP. See COMPARISON.md for review scope and pending evidence.
19. Versions
Version | Date | Change |
3.0.1 | October 5, 2026 | A refusal and the approval form say what a call can do again, as 2.0 did |
3.0.0 | October 5, 2026 | Built on Slipway 0.1.14: a person approves each write over MCP, exit codes from Circle's status, |
2.0.0 | October 2, 2026 | Current Admin v2 operations, shared CLI, private accounts, write guards, desktop bundle and complete reference |
1.0.0 | Legacy source | MCP-only implementation, 62 declared tools, mixed v1/v2 and manually assembled routes |
The OpenAPI document calls its info version v1 while the routes are Admin v2. Provenance records both; do not rename the API based on that info field. Original upstream SHA-256: 9bdd6e72611fe2af43e308ffadb9e9a64b0aa5d5763004839ac3b70de335f5a0. The public pinned snapshot replaces one credential-like upload-key example; its SHA-256 is 3e6478f0ac859789a70b8356ac0c91901de99134f637832809497d555e897241. Examples are excluded from generated validation.
Many documented legacy names remain where current operations exist. Arguments and routes need migration: posts use /posts with space_id input, comments use /comments with post_id input, memberships and attendees use current top-level resources, and workflows require UUIDs. Unsupported v1-only like/unlike helpers are omitted. CIRCLE_COMMUNITY_ID is no longer used. Legacy HTML/body shortcuts are not silently converted to Tiptap. See CHANGELOG.md for the exact legacy-name migration table. Preserve the existing AGPL license.
Build/typecheck, 36 tests and real local discovery are verified. These checks cover every write guard, nested body validation, pagination, auth header shape, retry policy, secret redaction and actual CLI exit codes. Public release/artifact/CI evidence is recorded after publication. Live provider outcomes and desktop GUI installation remain unverified; section 7 has the measured token costs.
20. FAQ
It exposes structured operations to an AI client. This package runs locally over stdio and connects directly to Circle.
circle-cli runs the same tools as shell commands through the shared MCP implementation. Scripts and shell agents can use it.
Yes. Its hosted OAuth MCP at https://app.circle.so/api/mcp provides broad Admin API v2 access for admins on eligible Business+ plans.
It adds a local task CLI, named private token settings, predictable JSON, schema-derived help and bounded page retrieval. No overall coverage or efficiency advantage is claimed.
No dedicated task CLI was found in the official developer/MCP pages reviewed on October 2, 2026. MCP setup through Claude Code is not a Circle task CLI; recheck current provider docs before making an absence claim.
The wrapper preserves AGPL-3.0-or-later. Circle plan access and API allowances remain separate. Installing npm does not upgrade a plan.
Open Settings > Developers > Tokens in the intended community as an admin. Create an Admin V2 token and save it privately.
No. Use private local shell/client settings or an owner-only regular token file outside repositories. Never put it in issues, chats or shared configs.
The pinned schema says Token; quick-start prose says Bearer. Token is the default, and an explicit private auth scheme setting supports Bearer. There is no automatic fallback or write resubmission; live-account validation remains pending.
No. It prints private token setup instructions without opening a browser or storing a credential. Official hosted MCP OAuth is a separate route.
The versioned .mcpb bundles production dependencies and uses a sensitive token setting or private token-file path. Host compatibility and organization custom-extension policy apply; GUI installation is separately unverified.
This package needs local stdio. A remote-URL-only client needs Circle’s official hosted MCP instead, subject to current client support.
Create basic/image post defaults to draft. Publishing or scheduling needs the specific requested status/update and confirmation. Inspect the same post before changing delivery or notification options.
The current operations support those requests, with explicit confirmation and valid account permissions. Read recipient/body schemas and review notification behavior; tool availability is not consent or proof of delivery.
No. Mutating requests have zero automatic retries or auth fallback. Inspect state after unknown outcomes before repeating any action.
all_pages is available only on the 33 native page/per_page reads, bounded by max_items and 100 requests. Every page consumes quota; continuation state does not guarantee a consistent snapshot.
The cap stopped partway through a page. Retrieve that same page with the same per_page/filter/sort and skip that many already-returned records locally. There is no invented skip API argument.
Use named private credentials and --account. The selected token identifies its community. list_accounts returns labels and auth method without tokens or paths.
No. It creates the metadata/slot. Complete the documented storage PUT for the exact intended file, then use its signed_id; never forward the Admin token to storage.
It depends on the client and the task. In Claude Code the CLI costs nothing until it is used, plus about 940 tokens for SKILL.md once, where the server costs about 2,500 tokens a message with tool search and 84,400 with every tool loaded. In Codex, finding the command that refunds a member's charge took a median of 82,915 input tokens over the CLI and 77,488 over MCP. Section 7 has how each was measured.
Questions
Open a sanitized issue with version/client/OS. Use SECURITY.md for private disclosure.
About the author
Navid Moazzez is a leading AI business strategist, and the host of the AI Creator Summit, watched by 100,000+ creators. He helps creators and founders master AI and build their own AI Operating System (AI OS) to automate their business and life. He creates useful free tools, MCP servers and CLIs that creators and founders can use in their own workflows.
Links
Personal website: navid.me
Link in bio: navid.bio
Navid Media: navid.media
YouTube: @thenavidm and @thenavidai
X: @thenavidm
Instagram: @thenavidm
LinkedIn: thenavidm
Dependencies
Dependency | Version range | Used for |
| The MCP server and the CLI from one definition of each tool, with the MCP TypeScript SDK | |
|
| JSON Schema input validation |
|
| JSON Schema input validation |
Full third-party attribution is in THIRD_PARTY_NOTICES.md. Development tooling and its audit limitations are documented in SECURITY.md.
yaml is development-only API regeneration tooling. It is excluded from production bundles.
License
AGPL-3.0-or-later, preserving the existing license. See LICENSE, full AGPL text and THIRD_PARTY_NOTICES.md. Circle service/documentation terms remain separate.
© 2026 Navid Media. Made with ❤️ by Navid Moazzez.
Available Tools
170 toolsactivate_workflowActivate an automation (dynamic) workflow so it starts running automaticallyADestructive
Activate an automation (dynamic) workflow so it starts running automatically. Changes community state and requires confirm=true for the user-requested action.
Inputs: id (required), account, confirm.
add_space_memberAdd Space MemberCDestructive
Add Space Member. Changes community state and requires confirm=true for the user-requested action.
Inputs: email, account, confirm, payload, +2 more.
add_to_access_groupAdd Member to Access GroupADestructive
Add Member to Access Group. Changes community state and requires confirm=true for the user-requested action.
Inputs: access_group_id (required), email, account, confirm, +2 more.
archive_access_groupArchive Access GroupBDestructive
Archive Access Group. Changes community state and requires confirm=true for the user-requested action.
Inputs: access_group_id (required), account, confirm.
archive_paywallArchives a paywallADestructive
Archives a paywall. Changes community state and requires confirm=true for the user-requested action.
Inputs: paywall_id (required), account, confirm.
archive_profile_fieldArchive Profile FieldCDestructive
Archive Profile Field. Changes community state and requires confirm=true for the user-requested action.
Inputs: profile_field_id (required), account, confirm.
ban_community_memberBan Community MemberCDestructive
Ban Community Member. Changes community state and requires confirm=true for the user-requested action.
Inputs: member_id (required), account, confirm.
cancel_community_member_subscriptionCancel Community Member SubscriptionBDestructive
Cancel Community Member Subscription. Changes community state and requires confirm=true for the user-requested action.
Inputs: subscription_id (required), account, confirm, ends_at, +3 more.
create_access_groupCreate Access GroupBDestructive
Create Access Group. Changes community state and requires confirm=true for the user-requested action.
Inputs: account, confirm, payload, access_group, +1 more.
create_commentCreate CommentCDestructive
Create Comment. Changes community state and requires confirm=true for the user-requested action.
Inputs: body, account, confirm, payload, +6 more.
create_community_segmentCreate a community segmentCDestructive
Create a community segment. Changes community state and requires confirm=true for the user-requested action.
Inputs: rules, title, account, confirm, +4 more.
create_contact_noteCreate Contact NoteADestructive
Create Contact Note. Changes community state and requires confirm=true for the user-requested action.
Inputs: contact_id (required), account, confirm, payload, +2 more.
create_course_lessonCreate a course lessonCDestructive
Create a course lesson. Changes community state and requires confirm=true for the user-requested action.
Inputs: name, status, account, confirm, +10 more.
create_course_sectionCreate a course sectionBDestructive
Create a course section. Changes community state and requires confirm=true for the user-requested action.
Inputs: name, account, confirm, payload, +2 more.
create_direct_uploadCreate Direct UploadCDestructive
Create Direct Upload. Changes community state and requires confirm=true for the user-requested action.
Inputs: blob, account, confirm, payload, +1 more.
create_embedCreate EmbedCDestructive
Create Embed. Changes community state and requires confirm=true for the user-requested action.
Inputs: url, account, confirm, payload, +1 more.
create_eventCreate EventCDestructive
Create Event. Changes community state and requires confirm=true for the user-requested action.
Inputs: event, account, confirm, payload, +2 more.
create_event_attendeeCreate Event AttendeeCDestructive
Create Event Attendee. Changes community state and requires confirm=true for the user-requested action.
Inputs: account, confirm, payload, event_id, +2 more.
create_filter_controlCreate a member filter controlBDestructive
Create a member filter control. Changes community state and requires confirm=true for the user-requested action.
Inputs: key, account, confirm, enabled, +5 more.
create_form_submissionCreate a form submissionADestructive
Create a form submission. Changes community state and requires confirm=true for the user-requested action.
Inputs: form_id (required), account, confirm, payload, +3 more.
create_image_postCreate Image PostCDestructive
Create Image Post. Changes community state and requires confirm=true for the user-requested action.
Inputs: space_id (required), slug, status, topics, +11 more.
create_invitationCreate invitation linkADestructive
Create invitation link. Changes community state and requires confirm=true for the user-requested action.
Inputs: name, account, confirm, payload, +5 more.
create_leadCreate a non-member contact (lead). To add a full community member instead, use create_community_member.ADestructive
Create a non-member contact (lead). To add a full community member instead, use create_community_member.. Changes community state and requires confirm=true for the user-requested action.
Inputs: name, email, account, confirm, +3 more.
create_memberCreate/Invite a community memberBDestructive
Create/Invite a community member. Changes community state and requires confirm=true for the user-requested action.
Inputs: name, email, avatar, account, +12 more.
create_member_tagCreate Member TagCDestructive
Create Member Tag. Changes community state and requires confirm=true for the user-requested action.
Inputs: name, color, emoji, account, +8 more.
create_paywall_groupCreate Subscription GroupCDestructive
Create Subscription Group. Changes community state and requires confirm=true for the user-requested action.
Inputs: name, account, confirm, payload, +2 more.
create_postCreate Basic PostCDestructive
Create Basic Post. Changes community state and requires confirm=true for the user-requested action.
Inputs: name, slug, status, topics, +24 more.
create_profile_fieldCreate Profile FieldCDestructive
Create Profile Field. Changes community state and requires confirm=true for the user-requested action.
Inputs: account, confirm, payload, payload_file, +1 more.
create_spaceCreate SpaceCDestructive
Create Space. Changes community state and requires confirm=true for the user-requested action.
Inputs: name, slug, emoji, topics, +46 more.
create_space_groupCreate Space GroupBDestructive
Create Space Group. Changes community state and requires confirm=true for the user-requested action.
Inputs: name, slug, account, confirm, +8 more.
create_space_group_memberCreate Space Group MemberCDestructive
Create Space Group Member. Changes community state and requires confirm=true for the user-requested action.
Inputs: email, account, confirm, payload, +2 more.
create_topicCreate a topicBDestructive
Create a topic. Changes community state and requires confirm=true for the user-requested action.
Inputs: name, account, confirm, payload, +3 more.
deactivate_workflowDeactivate an automation (dynamic) workflow so it stops running automaticallyADestructive
Deactivate an automation (dynamic) workflow so it stops running automatically. Changes community state and requires confirm=true for the user-requested action.
Inputs: id (required), account, confirm.
delete_commentDestroy CommentCDestructive
Destroy Comment. Changes community state and requires confirm=true for the user-requested action.
Inputs: comment_id (required), account, confirm.
delete_community_memberDelete Community MemberBDestructive
Delete Community Member. Changes community state and requires confirm=true for the user-requested action.
Inputs: member_id (required), account, confirm.
delete_community_segmentDelete a community segmentADestructive
Delete a community segment. Changes community state and requires confirm=true for the user-requested action.
Inputs: segment_id (required), account, confirm.
delete_course_lessonDelete a course lessonADestructive
Delete a course lesson. Changes community state and requires confirm=true for the user-requested action.
Inputs: lesson_id (required), account, confirm.
delete_course_sectionDelete a course sectionADestructive
Delete a course section. Changes community state and requires confirm=true for the user-requested action.
Inputs: section_id (required), account, confirm.
delete_eventDelete EventBDestructive
Delete Event. Changes community state and requires confirm=true for the user-requested action.
Inputs: event_id (required), space_id (required), account, confirm.
delete_event_attendeeDelete Event AttendeeBDestructive
Delete Event Attendee. Changes community state and requires confirm=true for the user-requested action.
Inputs: account, confirm, payload, event_id, +2 more.
delete_filter_controlDelete a filter controlADestructive
Delete a filter control. Changes community state and requires confirm=true for the user-requested action.
Inputs: filter_control_id (required), account, confirm.
delete_formDelete a formADestructive
Delete a form. Changes community state and requires confirm=true for the user-requested action.
Inputs: form_id (required), account, confirm.
delete_image_postDelete Image PostADestructive
Delete Image Post. Changes community state and requires confirm=true for the user-requested action.
Inputs: post_id (required), space_id (required), account, confirm.
delete_invitation_linkDelete invitation linkBDestructive
Delete invitation link. Changes community state and requires confirm=true for the user-requested action.
Inputs: invitation_id (required), account, confirm.
delete_leadDelete a non-member contact (lead). To delete a full community member instead, use destroy_community_member.ADestructive
Delete a non-member contact (lead). To delete a full community member instead, use destroy_community_member.. Changes community state and requires confirm=true for the user-requested action.
Inputs: lead_id (required), account, confirm.
delete_member_tagDeletes a member tagADestructive
Deletes a member tag. Changes community state and requires confirm=true for the user-requested action.
Inputs: tag_id (required), account, confirm.
delete_paywallDeletes a paywallBDestructive
Deletes a paywall. Changes community state and requires confirm=true for the user-requested action.
Inputs: paywall_id (required), account, confirm.
delete_paywall_couponDeletes a paywall couponBDestructive
Deletes a paywall coupon. Changes community state and requires confirm=true for the user-requested action.
Inputs: id (required), account, confirm.
delete_postDelete Basic PostBDestructive
Delete Basic Post. Changes community state and requires confirm=true for the user-requested action.
Inputs: post_id (required), account, confirm.
delete_profile_fieldDelete Profile FieldADestructive
Delete Profile Field. Changes community state and requires confirm=true for the user-requested action.
Inputs: profile_field_id (required), account, confirm.
delete_spaceDelete a spaceADestructive
Delete a space. Changes community state and requires confirm=true for the user-requested action.
Inputs: space_id (required), account, confirm.
delete_space_groupDelete Space GroupBDestructive
Delete Space Group. Changes community state and requires confirm=true for the user-requested action.
Inputs: space_group_id (required), account, confirm.
delete_space_group_memberDestroy Space Group MemberCDestructive
Destroy Space Group Member. Changes community state and requires confirm=true for the user-requested action.
Inputs: email (required), space_group_id (required), account, confirm.
delete_topicDelete a topicBDestructive
Delete a topic. Changes community state and requires confirm=true for the user-requested action.
Inputs: topic_id (required), account, confirm.
duplicate_community_segmentDuplicate a community segmentBDestructive
Duplicate a community segment. Changes community state and requires confirm=true for the user-requested action.
Inputs: title (required), segment_id (required), account, confirm.
duplicate_eventDuplicate EventCDestructive
Duplicate Event. Changes community state and requires confirm=true for the user-requested action.
Inputs: event_id (required), space_id (required), event, account, +3 more.
duplicate_formDuplicate a formADestructive
Duplicate a form. Changes community state and requires confirm=true for the user-requested action.
Inputs: form_id (required), account, confirm.
duplicate_image_postDuplicate Image PostCDestructive
Duplicate Image Post. Changes community state and requires confirm=true for the user-requested action.
Inputs: post_id (required), space_id (required), post, account, +3 more.
duplicate_workflowDuplicate a workflowADestructive
Duplicate a workflow. Changes community state and requires confirm=true for the user-requested action.
Inputs: id (required), account, confirm.
export_community_member_chargesExport Community Member ChargesBDestructive
Export Community Member Charges. Changes community state and requires confirm=true for the user-requested action.
Inputs: fields, status, account, confirm, +16 more.
export_community_member_subscriptionsExport Community Member SubscriptionsBDestructive
Export Community Member Subscriptions. Changes community state and requires confirm=true for the user-requested action.
Inputs: fields, status, account, confirm, +16 more.
export_paywall_affiliate_payoutsExport Paywall Affiliate PayoutsCDestructive
Export Paywall Affiliate Payouts. Changes community state and requires confirm=true for the user-requested action.
Inputs: account, confirm, payload, payload_file, +1 more.
get_access_group_community_memberShow Access Group Community MemberCRead-onlyIdempotent
Show Access Group Community Member. Reads community data.
Inputs: email (required), access_group_id (required), account.
get_commentShow CommentCRead-onlyIdempotent
Show Comment. Reads community data.
Inputs: comment_id (required), account.
get_communityGet community detailsCRead-onlyIdempotent
Get community details. Reads community data.
Inputs: account.
get_connect_settingsGet Connect settingsCRead-onlyIdempotent
Get Connect settings. Reads community data.
Inputs: account.
get_course_lessonShow a course lessonBRead-onlyIdempotent
Show a course lesson. Reads community data.
Inputs: lesson_id (required), account.
get_course_sectionShow a course sectionCRead-onlyIdempotent
Show a course section. Reads community data.
Inputs: section_id (required), account.
get_embedGet EmbedCRead-onlyIdempotent
Get Embed. Reads community data.
Inputs: sgid (required), account.
get_eventGet EventCRead-onlyIdempotent
Get Event. Reads community data.
Inputs: event_id (required), account.
get_filter_configurationGet the filters currently shown on the member directory or a member spaceBRead-onlyIdempotent
Get the filters currently shown on the member directory or a member space. Reads community data.
Inputs: context (required), account, space_id.
get_filter_controlGet a filter controlBRead-onlyIdempotent
Get a filter control. Reads community data.
Inputs: filter_control_id (required), account.
get_formShow a formCRead-onlyIdempotent
Show a form. Reads community data.
Inputs: form_id (required), account.
get_form_submissionsList form submissionsBRead-onlyIdempotent
List form submissions. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: form_id (required), page, account, per_page, +2 more.
get_image_postShow Image PostCRead-onlyIdempotent
Show Image Post. Reads community data.
Inputs: post_id (required), space_id (required), account.
get_leaderboardShow LeaderboardCRead-onlyIdempotent
Show Leaderboard. Reads community data.
Inputs: period, account.
get_memberShow a community memberCRead-onlyIdempotent
Show a community member. Reads community data.
Inputs: member_id (required), account.
get_member_tagShows a member tag's detailsCRead-onlyIdempotent
Shows a member tag's details. Reads community data.
Inputs: tag_id (required), account.
get_payment_method_settingsRetrieves the community's payment method preferencesCRead-onlyIdempotent
Retrieves the community's payment method preferences. Reads community data.
Inputs: account.
get_postShow Basic PostCRead-onlyIdempotent
Show Basic Post. Reads community data.
Inputs: post_id (required), account.
get_post_summaryGet Post SummaryCRead-onlyIdempotent
Get Post Summary. Reads community data.
Inputs: post_id (required), account.
get_spaceShow a spaceCRead-onlyIdempotent
Show a space. Reads community data.
Inputs: space_id (required), account.
get_space_ai_summariesSummarize a spaceCRead-onlyIdempotent
Summarize a space. Reads community data.
Inputs: space_id (required), account, date_from, first_unread_message_id.
get_space_groupShow Space GroupCRead-onlyIdempotent
Show Space Group. Reads community data.
Inputs: space_group_id (required), account.
get_space_group_memberShow Space Group MemberCRead-onlyIdempotent
Show Space Group Member. Reads community data.
Inputs: email (required), space_group_id (required), account.
get_space_memberShow Space MemberCRead-onlyIdempotent
Show Space Member. Reads community data.
Inputs: email (required), space_id (required), account.
get_tagged_memberGet Tagged MemberCRead-onlyIdempotent
Get Tagged Member. Reads community data.
Inputs: tagged_member_id (required), account.
get_tax_settingsGet tax settingsCRead-onlyIdempotent
Get tax settings. Reads community data.
Inputs: account.
get_topicShow topic detailsCRead-onlyIdempotent
Show topic details. Reads community data.
Inputs: topic_id (required), account.
get_workflowGet WorkflowCRead-onlyIdempotent
Get Workflow. Reads community data.
Inputs: id (required), account.
import_chat_room_messageImport Chat Room MessageCDestructive
Import Chat Room Message. Changes community state and requires confirm=true for the user-requested action.
Inputs: account, confirm, payload, sent_at, +5 more.
invite_paywall_affiliatesInvite Paywall AffiliatesCDestructive
Invite Paywall Affiliates. Changes community state and requires confirm=true for the user-requested action.
Inputs: account, confirm, payload, payload_file, +1 more.
list_access_group_community_membersList Access Group Community MembersCRead-onlyIdempotent
List Access Group Community Members. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: access_group_id (required), page, account, per_page, +2 more.
list_access_groupsList Access GroupsBRead-onlyIdempotent
List Access Groups. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: ids, name, page, status, +4 more.
list_accountsList configured accountsARead-onlyIdempotent
List private account labels, default selection and configured token method. No credentials, token paths or community content; no network request.
Inputs: no named parameters.
list_chargesCommunity Member Charges ListCRead-onlyIdempotent
Community Member Charges List. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: page, sort, query, status, +20 more.
list_commentsList CommentsBRead-onlyIdempotent
List Comments. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: page, account, post_id, per_page, +4 more.
list_contact_notesList Contact NotesCRead-onlyIdempotent
List Contact Notes. Reads community data.
Inputs: contact_id (required), page, account.
list_course_lessonsList course lessonsBRead-onlyIdempotent
List course lessons. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: page, sort, status, account, +5 more.
list_course_sectionsList Course SectionsBRead-onlyIdempotent
List Course Sections. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: page, sort, account, per_page, +3 more.
list_event_attendeesList Event AttendeesBRead-onlyIdempotent
List Event Attendees. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: event_id (required), page, account, per_page, +2 more.
list_eventsList EventsCRead-onlyIdempotent
List Events. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: page, sort, account, per_page, +5 more.
list_filter_controlsList member directory and member space filter controlsBRead-onlyIdempotent
List member directory and member space filter controls. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: key, page, account, enabled, +6 more.
list_flagged_contentList Flagged ContentsBRead-onlyIdempotent
List Flagged Contents. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: page, status, account, per_page, +2 more.
list_formsList FormsARead-onlyIdempotent
List Forms. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: name, page, account, per_page, +2 more.
list_image_postsList Image PostsCRead-onlyIdempotent
List Image Posts. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: space_id (required), page, account, per_page, +2 more.
list_invitationsList Invitation LinksCRead-onlyIdempotent
List Invitation Links. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: name, page, status, account, +3 more.
list_live_roomsList Live RoomsCRead-onlyIdempotent
List Live Rooms. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: page, account, per_page, all_pages, +1 more.
list_live_room_transcriptsList Live Room TranscriptsCRead-onlyIdempotent
List Live Room Transcripts. Reads community data.
Inputs: room_id (required), account.
list_member_access_groupsList Community Member's Access GroupsBRead-onlyIdempotent
List Community Member's Access Groups. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: community_member_id (required), page, account, per_page, +2 more.
list_membersList Community MembersCRead-onlyIdempotent
List Community Members. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: page, status, account, per_page, +3 more.
list_member_spacesList Community Member SpacesCRead-onlyIdempotent
List Community Member Spaces. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: page, account, per_page, all_pages, +3 more.
list_member_tagsMember Tags ListCRead-onlyIdempotent
Member Tags List. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: name, page, sort, account, +4 more.
list_page_profile_fieldsGet Page Profile FieldsCRead-onlyIdempotent
Get Page Profile Fields. Reads community data.
Inputs: page_name (required), account.
list_paywall_affiliatesPaywall Affiliates ListCRead-onlyIdempotent
Paywall Affiliates List. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: page, account, filters, per_page, +2 more.
list_postsList Basic PostsBRead-onlyIdempotent
List Basic Posts. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: page, sort, status, account, +6 more.
list_profile_fieldsProfile Fields ListCRead-onlyIdempotent
Profile Fields List. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: page, label, account, archived, +3 more.
list_segmentsList Community SegmentsARead-onlyIdempotent
List Community Segments. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: page, title, account, per_page, +2 more.
list_space_group_membersList Space Group MembersCRead-onlyIdempotent
List Space Group Members. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: space_group_id (required), page, status, account, +3 more.
list_space_groupsList Space GroupsBRead-onlyIdempotent
List Space Groups. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: name, page, account, per_page, +2 more.
list_space_membersList Space MembersBRead-onlyIdempotent
List Space Members. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: space_id (required), page, status, account, +3 more.
list_spacesList SpacesCRead-onlyIdempotent
List Spaces. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: page, sort, account, per_page, +2 more.
list_subscriptionsCommunity Member Subscriptions ListBRead-onlyIdempotent
Community Member Subscriptions List. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: page, sort, query, status, +20 more.
list_tagged_membersList Tagged MembersCRead-onlyIdempotent
List Tagged Members. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: page, account, per_page, all_pages, +2 more.
list_topicsList topicsBRead-onlyIdempotent
List topics. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: name, page, sort, account, +3 more.
list_workflowsList a community's automations/workflowsARead-onlyIdempotent
List a community's automations/workflows. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: page, query, status, account, +4 more.
mark_paywall_affiliate_payouts_paidMark Paywall Affiliate Payouts PaidBDestructive
Mark Paywall Affiliate Payouts Paid. Changes community state and requires confirm=true for the user-requested action.
Inputs: account, confirm, payload, payload_file, +1 more.
publish_paywallPublishes a paywallADestructive
Publishes a paywall. Changes community state and requires confirm=true for the user-requested action.
Inputs: paywall_id (required), account, confirm.
refund_community_member_chargeRefund Community Member ChargeBDestructive
Refund Community Member Charge. Changes community state and requires confirm=true for the user-requested action.
Inputs: charge_id (required), amount, account, confirm, +3 more.
remove_from_access_groupRemove Access Group MemberBDestructive
Remove Access Group Member. Changes community state and requires confirm=true for the user-requested action.
Inputs: email (required), access_group_id (required), account, confirm.
remove_memberDeactivate a community memberBDestructive
Deactivate a community member. Changes community state and requires confirm=true for the user-requested action.
Inputs: member_id (required), account, confirm.
remove_space_memberRemove Space MemberCDestructive
Remove Space Member. Changes community state and requires confirm=true for the user-requested action.
Inputs: email (required), space_id (required), account, confirm.
reorder_course_lessonsReorder course lessonsBDestructive
Reorder course lessons. Changes community state and requires confirm=true for the user-requested action.
Inputs: account, confirm, payload, space_id, +2 more.
report_flagged_contentReport Flagged ContentCDestructive
Report Flagged Content. Changes community state and requires confirm=true for the user-requested action.
Inputs: account, confirm, payload, payload_file, +1 more.
resume_community_member_subscriptionResume Community Member SubscriptionBDestructive
Resume Community Member Subscription. Changes community state and requires confirm=true for the user-requested action.
Inputs: subscription_id (required), account, confirm.
revoke_invitation_linkRevoke invitation linkADestructive
Revoke invitation link. Changes community state and requires confirm=true for the user-requested action.
Inputs: invitation_id (required), account, confirm.
searchAdvanced SearchCRead-onlyIdempotent
Advanced Search. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: query (required), page, type, account, +5 more.
search_locationsSearch locationsCRead-onlyIdempotent
Search locations. Reads community data.
Inputs: query (required), account.
search_memberSearch a community memberCRead-onlyIdempotent
Search a community member. Reads community data.
Inputs: email (required), account.
search_paywallsSearch PaywallsCRead-onlyIdempotent
Search Paywalls. Reads community data. Supports bounded all_pages; every page counts against the API quota.
Inputs: name, page, sort, status, +10 more.
send_messageCreate MessageCDestructive
Create Message. Changes community state and requires confirm=true for the user-requested action.
Inputs: account, confirm, payload, user_email, +5 more.
start_paywall_affiliate_payoutsStart Paywall Affiliate PayoutsBDestructive
Start Paywall Affiliate Payouts. Changes community state and requires confirm=true for the user-requested action.
Inputs: account, confirm, payload, payload_file, +1 more.
tag_memberCreate Tagged MemberCDestructive
Create Tagged Member. Changes community state and requires confirm=true for the user-requested action.
Inputs: account, confirm, payload, user_email, +2 more.
unarchive_access_groupUnarchive Access GroupADestructive
Unarchive Access Group. Changes community state and requires confirm=true for the user-requested action.
Inputs: access_group_id (required), account, confirm.
unarchive_paywallUnarchives a paywallBDestructive
Unarchives a paywall. Changes community state and requires confirm=true for the user-requested action.
Inputs: paywall_id (required), account, confirm.
unarchive_profile_fieldUnarchive Profile FieldBDestructive
Unarchive Profile Field. Changes community state and requires confirm=true for the user-requested action.
Inputs: profile_field_id (required), account, confirm.
unfollow_postUnfollow a postADestructive
Unfollow a post. Changes community state and requires confirm=true for the user-requested action.
Inputs: post_id (required), community_member_id (required), account, confirm.
untag_memberDelete Tagged MemberBDestructive
Delete Tagged Member. Changes community state and requires confirm=true for the user-requested action.
Inputs: user_email (required), member_tag_id (required), account, confirm.
update_access_groupUpdate Access GroupCDestructive
Update Access Group. Changes community state and requires confirm=true for the user-requested action.
Inputs: access_group_id (required), account, confirm, payload, +2 more.
update_chat_preferencesUpdate Chat PreferencesCDestructive
Update Chat Preferences. Changes community state and requires confirm=true for the user-requested action.
Inputs: account, confirm, payload, payload_file, +4 more.
update_communityUpdate CommunityCDestructive
Update Community. Changes community state and requires confirm=true for the user-requested action.
Inputs: account, confirm, payload, community, +2 more.
update_community_segmentUpdate a community segmentCDestructive
Update a community segment. Changes community state and requires confirm=true for the user-requested action.
Inputs: segment_id (required), rules, title, account, +5 more.
update_connect_settingsUpdate Connect settingsBDestructive
Update Connect settings. Changes community state and requires confirm=true for the user-requested action.
Inputs: account, confirm, connect, payload, +3 more.
update_course_lessonUpdate a course lessonCDestructive
Update a course lesson. Changes community state and requires confirm=true for the user-requested action.
Inputs: lesson_id (required), name, status, account, +10 more.
update_course_progressUpdate Course Lesson ProgressCDestructive
Update Course Lesson Progress. Changes community state and requires confirm=true for the user-requested action.
Inputs: status, account, confirm, payload, +3 more.
update_course_sectionUpdate a course sectionBDestructive
Update a course section. Changes community state and requires confirm=true for the user-requested action.
Inputs: section_id (required), name, account, confirm, +2 more.
update_eventUpdate EventCDestructive
Update Event. Changes community state and requires confirm=true for the user-requested action.
Inputs: event_id (required), event, account, confirm, +3 more.
update_filter_controlUpdate a member directory or member space filter controlBDestructive
Update a member directory or member space filter control. Changes community state and requires confirm=true for the user-requested action.
Inputs: filter_control_id (required), key, account, confirm, +6 more.
update_formUpdate a formCDestructive
Update a form. Changes community state and requires confirm=true for the user-requested action.
Inputs: form_id (required), name, status, account, +13 more.
update_invitation_linkUpdate invitation linkCDestructive
Update invitation link. Changes community state and requires confirm=true for the user-requested action.
Inputs: invitation_id (required), name, account, confirm, +6 more.
update_memberUpdate a community memberBDestructive
Update a community member. Changes community state and requires confirm=true for the user-requested action.
Inputs: member_id (required), name, avatar, account, +11 more.
update_member_tagUpdate member tagCDestructive
Update member tag. Changes community state and requires confirm=true for the user-requested action.
Inputs: tag_id (required), name, color, emoji, +9 more.
update_paywall_affiliateUpdate Paywall AffiliateCDestructive
Update Paywall Affiliate. Changes community state and requires confirm=true for the user-requested action.
Inputs: affiliate_id (required), status, account, confirm, +2 more.
update_paywall_groupUpdate Subscription GroupBDestructive
Update Subscription Group. Changes community state and requires confirm=true for the user-requested action.
Inputs: paywall_group_id (required), name, account, confirm, +3 more.
update_postUpdate Basic PostCDestructive
Update Basic Post. Changes community state and requires confirm=true for the user-requested action.
Inputs: post_id (required), name, topics, account, +19 more.
update_profile_fieldUpdate Profile FieldCDestructive
Update Profile Field. Changes community state and requires confirm=true for the user-requested action.
Inputs: profile_field_id (required), account, confirm, payload, +2 more.
update_spaceUpdate SpaceCDestructive
Update Space. Changes community state and requires confirm=true for the user-requested action.
Inputs: space_id (required), name, emoji, topics, +48 more.
update_space_groupUpdate Space GroupCDestructive
Update Space Group. Changes community state and requires confirm=true for the user-requested action.
Inputs: space_group_id (required), name, slug, account, +10 more.
update_tax_settingsUpdate tax settingsBDestructive
Update tax settings. Changes community state and requires confirm=true for the user-requested action.
Inputs: account, confirm, payload, tax_setting, +1 more.
update_topicUpdate a topicBDestructive
Update a topic. Changes community state and requires confirm=true for the user-requested action.
Inputs: topic_id (required), name, account, confirm, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 170 tools
Many tools map to distinct resources, but the member-management surface is crowded with overlapping actions (create_member, create_lead, remove_member, delete_community_member, ban_community_member), and post tools (create_post, create_image_post, get_post, get_post_summary) require careful reading. With 170 tools, several boundaries are ambiguous enough that an agent could easily misselect.
The set overwhelmingly follows a predictable snake_case verb_noun pattern (list_*, get_*, create_*, update_*, delete_*). Minor deviations like send_message, add_space_member, remove_space_member, tag_member, and untag_member are still readable and resource-specific.
170 tools is an extreme mismatch for a coherent MCP surface, far beyond the recommended 3-15 range and even beyond the 50+ threshold that indicates poor scoping. The sheer volume overwhelms discovery and selection.
The domain is broad, but obvious lifecycle gaps exist: no create_workflow or update_workflow, no create_paywall, no update_image_post, and live rooms/transcripts are read-only. These missing operations would cause agent dead ends despite the large tool count.
Maintenance
Related MCP Connectors
Discover, inspect and run 63,000+ agent tools from one balance. Pay per call, no subscriptions.
Carbon Voice MCP serves as a bridge that connects AI assistants like ChatGPT, Claude, and Cursor to a user's Carbon Voice account, turning voice messages and conversations into a private, on-demand knowledge base. It provides 28 specialized tools for comprehensive voice messaging management, including creating and sending messages, accessing conversation history with instant transcription, running AI actions (summarization, TLDR generation, meeting notes), and managing workspace collaboration through folders, contacts, and team communications.
Exactly 50 data transformation and live web verification tools for AI agents.
Email inboxes, webhooks, mock APIs, 2FA codes, approvals and 170 tools for AI agents.
Related MCP Servers
- AlicenseBqualityDmaintenanceAI-powered management of FluentCommunity WordPress plugin content. Enables creating, updating, and managing community posts, spaces, comments, members, and chat through 26+ tools with bulk operations and advanced search capabilities.265MIT
- AlicenseBqualityBmaintenanceDiscord server management MCP for AI agents: chat, moderation, admin, and full server building. 160+ tools, confirmations the model cannot answer, undo. Formerly Omnicord.164563 npm12Apache 2.0
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Circle.so communities through Google OAuth 2.0, providing 20+ tools for comprehensive community management.21 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Intercom's customer communications platform via the Intercom REST API, providing 102 tools for managing admins, articles, companies, contacts, conversations, and more.2MIT