Terra Classic MCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Terra Classic MCP
A client-independent, read-only Model Context Protocol server for the Terra Classic blockchain. The same ten tools run over local stdio or Streamable HTTP at /mcp.
This project contains the server itself. Client configuration and optional skills are integration layers; no client plugin is required to use the server.
Tools
Tool | Result |
| Chain ID, latest block height, time and hash |
| Top bonded validators, voting power and commission |
| Native bank balances for a Terra address |
| Active staking delegations for an account |
| Delegations being unbonded and their completion times |
| Accrued, unwithdrawn rewards by validator and total |
| Recent proposals with a status filter |
| One proposal with its current or final vote tally |
| Compact transaction status and message types |
| Read-only CosmWasm smart query |
All tools publish input and output schemas, structured JSON results and MCP read-only annotations. They never accept a caller-selected LCD URL.
Delegation and proposal lists return up to 20 entries per page. If next_key is present, pass it unchanged as page_key to read the next page. Staking balances are chain base units; reward amounts are decimal base units and do not represent an APR. Governance tally counts are voting power, not voter counts.
Related MCP server: Mina Archive Node
Install and run
Python 3.11 or newer is required.
python3 -m venv .venv
. .venv/bin/activate
pip install -e .For a local MCP client, configure the command python /absolute/path/to/mcp-terra-classic/server.py using the virtual environment's Python executable. The server speaks MCP on standard input and output; logs stay on standard error.
For a local HTTP service:
.venv/bin/uvicorn http_server:app --host 127.0.0.1 --port 8000Connect an HTTP MCP client to http://127.0.0.1:8000/mcp. See client setup for Open WebUI, OpenBot, Codex, ChatGPT, Claude Code, Cursor and other clients.
Docker runs the same HTTP app and publishes it only on host loopback by default:
docker compose -f docker/compose.yaml up --buildConfiguration and deployment
Variable | Default | Meaning |
|
| Operator-selected LCD base URL; no path or credentials |
| unset | Set to |
|
| Comma-separated HTTP Host allowlist |
| localhost origins | Comma-separated browser Origin allowlist |
The server follows no LCD redirects, ignores environment proxy settings for LCD calls, limits request and response sizes, and validates Terra address checksums. HTTP uses the official Python MCP SDK's stateless Streamable HTTP transport and DNS rebinding protection.
The HTTP service has no built-in user authentication. Keep the default loopback binding for local use. Before exposing /mcp on a public domain, put it behind HTTPS, authentication and rate limiting, and set the host and origin allowlists for that domain. See deployment notes.
No seed phrase, private key, signing, transaction construction, or transaction broadcast code belongs in this project. Public LCD operators can observe queried public addresses and contract calls; operators can point the server at their own node.
Development
pip install -e '.[test]'
pytest -qTests cover LCD request construction, input validation, tool schemas, stdio discovery and an HTTP MCP exchange. They use local fixtures and do not require a live chain.
License
MIT. See LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Read-only THORChain swap quotes, liquidity pools, and network status.
Search Bluesky posts and feeds; read profiles, threads, and trends. STDIO or Streamable HTTP.
Read-only BlockReq docs, EVM JSON-RPC, and on-chain DEX and wallet data
Query SEC EDGAR filings, XBRL financials, and company data via MCP. STDIO or Streamable HTTP.
Related MCP Servers
- FlicenseBqualityDmaintenanceEnables privacy-preserving interactions with the Penumbra blockchain, offering tools for transaction queries, validator set information, DEX state, and governance proposals.55-
- AlicenseBqualityDmaintenanceProvides access to Mina blockchain data, enabling queries for events, actions, and network state information through a standardized interface.35 npmMIT
- AlicenseNot gradedqualityDmaintenanceRead-only Tendermint/Cosmos blockchain query for agents, with 10 pre-configured mainnets and custom RPC support.MIT
- AlicenseAqualityCmaintenanceEnables read-only Bitcoin blockchain queries and HD wallet derivation from xpub/seed, including balances, UTXOs, transactions, fees, mempool stats, and PSBT inspection via multiple backends with optional Tor routing.271Apache 2.0