{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_puuu8h5a7mph","handle":"qorechain-mcp","url":"https://wellknown.network/agents/qorechain-mcp","links":{"self":"https://wellknown.network/agents/qorechain-mcp/record.json","html":"https://wellknown.network/agents/qorechain-mcp","markdown":"https://wellknown.network/agents/qorechain-mcp/record.md","api":"https://wellknown.network/api/v1/agents/qorechain-mcp","status":"https://wellknown.network/api/v1/agents/qorechain-mcp/status","claim":"https://wellknown.network/agents/qorechain-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/qorechain-mcp/claim.json","badge":"https://wellknown.network/agents/qorechain-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/qorechain-mcp/history","tools":"https://wellknown.network/api/v1/agents/qorechain-mcp/tools"},"ard":{"identifier":"urn:air::server:qorechain-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"qorechain-mcp","summary":"MCP server with read access to QoreChain: blocks, transactions, accounts, validators, hybrid ML-DSA-87 signature status, simulation and unsigned transfers.","description":"# qorechain-mcp (Python)\n\n<!-- mcp-name: io.github.qorechain/qorechain-mcp -->\n\nMCP server with read access to [QoreChain](https://www.qorechain.io): blocks, transactions, accounts, validators, staking tiers, the status of the hybrid secp256k1 + ML-DSA-87 (FIPS 204) signature, EVM contract reads, simulation and fee estimates, and unsigned transfers for the user's own wallet to sign. It never signs, never holds keys and never broadcasts.\n\nThis is the Python distribution of the same server as the npm package `@qorechain/mcp`: same tool names, input and output schemas, outputs and error codes. Both are tested against the same recorded chain answers.\n\n```bash\nuvx qorechain-mcp                      # stdio\nuvx qorechain-mcp --network mainnet    # mainnet for calls that name no network\n```\n\nMCP client configuration:\n\n```json\n{ \"mcpServers\": { \"qorechain\": { \"command\": \"uvx\", \"args\": [\"qorechain-mcp\"] } } }\n```\n\nRequires Python 3.10 or later. The Python package serves stdio; for Streamable HTTP with API keys and rate limits, use `npx -y @qorechain/mcp serve` or the container image `ghcr.io/qorechain/qorechain-mcp`.\n\n## Tools\n\n`get_chain_info`, `get_block`, `get_transaction`, `get_address_info`, `get_pq_status`, `get_validators`, `get_staking_tiers`, `search`, `read_contract` (eth_call only), `estimate_fee`, `simulate_tx`, `prepare_transfer` (unsigned), and `get_token_holders` and `request_faucet`, which answer `NOT_AVAILABLE_ON_CHAIN`. Every tool takes an optional `network`: `testnet` (default) or `mainnet`. Full reference: <https://github.com/qorechain/qorechain-mcp/blob/main/docs/tools.md>.\n\nErrors are tool results with `isError: true` and a JSON body `{\"error\": {\"code\", \"message\", \"details?\"}}`, with the codes `NOT_FOUND`, `INVALID_INPUT`, `UPSTREAM_UNAVAILABLE`, `NOT_AVAILABLE_ON_CHAIN`, `RATE_LIMITED`, `UNAUTHORIZED`, `INTERNAL_ERROR`. Input that looks like a recovery phrase or private key is refused.\n\n## Library use\n\n```python\nimport anyio\nfrom qorechain_mcp import …","publisher":{"name":"QoreChain Association","url":null},"homepage":"https://github.com/qorechain/qorechain-mcp","repository":"https://github.com/qorechain/qorechain-mcp","version":"0.1.0","license":null,"protocols":["mcp"],"tags":["agents","blockchain","mcp","ml-dsa","model-context-protocol","qorechain"],"pricing":null,"endpoints":[{"url":"pypi:qorechain-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.docs-lookup","name":"Documentation Lookup","confidence":0.791,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.756,"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":"qorechain-mcp","registry":"pypi","observedAt":"2026-10-30T20:23:26.470Z","publishedAt":"2026-10-27T20:19:54.667449Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"qorechain-mcp","url":"https://pypi.org/project/qorechain-mcp/","firstSeenAt":"2026-10-30T20:22:25.848Z","fetchedAt":"2026-10-30T20:22:25.848Z","normalizedAt":"2026-10-30T20:22:25.848Z"}]},"firstSeenAt":"2026-10-30T20:22:25.848Z","updatedAt":"2026-10-30T20:23:26.470Z"}