SSyncDev

Penumbra MCP Server

MCP server for interacting with Penumbra blockchain - providing privacy-preserving tools for chain interaction

Local serverstdioTypeScript

What is the Penumbra MCP Server?

MCP server for interacting with Penumbra blockchain - providing privacy-preserving tools for chain interaction

The short version

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

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_validator_setGet the current validator set information
get_chain_statusGet current chain status including block height and chain ID
get_transactionGet details of a specific transaction
get_dex_stateGet current DEX state including latest batch auction results
get_governance_proposalsGet active governance proposals

How to install the Penumbra MCP Server

{
  "mcpServers": {
    "penumbra": {
      "command": "npx",
      "args": ["-y", "@timeheater/penumbra-mcp"],
      "env": {
        "PENUMBRA_NODE_URL": "your-value",
        "PENUMBRA_NETWORK": "your-value",
        "PENUMBRA_CHAIN_ID": "your-value",
        "PENUMBRA_REQUEST_TIMEOUT": "your-value",
        "PENUMBRA_REQUEST_RETRIES": "your-value",
        "PENUMBRA_BLOCK_TIME": "your-value",
        "PENUMBRA_EPOCH_DURATION": "your-value",
        "PENUMBRA_DEX_BATCH_INTERVAL": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
PENUMBRA_NODE_URLEndpoint or connection string the server talks to.Yes
PENUMBRA_NETWORKConfiguration value read at startup.Optional
PENUMBRA_CHAIN_IDConfiguration value read at startup.Optional
PENUMBRA_REQUEST_TIMEOUTConfiguration value read at startup.Optional
PENUMBRA_REQUEST_RETRIESConfiguration value read at startup.Optional
PENUMBRA_BLOCK_TIMEConfiguration value read at startup.Optional
PENUMBRA_EPOCH_DURATIONConfiguration value read at startup.Optional
PENUMBRA_DEX_BATCH_INTERVALConfiguration value read at startup.Optional

Example prompts to try

  • “Use Penumbra to get validator set.”
  • “Use Penumbra to get chain status.”
  • “Use Penumbra to get transaction.”

Frequently asked questions

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