Pion.

A Model Context Protocol server for Pi Network

unofficial community project · not affiliated with Pi Network

Abstract

Pion connects AI agents — Claude, Cursor, and any MCP-compatible client — to the Pi Network blockchain. Version 0.1 exposes read-only tools for wallet balances, payment history, and transaction verification against public testnet infrastructure: no API keys, no wallet secrets, nothing that can move value. It is the first step toward agents that can transact on Pi safely, with humans holding the leash.

Fig. 1 — In particle physics, the pion is the π meson, and pion decays are studied in searches for MCPs (millicharged particles). A π particle producing MCPs: we found the name irresistible.

1.Tools

Every v0.1 tool is a read against Pi's public Horizon API. An agent can look, verify, and reason about on-chain state — it cannot spend, sign, or hold anything.

Tool	What the agent gets
`get_wallet_balance`	Pi and token balances for any wallet address
`get_account_payments`	Payment history for an account
`query_transaction`	Details and verification of a specific transaction

2.Quickstart

Add Pion to your MCP client's configuration — for Claude Desktop, that's claude_desktop_config.json:

{
  "mcpServers": {
    "pion": {
      "command": "npx",
      "args": ["-y", "pion-mcp"]
    }
  }
}

Restart the client and ask your agent for a testnet wallet balance. No keys to configure — v0.1 talks only to public endpoints.

3.Status

Name, package, and domain claimed; SDK surface mapped
v0.1 — read-only Horizon tools on Pi Testnet
v0.2 — App-to-User payments (testnet), payment status and recovery tools
Later — agent allowance delegation: humans authorize, agents spend within bounds

4.References

Pion source repository — Apache-2.0, contributions welcome.
pion-mcp on npm
Model Context Protocol — the open standard Pion implements.
Pi Platform documentation