starknet MCP Server

Use This MCP server To

Query Starknet blockchain blocks with transaction hashes or full transactions Retrieve transaction status, receipts, and details by hash or block index Fetch state updates and storage values from the Starknet blockchain Access Starknet chain metadata like chain ID, spec version, and syncing status Extract blockchain events for analysis or monitoring Get nonce and class information for smart contract interactions Integrate Starknet blockchain data into AI workflows via MCP

README

starknet-mcp

MCP server for Starknet. Makes the following Starknet RPC method available through MCP:

starknet_getBlockWithTxHashes
starknet_getBlockWithTxs
starknet_getBlockWithReceipts
starknet_getStateUpdate
starknet_getStorageAt
starknet_getTransactionStatus
starknet_getTransactionByHash
starknet_getTransactionByBlockIdAndIndex
starknet_getTransactionReceipt
starknet_getClass
starknet_getClassHashAt
starknet_getClassAt
starknet_getBlockTransactionCount
starknet_call
starknet_getEvents
starknet_getNonce
starknet_blockNumber
starknet_blockHashAndNumber
starknet_chainId
starknet_syncing
starknet_specVersion

Write methods are not yet supported.

Installation

Install Bun. Clone this repo. Install the dependencies with bun install. Update Claude's MCP config - see instructions for your particular OS. You'll want something like this in the claude_desktop_config.json file:

{
  "mcpServers": {
    "starknet": {
      "command": "bun",
      "args": ["/PATH/TO/THIS/REPO/starknet-mcp/index.ts"],
      "env": {
        "STARKNET_RPC_URL": "https://starknet-mainnet.public.blastapi.io/rpc/v0_7"
      }
    }
  }
}

Usage

After correctly configuring Claude Desktop, it will have access to all the available methods. You can start asking Claude questions about the state of the chain, e.g. "What is the latest block hash and number on Starknet?". If Claude determines it has to use an MCP method to answer your question, it will ask you for permissions:

Claude asking for MCP permissions

You'll see the used method, its input and output inline in the chat.

Claude showing output after using starknet-mcp

Quirks

Methods starknet_estimateFee and starknet_estimateMessageFee are not yet supported.

Claude doesn't 100% follow the tool inputSchema. It prefers sending strings over anything else. Some of this is prevented in the code, but if you encounter any error, please open an issue.

starknet-mcp FAQ

How do I install starknet-mcp?

Install Bun, clone the repository, run 'bun install' to install dependencies, then start the server.

Does starknet-mcp support write operations on Starknet?

No, currently only read-only RPC methods are supported; write methods are not yet implemented.

Can I use starknet-mcp with different LLM providers?

Yes, starknet-mcp works with any MCP-compatible LLM host, including OpenAI, Claude, and Gemini.

What Starknet RPC methods does starknet-mcp expose?

It exposes methods like starknet_getBlockWithTxHashes, starknet_getTransactionStatus, starknet_getEvents, and more read-only blockchain queries.

Is starknet-mcp suitable for real-time blockchain data querying?

Yes, it provides real-time access to Starknet blockchain data via MCP for dynamic AI workflows.

How do I update the model context with starknet-mcp data?

Use the MCP client to fetch data from starknet-mcp and feed it into your LLM context dynamically.

What are the prerequisites for running starknet-mcp?

You need Bun installed and a compatible MCP host environment to integrate with the server.