# SolidRPC MCP server

> Manage blockchain RPC keys, networks, usage, and prepaid billing through a scoped management token.

- Repository: https://github.com/SolidRPC/agent-toolkit
- Page: https://hostedmcp.org/servers/solidrpc/agent-toolkit
- Transport: stdio, remote
- Stars: 0
- License: MIT
- Latest version: 0.1.1

## Install

### Claude Code

```sh
claude mcp add --env 'SOLIDRPC_TOKEN_FILE=<SOLIDRPC_TOKEN_FILE>' agent-toolkit -- npx -y @solidrpc/agent
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "agent-toolkit": {
      "command": "npx",
      "args": [
        "-y",
        "@solidrpc/agent"
      ],
      "env": {
        "SOLIDRPC_TOKEN_FILE": "<SOLIDRPC_TOKEN_FILE>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "agent-toolkit": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@solidrpc/agent"
      ],
      "env": {
        "SOLIDRPC_TOKEN_FILE": "<SOLIDRPC_TOKEN_FILE>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"agent-toolkit","type":"stdio","command":"npx","args":["-y","@solidrpc/agent"],"env":{"SOLIDRPC_TOKEN_FILE":"<SOLIDRPC_TOKEN_FILE>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "agent-toolkit": {
      "command": "npx",
      "args": [
        "-y",
        "@solidrpc/agent"
      ],
      "env": {
        "SOLIDRPC_TOKEN_FILE": "<SOLIDRPC_TOKEN_FILE>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add agent-toolkit --env 'SOLIDRPC_TOKEN_FILE=<SOLIDRPC_TOKEN_FILE>' -- npx -y @solidrpc/agent
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.agent-toolkit]
command = "npx"
args = ["-y", "@solidrpc/agent"]

[mcp_servers.agent-toolkit.env]
SOLIDRPC_TOKEN_FILE = "<SOLIDRPC_TOKEN_FILE>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'SOLIDRPC_TOKEN_FILE=<SOLIDRPC_TOKEN_FILE>' agent-toolkit npx -- -y @solidrpc/agent
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "agent-toolkit": {
      "command": "npx",
      "args": [
        "-y",
        "@solidrpc/agent"
      ],
      "env": {
        "SOLIDRPC_TOKEN_FILE": "<SOLIDRPC_TOKEN_FILE>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `SOLIDRPC_TOKEN_FILE` | yes | no | Absolute path to a private file containing only your sa_ management token. Requires Node.js 22.20.0 or newer. |

## FAQ

### How can I run the SolidRPC MCP server locally?

You can start the local MCP server by running the command `solidrpc mcp` after installing the package via npm.

### Can I use the MCP server in a read-only mode?

Yes, you can set the `SOLIDRPC_READ_ONLY=1` environment variable to enforce a locally read-only session that blocks mutations and credential operations.

### What tools are exposed by the MCP server?

The server provides tools for network discovery, RPC key management (listing, creation, revocation), usage monitoring, billing, top-up quotes, and support ticket creation.

### Does the toolkit handle wallet keys or payments automatically?

No, the toolkit does not hold wallet keys or perform automatic payments; users must follow external wallet flows to fund accounts.