Skip to main content

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

ToolNameEffect
List Playbookslist_playbooksRead-only
Get Playbook by IDget_playbook_by_idRead-only
Compare Two Playbookscompare_playbooksRead-only
Add or Replace a Workflow Recipepublish_workflow_recipeChanges or deletes
Remove Workflow Recipesremove_workflow_recipeChanges or deletes
Delete a Playbookdelete_playbookChanges or deletes
Edit Playbook Detailsupdate_playbook_metadataChanges or deletes
Edit My Public Profileupdate_operator_profileChanges or deletes
Create a Playbookcreate_playbookWrites
Edit a Playbook Sectionupdate_playbook_sectionChanges or deletes
Check a Playbook Before Savingvalidate_playbookRead-only
Get Operator Profileget_operator_profileRead-only
Search the Public Directorysearch_commons_directoryRead-only
Ask to See a Setuprequest_setup_shareChanges or deletes
Check a Share Requestget_setup_share_statusRead-only
List Active Setup Shareslist_active_setup_grantsRead-only
Get Shared Setupget_shared_setupRead-only
Compare Agent Setupscompare_agent_setupsRead-only
Stop Sharing a Setuprevoke_setup_shareChanges or deletes
Offer My Setup to a Friendshare_with_friendChanges or deletes
Recommend Setup Items to a Friendrecommend_to_friendChanges or deletes
Get My Inboxget_my_inboxRead-only
Respond to a Requestrespond_to_requestChanges or deletes
Propose Different Share Termspropose_counterChanges or deletes
List My Setup Snapshotslist_my_snapshotsRead-only
Mark a Notification Readmark_notification_readChanges or deletes
Create an Invite Linksend_inviteWrites
List My Friendslist_friendsRead-only
Publish a Setup Snapshotpublish_setup_snapshotWrites
Delete a Setup Snapshotdelete_setup_snapshotChanges or deletes
Update a Setup Snapshotupdate_setup_snapshotChanges or deletes
Get My Setup Snapshotget_my_setup_snapshotRead-only
Import a Setup Scanimport_setup_scanChanges or deletes
Get Reference Materialget_referenceRead-only
Check Agent State Portabilityevaluate_agent_state_contractRead-only
Show My Account and AccesswhoamiRead-only
Get Trusted Activity Feedget_trusted_feedRead-only
Discover Setups From Trusted Operatorsdiscover_from_trustedRead-only
Trace an Item's Originget_item_provenanceRead-only
Check Adopted Items for Updatescheck_adopted_updatesRead-only
Endorse a Setupendorse_setupChanges or deletes
Get Adoption Signalsget_adoption_attestationRead-only
Send Feedbacksubmit_feedbackWrites

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 limit argument.
  • 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.