{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_vyjdp8ujxpgg","handle":"hepdata-mcp","url":"https://wellknown.network/agents/hepdata-mcp","links":{"self":"https://wellknown.network/agents/hepdata-mcp/record.json","html":"https://wellknown.network/agents/hepdata-mcp","markdown":"https://wellknown.network/agents/hepdata-mcp/record.md","api":"https://wellknown.network/api/v1/agents/hepdata-mcp","status":"https://wellknown.network/api/v1/agents/hepdata-mcp/status","claim":"https://wellknown.network/agents/hepdata-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/hepdata-mcp/claim.json","badge":"https://wellknown.network/agents/hepdata-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/hepdata-mcp/history","tools":"https://wellknown.network/api/v1/agents/hepdata-mcp/tools"},"ard":{"identifier":"urn:air::server:hepdata-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"hepdata-mcp","summary":"An MCP server for discovering and retrieving HEPData records.","description":"# HEPData MCP\n\nThis is an MCP server for discovering HEPData records, listing tables, fetching table data, and exposing HEPData export links. This is an early MVP implementation, focused on read-only access to public HEPData content.\n\nLocal stdio is the default and recommended mode. HTTP support exists for local testing and hardened central deployments, but remote HTTP is also supported for multiple clients support.\n\n## Run From PyPI\n\nHEPData MCP is published on PyPI as [`hepdata-mcp`](https://pypi.org/project/hepdata-mcp/).\nThe easiest way to run it is with `uvx`:\n\n```bash\nuvx hepdata-mcp\n```\n\nIf you want to avoid package resolution during MCP client startup, install the tool once:\n\n```bash\nuv tool install hepdata-mcp\nhepdata-mcp\n```\n\nUpgrade that installed tool with `uv tool upgrade hepdata-mcp`.\nFor MCP client configs in this mode, use `hepdata-mcp` as the command with no arguments.\n\n## Install From Source\n\nFor development, install this checkout in editable mode:\n\n```bash\ngit clone https://github.com/HEPData/hepdata-mcp ~/.local/uv/hepdata-mcp-src\ncd ~/.local/uv/hepdata-mcp-src\nuv sync --all-groups\n```\n\nFor development checks:\n\n```bash\nuv run pytest\nuv run ruff check .\nuv run ruff format --check .\nuv run mypy\n```\n\n## Docker\n\nThe Docker image is published on Docker Hub as [`hepdata/hepdata-mcp`](https://hub.docker.com/r/hepdata/hepdata-mcp).\nPull the latest release:\n\n```bash\ndocker pull hepdata/hepdata-mcp:latest\n```\n\nFor reproducible deployments, pin a release tag such as `hepdata/hepdata-mcp:0.1.0`.\n\nRun over stdio for clients that can launch Docker commands:\n\n```bash\ndocker run --rm -i hepdata/hepdata-mcp:latest\n```\n\nExample stdio client command:\n\n```json\n{\n  \"mcpServers\": {\n    \"hepdata\": {\n      \"command\": \"docker\",\n      \"args\": [\"run\", \"--rm\", \"-i\", \"hepdata/hepdata-mcp:latest\"]\n    }\n  }\n}\n```\n\nRun local streamable HTTP:\n\n```bash\ndocker run --rm \\\n  -p 127.0.0.1:8000:8000 \\\n  -e HEPDATA_MCP_ALLOW_REMOTE_HTTP=1 \\\n  -e HEPDATA_MCP_TRUST_PROXY_AUTH=1 \\\n  hep…","publisher":null,"homepage":"https://github.com/HEPData/hepdata-mcp#readme","repository":"https://github.com/HEPData/hepdata-mcp/blob/main/CHANGELOG.md","version":"0.2.0","license":null,"protocols":["mcp"],"tags":["datasets","hepdata","high-energy-physics","mcp","model-context-protocol","particle-physics"],"pricing":null,"endpoints":[{"url":"pypi:hepdata-mcp","type":"package_pypi","auth":null,"probeable":false,"listed":true}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.ci-cd","name":"CI/CD & Deploy","confidence":0.779,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"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":"hepdata-mcp","registry":"pypi","observedAt":"2026-11-09T06:28:03.508Z","publishedAt":"2026-08-25T21:18:41.782294Z","latestVersion":"0.2.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"hepdata-mcp","url":"https://pypi.org/project/hepdata-mcp/","firstSeenAt":"2026-09-09T17:20:52.406Z","fetchedAt":"2026-11-09T06:27:07.797Z","normalizedAt":"2026-11-09T06:27:07.797Z"}]},"firstSeenAt":"2026-09-09T17:20:52.406Z","updatedAt":"2026-11-09T06:28:03.508Z"}