{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_vrw3daqrj8np","handle":"okf-mcp","url":"https://wellknown.network/agents/okf-mcp","links":{"self":"https://wellknown.network/agents/okf-mcp/record.json","html":"https://wellknown.network/agents/okf-mcp","markdown":"https://wellknown.network/agents/okf-mcp/record.md","api":"https://wellknown.network/api/v1/agents/okf-mcp","status":"https://wellknown.network/api/v1/agents/okf-mcp/status","claim":"https://wellknown.network/agents/okf-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/okf-mcp/claim.json","badge":"https://wellknown.network/agents/okf-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:okf-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"okf-mcp","summary":"MCP server for Open Knowledge Format (OKF) bundles — expose okf-ingest's deterministic consume verbs (search, context, graph impact, diff, doctor) as agent tools.","description":"# okf-mcp \n \n**MCP server for [Open Knowledge Format](https://github.com/GoogleCloudPlatform/knowledge-catalog) bundles** — expose [okf-ingest](https://github.com/travisjakel/okf-ingest)'s deterministic consume verbs as tools any MCP client (Claude Code, Cursor, custom agents) can call. \n \nExisting OKF MCP servers hand agents the markdown *files*. This one hands them \nthe **queryable catalog and concept graph**: index-first context assembly, \nimpact/backlink analysis, SQL over frontmatter, drift diffs, and health checks — \nall deterministic okf-ingest code, no model calls in the server. \n \n## Tools \n \n| Tool | What the agent gets | \n|---|---| \n| `okf_list_bundles` | which bundles this server exposes | \n| `okf_search` | concepts whose title/body match a term | \n| `okf_get_concept` | one concept's frontmatter + full body | \n| `okf_context` | **the flagship** — index.md + a concept's most relevant neighborhood as one curated markdown blob, ranked by exact Personalized PageRank over the author's link graph (pass `rank='bfs'` for plain depth) — or pass `query` (a free-text question) instead of `start` for lexical-seeded multi-PPR retrieval | \n| `okf_related` | the k concepts most relevant to a topic — exact PPR, no embeddings | \n| `okf_impact` | inbound / outbound / transitive links — \"what breaks if X changes\" | \n| `okf_sql` | read-only SELECT over the DuckDB catalog (`okf_concept`, `okf_link`, `okf_validation`) | \n| `okf_diff` | what changed on disk since the server loaded the bundle — an agent's memory-refresh between looks | \n| `okf_refresh` | re-ingest a directory bundle after `okf_diff` shows changes | \n| `okf_doctor` | health score + per-rule findings before trusting a bundle | \n \n## Install & run \n \nBuilt on the official MCP Python SDK v2 (MCP spec 2026-07-28); v2 servers \nstill answer the legacy `initialize` handshake, so pre-2026 clients keep \nworking. For environments pinned to SDK v1, install `okf-mcp==0.3.1`. \n \n```bash \npip install okf-mcp        # depends…","publisher":null,"homepage":"https://github.com/travisjakel/okf-mcp","repository":"https://github.com/travisjakel/okf-mcp","version":"0.4.0","license":"Apache-2.0","protocols":["mcp"],"tags":["okf","open-knowledge-format","mcp","model-context-protocol","knowledge-graph","duckdb"],"pricing":null,"endpoints":[{"url":"pypi:okf-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"knowledge.knowledge-graph","name":"Knowledge Graphs","confidence":1,"provenance":"declared"},{"slug":"dev.filesystem","name":"Filesystem","confidence":0.802,"provenance":"derived"},{"slug":"data.database","name":"Databases","confidence":0.733,"provenance":"derived"}],"categories":["data","dev","knowledge"],"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":"okf-mcp","registry":"pypi","observedAt":"2026-09-10T08:27:37.324Z","publishedAt":"2026-08-10T04:13:58.845195Z","latestVersion":"0.4.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"okf-mcp","url":"https://pypi.org/project/okf-mcp/","firstSeenAt":"2026-09-10T08:26:16.823Z","fetchedAt":"2026-09-10T08:26:16.823Z","normalizedAt":"2026-09-10T08:26:16.823Z"}]},"firstSeenAt":"2026-09-10T08:26:16.823Z","updatedAt":"2026-09-10T08:27:37.324Z"}