{"slug":"oip-system-mcp","title":"OIP system: MCP servers","body":"## MCP servers\n\nA generated article for one OIP shelf. It lists every operation in this API/CLI/MCP/device/model/core subsystem, links each leaf article, and gives the ledger path for proof.\n\nThis page is the operating article for one build subsystem. It is generated from live directory rows. If a task belongs to this subsystem, scan the operations below, open the matching capability article, run only the exact object named there, and verify by receipt.\n\nKind: `mcp`. Capabilities: `11`. Machine system map: [/api/dispatch?map=MCP&format=markdown](https://miscsubjects.com/api/dispatch?map=MCP&format=markdown). Root: [/a/oip](https://miscsubjects.com/a/oip).\n\n## Operations\n\n### MCP_context7_resolve_library_id\nResolves a general library name into a Context7-compatible library ID (ranked by relevance to query). Returns list of matching library IDs with scores\nUse when: you have a vague library name and need the exact Context7 ID first\nArguments: `query|libraryName`.\nHuman article: [/a/oip-capability-mcp-context7-resolve-library-id](https://miscsubjects.com/a/oip-capability-mcp-context7-resolve-library-id). Machine doc: [?key=MCP_context7_resolve_library_id&format=markdown](https://miscsubjects.com/api/dispatch?key=MCP_context7_resolve_library_id&format=markdown). Invocation history: [/api/invocations?object_id=MCP_context7_resolve_library_id](https://miscsubjects.com/api/invocations?object_id=MCP_context7_resolve_library_id).\n\n### MCP_context7_query_docs\nRetrieves up-to-date, version-specific documentation + code examples for a library using its exact Context7 libraryId. Use after resolve-library-id (or when you already have the ID). Returns relevant docs/chunks\nUse when: you need to mcp context7 query docs\nArguments: `libraryId|query`.\nHuman article: [/a/oip-capability-mcp-context7-query-docs](https://miscsubjects.com/a/oip-capability-mcp-context7-query-docs). Machine doc: [?key=MCP_context7_query_docs&format=markdown](https://miscsubjects.com/api/dispatch?key=MCP_context7_query_docs&format=markdown). Invocation history: [/api/invocations?object_id=MCP_context7_query_docs](https://miscsubjects.com/api/invocations?object_id=MCP_context7_query_docs).\n\n### MCP\nMCP server unified entrypoint via Mac bridge\nUse when: MCP servers (brave_search, computer_use, doctor, fetch, etc.)\nArguments: `$1=op, $2..$N=args`.\nHuman article: [/a/oip-capability-mcp](https://miscsubjects.com/a/oip-capability-mcp). Machine doc: [?key=MCP&format=markdown](https://miscsubjects.com/api/dispatch?key=MCP&format=markdown). Invocation history: [/api/invocations?object_id=MCP](https://miscsubjects.com/api/invocations?object_id=MCP).\n\n### MCP_TOOL_CALL\nProxy one tool call into an external MCP server (Streamable HTTP JSON-RPC)\nUse when: you need to mcp tool call\nArguments: `server_url|tool_name|auth_env_var|args_json`.\nHuman article: [/a/oip-capability-mcp-tool-call](https://miscsubjects.com/a/oip-capability-mcp-tool-call). Machine doc: [?key=MCP_TOOL_CALL&format=markdown](https://miscsubjects.com/api/dispatch?key=MCP_TOOL_CALL&format=markdown). Invocation history: [/api/invocations?object_id=MCP_TOOL_CALL](https://miscsubjects.com/api/invocations?object_id=MCP_TOOL_CALL).\n\n### MCP_IMPORT\nCannibalize an MCP server: read its tools/list and emit a proposed directory row per tool (GAP-checked vs existing keys). PROPOSE only — returns SQL; apply with D1_EXEC or wrangler\nUse when: you need to mcp import\nArguments: `server_url|category|auth_env_var`.\nHuman article: [/a/oip-capability-mcp-import](https://miscsubjects.com/a/oip-capability-mcp-import). Machine doc: [?key=MCP_IMPORT&format=markdown](https://miscsubjects.com/api/dispatch?key=MCP_IMPORT&format=markdown). Invocation history: [/api/invocations?object_id=MCP_IMPORT](https://miscsubjects.com/api/invocations?object_id=MCP_IMPORT).\n\n### MCP_OAUTH_SEED\nStore/replace one MCP server's OAuth credentials in KV (mcp_oauth:<label>). The build refreshes the short-lived token itself.\nUse when: registering a Cloudflare (or any OAuth) MCP server so agents can use it\nArguments: `label|json json={\"server_url\",\"token_endpoint\",\"client_id\",\"refresh_token\"}`.\nHuman article: [/a/oip-capability-mcp-oauth-seed](https://miscsubjects.com/a/oip-capability-mcp-oauth-seed). Machine doc: [?key=MCP_OAUTH_SEED&format=markdown](https://miscsubjects.com/api/dispatch?key=MCP_OAUTH_SEED&format=markdown). Invocation history: [/api/invocations?object_id=MCP_OAUTH_SEED](https://miscsubjects.com/api/invocations?object_id=MCP_OAUTH_SEED).\n\n### MCP_ATTACH\nSet which MCP servers attach to the model globally (KV mcp_attach). Per-agent override = SET <KEY>_mcp.\nUse when: turn Cloudflare MCP tools on/off for the agents\nArguments: `comma list of labels (empty clears). EX: [MCP_ATTACH]bindings,docs,observability[/MCP_ATTACH]`.\nHuman article: [/a/oip-capability-mcp-attach](https://miscsubjects.com/a/oip-capability-mcp-attach). Machine doc: [?key=MCP_ATTACH&format=markdown](https://miscsubjects.com/api/dispatch?key=MCP_ATTACH&format=markdown). Invocation history: [/api/invocations?object_id=MCP_ATTACH](https://miscsubjects.com/api/invocations?object_id=MCP_ATTACH).\n\n### MCP_STATUS\nList every seeded MCP server, its token freshness (seconds left), and the current attach list.\nUse when: check what MCP servers are wired and whether tokens are valid\nArguments: `none. EX: [MCP_STATUS][/MCP_STATUS]`.\nHuman article: [/a/oip-capability-mcp-status](https://miscsubjects.com/a/oip-capability-mcp-status). Machine doc: [?key=MCP_STATUS&format=markdown](https://miscsubjects.com/api/dispatch?key=MCP_STATUS&format=markdown). Invocation history: [/api/invocations?object_id=MCP_STATUS](https://miscsubjects.com/api/invocations?object_id=MCP_STATUS).\n\n### MCP_AGENT\nInvokable OIP capability.\nHuman article: [/a/oip-capability-mcp-agent](https://miscsubjects.com/a/oip-capability-mcp-agent). Machine doc: [?key=MCP_AGENT&format=markdown](https://miscsubjects.com/api/dispatch?key=MCP_AGENT&format=markdown). Invocation history: [/api/invocations?object_id=MCP_AGENT](https://miscsubjects.com/api/invocations?object_id=MCP_AGENT).\n\n### MCP_CATALOG\nInvokable OIP capability.\nHuman article: [/a/oip-capability-mcp-catalog](https://miscsubjects.com/a/oip-capability-mcp-catalog). Machine doc: [?key=MCP_CATALOG&format=markdown](https://miscsubjects.com/api/dispatch?key=MCP_CATALOG&format=markdown). Invocation history: [/api/invocations?object_id=MCP_CATALOG](https://miscsubjects.com/api/invocations?object_id=MCP_CATALOG).\n\n### MCP_EVAL\nTry an integration before installing it. Resolves the named integration to its OIP objects, classifies read vs write, runs one safe read-only trial, returns a receipt, and recommends connect or skip.\nUse when: \"should I get the Stripe MCP\", \"what can the GitHub integration do\", \"try X before I connect it\".\nArguments: `$1 = integration name (stripe|github|context7|drive|slack|notion); $2 = optional mode \"live\" to run a live read-only trial for financial integrations.`.\nHuman article: [/a/oip-capability-mcp-eval](https://miscsubjects.com/a/oip-capability-mcp-eval). Machine doc: [?key=MCP_EVAL&format=markdown](https://miscsubjects.com/api/dispatch?key=MCP_EVAL&format=markdown). Invocation history: [/api/invocations?object_id=MCP_EVAL](https://miscsubjects.com/api/invocations?object_id=MCP_EVAL).\n","register":"oip_protocol","tags":["oip","object-invocation-protocol","protocol-specification","machine-native-json","system"],"style":{"accent":"#16324f","measure":860},"claims":[{"id":"oip-c1","tier":"system","text":"The OIP article layer is generated from live directory rows, so it documents the objects that actually run the reference implementation.","who_claims":"system/oip_articles","source_ids":["oip-s3","oip-s4"]},{"id":"oip-c2","tier":"system","text":"The OIP operating path is caller to directory object to dispatch runner to invocation ledger to receipt.","who_claims":"system/oip_articles","source_ids":["oip-s1"]},{"id":"oip-c3","tier":"system","text":"Every executable capability in the reference implementation is reachable as an OIP object with a human article, a machine document, invocation history, and receipt path.","who_claims":"system/oip_articles","source_ids":["oip-s2","oip-s3"]},{"id":"oip-c4","tier":"system","text":"Tap & Go is the copy primitive: one drop carries credential, protocol, tree, search, execute, and receipt instructions without a separate token-map-bundle assembly step.","who_claims":"system/oip_articles","source_ids":["oip-s2"]},{"id":"oip-c5","tier":"system","text":"OIP receipts are the proof object for actions: they record request, response, actor, links, replay, repair, and lineage.","who_claims":"system/oip_articles","source_ids":["oip-s2","oip-s5"]}],"sources":[{"id":"oip-s1","type":"protocol","title":"BUILD_SPEC object invocation path","url":"https://miscsubjects.com/api/file/docs/BUILD_SPEC.md","summary":"Defines directory rows, dispatch, ledger, and the escalation path for changing the build.","quote":"Run anything: POST https://miscsubjects.com/api/dispatch {key, body}","claim_ids":["oip-c2"],"link_status":"ok","hash":"oipbuildspec0001"},{"id":"oip-s2","type":"protocol","title":"Object Invocation Protocol spec","url":"https://miscsubjects.com/api/file/docs/OIP.md","summary":"Defines OIP surfaces, invariant loop, receipt/replay/repair, and invocation envelopes.","quote":"identify, explain, invoke, ledger, yield","claim_ids":["oip-c3","oip-c4","oip-c5"],"link_status":"ok","hash":"oipspec00000002"},{"id":"oip-s3","type":"protocol","title":"Live OIP capability tree","url":"https://miscsubjects.com/api/dispatch?map=1&format=markdown","summary":"Public recursive capability tree.","quote":"root > shelf > system article > capability article > receipt","claim_ids":["oip-c1","oip-c3"],"link_status":"ok","hash":"oipmap0000000002"},{"id":"oip-s4","type":"protocol","title":"Directory row documentation","url":"https://miscsubjects.com/api/dispatch?key=OIP_TREE&format=markdown","summary":"Capability articles are generated from live rows.","quote":"Machine Contract","claim_ids":["oip-c1"],"link_status":"ok","hash":"oiprow0000000003"},{"id":"oip-s5","type":"protocol","title":"Invocation ledger","url":"https://miscsubjects.com/api/invocations","summary":"Append-only invocation records and receipt links.","quote":"invocations","claim_ids":["oip-c5"],"link_status":"ok","hash":"oipinvocations0005"}],"prov":{"model":"system/oip_articles","action":"generate"}}