{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_jmuhfvd2sryq","handle":"ucp-mcp","url":"https://wellknown.network/agents/ucp-mcp","links":{"self":"https://wellknown.network/agents/ucp-mcp/record.json","html":"https://wellknown.network/agents/ucp-mcp","markdown":"https://wellknown.network/agents/ucp-mcp/record.md","api":"https://wellknown.network/api/v1/agents/ucp-mcp","status":"https://wellknown.network/api/v1/agents/ucp-mcp/status","claim":"https://wellknown.network/agents/ucp-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/ucp-mcp/claim.json","badge":"https://wellknown.network/agents/ucp-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/ucp-mcp/history","tools":"https://wellknown.network/api/v1/agents/ucp-mcp/tools"},"ard":{"identifier":"urn:air::server:ucp-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"ucp-mcp","summary":"Reference MCP server for the Universal Context Package: serves UCP documents to any MCP-capable agent (Cursor, Claude Code, ...)","description":"# ucp-mcp — reference MCP server for Universal Context Packages\n\nExposes UCP documents to any MCP-capable agent (Cursor, Claude Code, Codex,\nGemini CLI, …). This is the reference composition of the two protocols:\n\n> **MCP is the pipe. UCP is what flows through it.**\n\nThe server watches a directory of `*.ucp.json` files and serves them through\nthree tools. Any producer (a context platform, a script, a CI job) can drop\npackages into that directory; any agent connected to the server can consume\ntask context that is structured, provenance-backed, and token-budgeted.\n\n## Install & run\n\n```bash\npip install ucp-mcp\nucp-mcp --dir ./contexts        # or: UCP_DIR=./contexts ucp-mcp\n```\n\nCursor / Claude Code configuration (`mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"ucp\": {\n      \"command\": \"ucp-mcp\",\n      \"args\": [\"--dir\", \"/path/to/contexts\"]\n    }\n  }\n}\n```\n\n## Tools\n\n| Tool | Purpose |\n|---|---|\n| `list_contexts()` | Inventory: entity id, title, system, freshness for every available package |\n| `get_context(entity)` | Full UCP JSON for an entity (by id, URL, or title fragment) |\n| `get_context_markdown(entity, token_budget?)` | Canonical CommonMark rendering (SPEC §7), optionally truncated to a token budget by salience |\n\n`entity` matching is forgiving: exact entity id (`PAY-482`), source URL, or a\ncase-insensitive title fragment.\n\n## Why a directory of files?\n\nThis server is a *reference*, not a product. Its job is to demonstrate the\nMCP+UCP composition end to end with zero infrastructure, so that:\n\n- agent users can try UCP in one minute;\n- producers see the contract they need to implement (a real producer replaces\n  the directory with a live Context Builder, keeping the same tools).\n\n## Development\n\n```bash\npip install -e \".[dev]\"\npytest\n```","publisher":{"name":"Context OS Team","url":null},"homepage":null,"repository":null,"version":"0.1.0","license":null,"protocols":["mcp"],"tags":["context","context-engineering","llm","mcp","ucp"],"pricing":null,"endpoints":[{"url":"pypi:ucp-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.filesystem","name":"Filesystem","confidence":0.802,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"ucp-mcp","registry":"pypi","observedAt":"2026-11-04T03:27:49.369Z","publishedAt":"2026-07-05T17:32:29.818821Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"ucp-mcp","url":"https://pypi.org/project/ucp-mcp/","firstSeenAt":"2026-09-10T14:23:40.867Z","fetchedAt":"2026-11-04T03:25:52.490Z","normalizedAt":"2026-11-04T03:25:52.490Z"}]},"firstSeenAt":"2026-09-10T14:23:40.867Z","updatedAt":"2026-11-04T03:27:49.369Z"}