# solana-infra-mcp

[![CI](https://github.com/rpc-edge/solana-infra-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/rpc-edge/solana-infra-mcp/actions/workflows/ci.yml)
[![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)

**An MCP server that gives your agent Solana-infra awareness** — RPC health, priority-fee
estimation, leader schedule, chain state, and latency comparison. Provider-agnostic; point it
at any Solana RPC ([rpc edge](https://rpcedge.com) is the flagship backend). Read-only, no keys
logged, no heavy deps (plain JSON-RPC over `fetch`).

## Tools

| Tool | What it answers |
|---|---|
| `rpc_health` | Is this endpoint healthy? version, current slot, measured request latency |
| `priority_fee_estimate` | What compute-unit price lands right now? p50/p75/p90/max micro-lamports/CU |
| `epoch_info` | Where are we in the epoch? slot index, block height |
| `next_leaders` | Who are the next N slot leaders? (time your submissions) |
| `latency_compare` | How does my endpoint's read latency compare to a baseline? |
| `submit_transaction` | Relay a caller-**signed** base64 tx and confirm on-chain landing (keyless) |

## Add it to Claude

Build it, then register the server. Claude Code:

```sh
git clone https://github.com/rpc-edge/solana-infra-mcp && cd solana-infra-mcp
pnpm install && pnpm build
claude mcp add solana-infra -- node "$(pwd)/dist/index.js"
```

Or in a client config (Claude Desktop / others):

```json
{
  "mcpServers": {
    "solana-infra": {
      "command": "node",
      "args": ["/abs/path/to/solana-infra-mcp/dist/index.js"],
      "env": { "SOLANA_RPC_URL": "https://rpc.rpcedge.com/?api-key=YOUR_KEY" }
    }
  }
}
```

### Docker (Glama / directory hosts)

```sh
docker build -t solana-infra-mcp .
docker run -i --rm -e SOLANA_RPC_URL='https://rpc.rpcedge.com/?api-key=YOUR_KEY' solana-infra-mcp
```

`glama.json` claims maintainers for https://glama.ai/mcp (listing after publish). For the branded npm path use [`rpcedge-mcp`](https://github.com/rpc-edge/rpcedge-toolkit) (`npx rpcedge-mcp@latest`).

## Skill & plugin

The repo also ships as a **Claude Code plugin**: `.claude-plugin/plugin.json` + `.mcp.json`
(registers the server) + a **skill** (`skills/solana-infra/SKILL.md`) that teaches Claude *when*
to reach for each tool. Because the server is TypeScript, run `pnpm install && pnpm build` once
so `dist/` exists; then install the plugin dir (or just `claude mcp add` as above).
(An `npx`-installable published build is on the roadmap.)

## Provider config

`SOLANA_RPC_URL` sets the default endpoint every tool uses (unset → public mainnet-beta).
Point it at rpc edge with your key for the low-latency path; the API key is read from the
environment at runtime and **never logged** (tools display the host only). Any tool also takes
an explicit `url` argument to override per call.

## Status & roadmap

Working today: six tools (five read-only + keyless `submit_transaction`), all verified against
live mainnet; a bundled skill + Claude Code plugin.

Next:
- `yellowstone_sample` — a bounded gRPC first-seen/freshness probe (MCP is request/response, so
  streaming is exposed as a time-boxed sample, not a live subscription).
- Publish an `npx`-installable build on npm; finish Glama + MCP registry listings.
- awesome-solana-ai PR: https://github.com/solana-foundation/awesome-solana-ai/pull/193

## Develop

```sh
pnpm install
pnpm typecheck
pnpm build      # -> dist/
pnpm start      # runs the stdio server
```

## License

MIT — see [LICENSE](./LICENSE). By [rpc edge](https://rpcedge.com).