starknet-mcp-gateway

This component serves as an MCP server interface tailored for interacting with the Starknet network. It exposes a substantial collection of Starknet RPC endpoints for retrieval operations:

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

Functionality for submitting write operations is currently unavailable.

Deployment Instructions

Prerequisite: Install Bun. Clone the repository source. Execute bun install to fetch necessary dependencies. Configure your Claude Desktop environment by referencing the official documentation for your operating system. The configuration for claude_desktop_config.json should resemble the following structure, adjusting the path accordingly:

{
  "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"
      }
    }
  }
}

Operation

Once the integration with Claude Desktop is finalized, access to all listed methods is granted. You can then query the current ledger status, for instance, by asking, "What is the latest block hash and number on Starknet?". Should a query necessitate invoking an MCP method, Claude will prompt you for authorization:

Details regarding the utilized method, its input parameters, and the resulting output will be presented directly within the chat dialogue.

Known Limitations

Remote execution for starknet_estimateFee and starknet_estimateMessageFee is presently unimplemented.

Be advised that Claude exhibits a preference for transmitting all parameters as string types, deviating slightly from the strict schema validation. Although preventative coding measures are in place, if an execution failure arises, kindly file a bug report.