
MCP server for interacting with Penumbra blockchain - providing privacy-preserving tools for chain
MCP server for interacting with Penumbra blockchain - providing privacy-preserving tools for chain interaction
·
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.
get_validator_set: Get the current validator set informationget_chain_status: Get current chain status including block height and chain IDget_transaction: Get details of a specific transactionget_dex_state: Get current DEX state including latest batch auction resultsget_governance_proposals: Get active governance proposalsYou can install the package via npm:
npm install @timeheater/penumbra-mcpOr using yarn:
yarn add @timeheater/penumbra-mcpnpm installnpm run buildnpm run watchTo integrate with Claude desktop, add the following configuration to your Claude desktop settings file (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"penumbra-mcp": {
"command": "node",
"args": ["/Users/barton/infinity-topos/penumbra-mcp/build/index.js"],
"env": {
"PENUMBRA_NODE_URL": "https://rpc.penumbra.zone",
"PENUMBRA_NETWORK": "mainnet",
"PENUMBRA_CHAIN_ID": "penumbra-1",
"PENUMBRA_REQUEST_TIMEOUT": "30000",
"PENUMBRA_REQUEST_RETRIES": "5",
"PENUMBRA_BLOCK_TIME": "6000",
"PENUMBRA_EPOCH_DURATION": "100",
"PENUMBRA_DEX_BATCH_INTERVAL": "60000",
"PENUMBRA_DEX_MIN_LIQUIDITY": "1000",
"PENUMBRA_DEX_MAX_PRICE_IMPACT": "0.05",
"PENUMBRA_GOVERNANCE_VOTING_PERIOD": "1209600000",
"PENUMBRA_GOVERNANCE_MIN_DEPOSIT": "100000"
}
}
}
}Replace /path/to/penumbra-mcp with the actual path where you've installed the server.
Once configured, you can interact with Penumbra through Claude using the following tools:
Tell Claude: "Show me the current Penumbra validator set"Tell Claude: "What's the current status of the Penumbra chain?"Tell Claude: "Look up Penumbra transaction [HASH]"Tell Claude: "Show me the current Penumbra DEX state"Tell Claude: "List active Penumbra governance proposals"npm run watch: Watch mode for developmentnpm run inspector: Run MCP inspector for testingnpm test: Run test suitePENUMBRA_NODE_URL: URL of the Penumbra node (default: https://rpc.penumbra.zone)PENUMBRA_REQUEST_TIMEOUT: HTTP request timeout in milliseconds (default: 30000)PENUMBRA_REQUEST_RETRIES: Number of request retries (default: 5)PENUMBRA_NETWORK: Network to connect to (default: mainnet)PENUMBRA_CHAIN_ID: Chain ID (default: penumbra-1)PENUMBRA_BLOCK_TIME: Block time in milliseconds (default: 6000)PENUMBRA_EPOCH_DURATION: Number of blocks per epoch (default: 100)PENUMBRA_DEX_BATCH_INTERVAL: Batch auction interval in milliseconds (default: 60000)PENUMBRA_DEX_MIN_LIQUIDITY: Minimum liquidity amount (default: 1000)PENUMBRA_DEX_MAX_PRICE_IMPACT: Maximum price impact as decimal (default: 0.05)PENUMBRA_GOVERNANCE_VOTING_PERIOD: Voting period duration in milliseconds (default: 1209600000 - 14 days)PENUMBRA_GOVERNANCE_MIN_DEPOSIT: Minimum proposal deposit amount (default: 100000)The server is built using TypeScript and implements the Model Context Protocol (MCP) for standardized tool interfaces. It currently provides mock implementations for core functionality, with plans to integrate directly with Penumbra's client libraries and node API endpoints.
All interactions respect Penumbra's privacy-preserving design:
Contributions are welcome! Please feel free to submit a Pull Request.
ISC
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add penumbra-mcp -- node /Users/barton/infinity-topos/penumbra-mcp/build/index.js{
"mcpServers": {
"penumbra-mcp": {
"env": {
"PENUMBRA_NETWORK": "",
"PENUMBRA_CHAIN_ID": "",
"PENUMBRA_NODE_URL": "",
"PENUMBRA_BLOCK_TIME": "",
"PENUMBRA_EPOCH_DURATION": "",
"PENUMBRA_REQUEST_RETRIES": "",
"PENUMBRA_REQUEST_TIMEOUT": "",
"PENUMBRA_DEX_MIN_LIQUIDITY": "",
"PENUMBRA_DEX_BATCH_INTERVAL": "",
"PENUMBRA_DEX_MAX_PRICE_IMPACT": "",
"PENUMBRA_GOVERNANCE_MIN_DEPOSIT": "",
"PENUMBRA_GOVERNANCE_VOTING_PERIOD": ""
},
"args": [
"/Users/barton/infinity-topos/penumbra-mcp/build/index.js"
],
"command": "node"
}
}
}code --add-mcp '{"name":"penumbra-mcp","env":{"PENUMBRA_NETWORK":"","PENUMBRA_CHAIN_ID":"","PENUMBRA_NODE_URL":"","PENUMBRA_BLOCK_TIME":"","PENUMBRA_EPOCH_DURATION":"","PENUMBRA_REQUEST_RETRIES":"","PENUMBRA_REQUEST_TIMEOUT":"","PENUMBRA_DEX_MIN_LIQUIDITY":"","PENUMBRA_DEX_BATCH_INTERVAL":"","PENUMBRA_DEX_MAX_PRICE_IMPACT":"","PENUMBRA_GOVERNANCE_MIN_DEPOSIT":"","PENUMBRA_GOVERNANCE_VOTING_PERIOD":""},"args":["/Users/barton/infinity-topos/penumbra-mcp/build/index.js"],"command":"node"}'[mcp_servers.penumbra-mcp]
command = "node"
args = ["/Users/barton/infinity-topos/penumbra-mcp/build/index.js"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/penumbra-mcp-server to learn what the "Penumbra MCP Server" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
This server runs locally, so we can't read its tool list over the web yet.
We could not run this server: it ships no npx package for our sandbox and no public endpoint. The four checks that need a live server are left out, and the grade tops out at B until one exists.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/penumbra-mcp-server)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "penumbra-mcp-server" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.