Operator Commons for Claude
Operator Commons is a network where people who run AI agents share how their agents are set up with people they trust. The connector lets Claude read and manage your playbooks (how your agent works) and setup snapshots (sanitized lists of your agent's configuration), ask trusted operators for their setups, compare them with yours, and review your inbox. Nothing is shared without your consent, and the server never installs anything on your machine.
Connect
The MCP endpoint (Streamable HTTP, OAuth sign-in):
https://operatorcommons.ai/api/mcp/messages
One-click install, if your client supports it:
Claude (claude.ai, desktop and mobile)
Use Add to Claude above, or open Claude's connector settings, choose to add a custom connector, name it Operator Commons and paste the endpoint. Claude then opens the Operator Commons sign-in.
Claude Code
Run this in your terminal, then restart Claude Code:
claude mcp add --transport http operator-commons https://operatorcommons.ai/api/mcp/messages
Cursor
Use Add to Cursor above, or add this to ~/.cursor/mcp.json. Cursor opens the sign-in itself.
{
"mcpServers": {
"operator-commons": {
"url": "https://operatorcommons.ai/api/mcp/messages"
}
}
}VS Code
Use Add to VS Code above, or add this to your mcp.json:
{
"servers": {
"operator-commons": {
"type": "http",
"url": "https://operatorcommons.ai/api/mcp/messages"
}
}
}Sign-in and permissions
Connecting sends you to an Operator Commons consent page (you sign in with Google, LinkedIn or an email link first if needed). It names the app asking for access and the address it returns to, and lists what it may do. One Allow click grants the permissions below. You can revoke them at any time (see Disconnect).
Build your playbook and kit
Create and edit your own playbooks, and publish sanitized snapshots of your setup.
- Read playbooks — your own and ones shared with you (list, open by id, compare). Read-only; never writes.
playbook:read - Create and edit your playbooks — whole playbooks, content sections, workflow recipes (add, replace, or remove), and metadata. Versioned and recoverable; never deletes (that needs the manage scope).
playbook:write - Publish, revise, import, and retract your own setup snapshots so trusted operators can discover them.
setup_snapshot:publish
Exchange setups with operators you trust
Ask for, read, and compare setups that trusted operators share with you — and cut off access you've granted.
- Ask a trusted operator's agent to share their setup, and approve, deny, counter, or endorse incoming requests.
setup_share:request - List the active grants you hold — the setups you currently have permission to read.
setup_share:grants:list - Revoke a grant you issued, immediately cutting off another agent's access to your setup.
setup_share:revoke - Read a trusted operator's sanitized setup summary (capabilities only, no secrets) once they've granted you access.
sanitized_setup_summary - Read the full item list of a setup snapshot you've been granted access to.
setup_snapshot:read - Compare a trusted operator's setup against your own to see what you're missing.
setup:compare
Grow your trust network
Send invites and recommendations, and see what your trusted operators are using.
- Send invites and friend offers on your behalf — mint invite codes that establish a trust edge when claimed, and send setup-share offers, recommendations, and asks to your trusted operators. Separate from setup-share request so an asking-only token can't build out your trust graph.
trust:invite - Read your own trust graph — your friends list, your trusted feed, and what your trusted operators are using that you could adopt.
trust:read
Stay on top of activity
Read your inbox and notifications.
- Read your own inbox and notifications — see what's been shared with or offered to you. This scope currently ALSO grants trust-graph reads (your friends list, trusted feed, and adoption attestations) for compatibility with tokens issued before the scopes were split; grant trust:read instead if those reads are all you need.
setup_share:status:read
These permissions are off by default. Each is an unchecked box on the consent page and is granted only if you tick it:
- Delete your playbooks. Destructive and irreversible — kept separate from write so an append-only token can't delete your library.
playbook:manage - Edit your public operator profile (display name and bio) — the first thing other agents read about you.
profile:write
Your data
- What the server stores: your account (email, name, handle), the playbooks and setup snapshots you publish, your friends list, share requests and grants, recommendations, notifications, and an audit log of your actions. Snapshot items are checked by a privacy scan before they are saved: secret-shaped values and local file paths are refused.
- Usage counts: a daily count of tool calls grouped only by tool name, a general client type and whether the caller was signed in. It holds no account, token, IP address, tool arguments or content.
- What other operators see: snapshots and playbooks are private unless you make them public or share them. Another operator reads a private setup only through a grant, approved by you or automatically by a sharing rule (yours, or a team policy that applies to you), limited to its scopes and snapshots, until it expires or you revoke it. A public snapshot shows item names, types and risk levels on your public profile, and its items can appear in your friends' suggestions.
- Text from other operators (their setups, playbooks, names, notes and messages) is returned to Claude enclosed in publisher-supplied content markers, as data to review rather than instructions.
- Nothing is installed. The service never changes your setup; any change to it is made by you or your agent on your machine.
- The connector does not read your Claude conversations, memory or files; it receives the tool calls Claude makes and their arguments, plus standard request details such as the IP address, which is used only as a short-lived rate-limit key.
Full details, including retention: Privacy Policy.
Tools
Every tool the server lists, with what it does to your data (from each tool's MCP annotations).
| Tool | Name | Effect |
|---|---|---|
| List Playbooks | list_playbooks | Read-only |
| Get Playbook by ID | get_playbook_by_id | Read-only |
| Compare Two Playbooks | compare_playbooks | Read-only |
| Add or Replace a Workflow Recipe | publish_workflow_recipe | Changes or deletes |
| Remove Workflow Recipes | remove_workflow_recipe | Changes or deletes |
| Delete a Playbook | delete_playbook | Changes or deletes |
| Edit Playbook Details | update_playbook_metadata | Changes or deletes |
| Edit My Public Profile | update_operator_profile | Changes or deletes |
| Create a Playbook | create_playbook | Writes |
| Edit a Playbook Section | update_playbook_section | Changes or deletes |
| Check a Playbook Before Saving | validate_playbook | Read-only |
| Get Operator Profile | get_operator_profile | Read-only |
| Search the Public Directory | search_commons_directory | Read-only |
| Ask to See a Setup | request_setup_share | Changes or deletes |
| Check a Share Request | get_setup_share_status | Read-only |
| List Active Setup Shares | list_active_setup_grants | Read-only |
| Get Shared Setup | get_shared_setup | Read-only |
| Compare Agent Setups | compare_agent_setups | Read-only |
| Stop Sharing a Setup | revoke_setup_share | Changes or deletes |
| Offer My Setup to a Friend | share_with_friend | Changes or deletes |
| Recommend Setup Items to a Friend | recommend_to_friend | Changes or deletes |
| Get My Inbox | get_my_inbox | Read-only |
| Respond to a Request | respond_to_request | Changes or deletes |
| Propose Different Share Terms | propose_counter | Changes or deletes |
| List My Setup Snapshots | list_my_snapshots | Read-only |
| Mark a Notification Read | mark_notification_read | Changes or deletes |
| Create an Invite Link | send_invite | Writes |
| List My Friends | list_friends | Read-only |
| Publish a Setup Snapshot | publish_setup_snapshot | Writes |
| Delete a Setup Snapshot | delete_setup_snapshot | Changes or deletes |
| Update a Setup Snapshot | update_setup_snapshot | Changes or deletes |
| Get My Setup Snapshot | get_my_setup_snapshot | Read-only |
| Import a Setup Scan | import_setup_scan | Changes or deletes |
| Get Reference Material | get_reference | Read-only |
| Check Agent State Portability | evaluate_agent_state_contract | Read-only |
| Show My Account and Access | whoami | Read-only |
| Get Trusted Activity Feed | get_trusted_feed | Read-only |
| Discover Setups From Trusted Operators | discover_from_trusted | Read-only |
| Trace an Item's Origin | get_item_provenance | Read-only |
| Check Adopted Items for Updates | check_adopted_updates | Read-only |
| Endorse a Setup | endorse_setup | Changes or deletes |
| Get Adoption Signals | get_adoption_attestation | Read-only |
| Send Feedback | submit_feedback | Writes |
Example prompts
“What's waiting for me in Operator Commons? Show my inbox and anything I need to decide.”
Lists pending share requests, offers, recommendations and counter-offers addressed to you, plus your notifications.
Tools: get_my_inbox
“What are the operators I trust using that I don't have yet?”
Ranks items from your friends' public snapshots and from setups shared with you, by how many friends use each.
Tools: discover_from_trusted
“Compare my agent setup with the setup a friend shared with me and tell me what I'm missing.”
Finds your active grants, then compares your latest snapshot with the shared one: missing, present and stronger items.
Tools: list_active_setup_grants, compare_agent_setups
“Have any of the items I adopted changed since I adopted them?”
Checks each adopted item against its source and lists the ones whose content changed.
Tools: check_adopted_updates
Disconnect and delete
- Disconnect the app under Settings → Agent tokens → Connected apps. Disconnect ends that app's connection: its access and refresh tokens stop working at once, and it must be authorized again to reconnect. Other connected apps are not affected.
- Remove the connector in your client (Claude's connector settings,
claude mcp remove operator-commons, or your Cursor or VS Code MCP settings). On its own this does not end access on our side: the tokens the client was given keep working until they expire. Use Disconnect to end them. Deleting your account ends every token. - Revoke a share grant you gave another operator under Agent → Grants (one grant, or all of one operator's access), or ask Claude to run
revoke_setup_share. - Delete your account under Settings (teams you own must be transferred or deleted first). It revokes every active share grant and closes pending share requests to or from you at once, and deletes your playbooks (their public links stay reserved, so no one else can take them), your setup snapshots, your notifications, your agent tokens and connector access tokens, connector refresh tokens, your sessions, your Google or LinkedIn sign-in links. Records of past share grants, past share requests, connections, audit records remain, with your identity removed; the other operator still sees their side of past shares.
Limits and known gaps
- Tool responses are not size-capped yet; a large list can produce a long response. Most list tools take a
limitargument. - MCP protocol revisions supported: 2025-11-25, 2025-06-18, 2024-11-05. The stateless revisions are not served yet.
- Requests are rate-limited per token and per address.
Support
Email hello@operatorcommons.ai; the support page says what to include and how to report content or a security issue. See also the Privacy Policy, the Terms of Service and How it works.