{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_p6k56z5nacd7","handle":"cava-mcp","url":"https://wellknown.network/agents/cava-mcp","links":{"self":"https://wellknown.network/agents/cava-mcp/record.json","html":"https://wellknown.network/agents/cava-mcp","markdown":"https://wellknown.network/agents/cava-mcp/record.md","api":"https://wellknown.network/api/v1/agents/cava-mcp","status":"https://wellknown.network/api/v1/agents/cava-mcp/status","claim":"https://wellknown.network/agents/cava-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/cava-mcp/claim.json","badge":"https://wellknown.network/agents/cava-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/cava-mcp/history","tools":"https://wellknown.network/api/v1/agents/cava-mcp/tools"},"ard":{"identifier":"urn:air::server:cava-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"cava-mcp","summary":"CaVa MCP server — read-only agentive access to OMOP vocab, cohorts, and clinical vocabularies.","description":"# cava-mcp\n\n**cava-mcp** is an atomic, read-only MCP (Model Context Protocol) tool library for\nnavigating the OMOP vocabularies.  It exposes OMOP vocabulary lookups, embedding similarity search, \ncohort concept references, and system status as typed MCP tools that any MCP client can call —\nincluding [cava-datahub](https://github.com/AustralianCancerDataNetwork/cava-datahub),\nClaude Code, and autonomous agents.\n\nRead-only.  No patient-level data.  No write operations.\n\n## What it exposes\n\n| Group | Tools |\n|---|---|\n| **Concept** | `concept_get`, `concept_by_code`, `concept_ancestors`, `concept_descendants`, `concept_relationships`, `concept_equivalency_path`, `concept_path`, `concept_map_to_standard`, `concept_neighbors` |\n| **Resolver** | `concept_ground` (with `parent_ids`, scoring fields, and `grounding_explanation`) |\n| **Search** | `concept_search_exact`, `concept_search_fulltext`, `concept_navigate_to_standard` |\n| **Embedding** | `embedding_index_status`, `embedding_neighbours`, `embedding_search`, `embedding_encode` |\n| **Cohort** | `cohort_find_concept_references` |\n| **System** | `system_status`, `system_vocabulary_catalogue` |\n\nTools are registered conditionally — if an adapter is not configured, its tools are\nsimply not registered.  `system_status` and `system_vocabulary_catalogue` are always\nregistered so clients can always query adapter availability.\n\n## Quick start\n\n```bash\nuv venv\nuv sync --extra dev --extra embedding-tools\nuv run cava-mcp --config config/cava-mcp.example.yaml --describe\n```\n\nStart the server:\n\n```bash\nuv run cava-mcp --config config/cava-mcp.example.yaml\n```\n\n## Example config\n\n```yaml\nomop_graph:\n  db_url: \"postgresql+psycopg://user:pass@localhost:5432/omop\"\n  vocab_schema: omop_vocab\n\nomop_emb:\n  enabled: true\n  backend_type: pgvector\n  db_url: \"postgresql+psycopg://user:pass@localhost:5432/omop\"\n  default_model_name: qwen3-embedding:0.6b\n  api_base: \"http://localhost:11434/v1\"\n  api_key: \"ollama\"\n```\n\n## Install matrix\n\n| Use ca…","publisher":null,"homepage":null,"repository":null,"version":"0.1.2","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:cava-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"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":0.814,"provenance":"derived"}],"categories":["data"],"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":"cava-mcp","registry":"pypi","observedAt":"2026-09-09T11:32:49.853Z","publishedAt":"2026-05-25T12:44:43.540823Z","latestVersion":"0.1.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"cava-mcp","url":"https://pypi.org/project/cava-mcp/","firstSeenAt":"2026-09-09T11:29:49.648Z","fetchedAt":"2026-09-09T11:29:49.648Z","normalizedAt":"2026-09-09T11:29:49.648Z"}]},"firstSeenAt":"2026-09-09T11:29:49.648Z","updatedAt":"2026-09-09T11:32:49.853Z"}