Penumbra MCP Server

What is Penumbra MCP Server?

An MCP server providing tools for interacting with the Penumbra blockchain. It enables privacy-preserving interactions with Penumbra's core features including transaction queries, validator set information, DEX state, and governance proposals.

How to use Penumbra MCP Server?

Install via npm or yarn, then configure as an MCP server in Claude Desktop settings using environment variables such as PENUMBRA_NODE_URL. Once configured, users can ask Claude natural language queries like "Show me the current Penumbra validator set" to invoke the available tools.

Key features of Penumbra MCP Server

• Query the current validator set
• Check chain status (block height, chain ID)
• Retrieve details of a specific transaction
• View current DEX state and batch auction results
• List active governance proposals

Use cases of Penumbra MCP Server

• Quickly check the current Penumbra validator set
• Monitor chain status and block height
• Look up transaction details by hash
• Inspect the DEX state and auction results
• Browse active governance proposals

FAQ from Penumbra MCP Server

What tools does Penumbra MCP Server currently provide?

It provides get_validator_set, get_chain_status, get_transaction, get_dex_state, and get_governance_proposals. All are currently mock implementations.

What are the runtime requirements?

Node.js, npm or yarn. The package is installed via npm install @timeheater/penumbra-mcp.

How is the Penumbra node connection configured?

Set the PENUMBRA_NODE_URL environment variable (default: https://rpc.penumbra.zone) along with other optional parameters for timeout, retries, and chain specifics.

What data is currently returned?

The server uses mock implementations for all tools. Future versions will integrate with Penumbra’s client libraries and node API endpoints.

Does the server support authentication or transport beyond MCP?

No authentication is mentioned. It uses the standard MCP transport and requires a Penumbra RPC node URL.