OpenRPC

v1.0.0Developer Toolsstable

A Model Context Protocol (MCP) server that provides JSON-RPC functionality through OpenRPC.

openrpc-mpcmcpai-integration
Share:
43
Stars
0
Downloads
0
Weekly
0/5

What is OpenRPC?

OpenRPC is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol (mcp) server that provides json-rpc functionality through openrpc.

A Model Context Protocol (MCP) server that provides JSON-RPC functionality through OpenRPC.

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A Model Context Protocol (MCP) server that provides JSON-RPC

Use Cases

Execute JSON-RPC methods
Interface with blockchain services
shanejonas

Maintainer

LicenseApache 2.0
Languagejavascript
Versionv1.0.0
UpdatedJan 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx openrpc-mpc

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use OpenRPC

The OpenRPC MCP server bridges the Model Context Protocol with the JSON-RPC ecosystem, letting AI models discover and call arbitrary JSON-RPC methods on any server using the OpenRPC specification. It exposes two core tools — one for calling specific RPC methods and one for discovering all methods a target server offers — making it straightforward for Claude to interact with Ethereum nodes, other blockchain RPC endpoints, or any JSON-RPC 2.0 compatible service. Developers working with Web3 infrastructure or custom JSON-RPC APIs can use this server to give their AI assistant direct programmatic access to those services.

Prerequisites

  • Node.js 16 or higher and npm installed
  • npx available in your PATH
  • An MCP-compatible client such as Claude Desktop
  • Access to a JSON-RPC server URL you want to interact with (e.g. an Ethereum node endpoint)
1

Clone the repository

Clone the openrpc-mcp-server repository from GitHub.

git clone https://github.com/shanejonas/openrpc-mcp-server.git
cd openrpc-mcp-server
2

Install dependencies

Install the Node.js dependencies using npm.

npm install
3

Build the server

Compile the TypeScript source to JavaScript.

npm run build
4

Configure Claude Desktop

Add the server to your Claude Desktop configuration using npx with the published package name.

{
  "mcpServers": {
    "openrpc": {
      "command": "npx",
      "args": ["-y", "openrpc-mcp-server"]
    }
  }
}
5

Restart Claude Desktop

Fully quit and reopen Claude Desktop. The OpenRPC server should appear in the MCP tools list with rpc_call and rpc_discover available.

6

Debug with MCP Inspector (optional)

During development, use the MCP Inspector to test calls interactively before using the server from Claude Desktop.

npm run inspector

OpenRPC Examples

Client configuration

Complete claude_desktop_config.json block for the OpenRPC MCP server.

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

Prompts to try

Example prompts for using the OpenRPC MCP server to interact with JSON-RPC services.

- "Discover all available JSON-RPC methods on the server at https://mainnet.infura.io/v3/YOUR_KEY."
- "Call eth_blockNumber on https://mainnet.infura.io/v3/YOUR_KEY and tell me the current Ethereum block height."
- "Call eth_getBalance for address 0xAbCd...1234 on the Ethereum mainnet RPC."
- "What methods does this OpenRPC service expose? Fetch its service discovery document from https://example-rpc.com."
- "Call the net_version method on https://mainnet.infura.io/v3/YOUR_KEY to check which Ethereum network I'm connected to."

Troubleshooting OpenRPC

npx openrpc-mcp-server fails or resolves the wrong package

Use 'npx -y openrpc-mcp-server' to ensure the correct published package is used. Alternatively, build from source and point the config to the absolute path of the built index.js file: 'node /path/to/openrpc-mcp-server/build/index.js'.

rpc_call returns an error for a valid method

Verify the target server URL is correct and accessible from your machine. Check that the method name matches exactly what rpc_discover returns — JSON-RPC method names are case-sensitive. Also confirm the parameters format matches the method's schema.

rpc_discover returns an empty or minimal method list

Not all JSON-RPC servers implement OpenRPC service discovery. If the server does not expose a 'rpc.discover' method, the tool cannot auto-enumerate methods. In that case, you will need to call rpc_call directly with known method names.

Frequently Asked Questions about OpenRPC

What is OpenRPC?

OpenRPC is a Model Context Protocol (MCP) server that model context protocol (mcp) server that provides json-rpc functionality through openrpc. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install OpenRPC?

Follow the installation instructions on the OpenRPC GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with OpenRPC?

OpenRPC works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is OpenRPC free to use?

Yes, OpenRPC is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "openrpc-mpc": { "command": "npx", "args": ["-y", "openrpc-mpc"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use OpenRPC?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides