# Install Starknet MCP

> Install and configure the Starknet MCP server for Claude Code

- Skill: `starkware-libs/install-starknet-mcp` (Agent Skill)
- Install (CLI): `npx skillmds@latest add starkware-libs/install-starknet-mcp`
- Raw SKILL.md: https://api.skillmd.com/api/skills/starkware-libs/install-starknet-mcp/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: starkware-libs (https://skillmd.com/u/starkware-libs)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/starkware-libs/install-starknet-mcp

---


# Install Starknet MCP Server

Set up the Starknet MCP server so Claude can query a live Starknet node.

## Steps

1. The user should provide their Starknet JSON-RPC endpoint URL as `$ARGUMENTS`. If no argument was given, ask the user for their RPC URL. It must be a v0.10.2+ endpoint.

2. Install the Python dependencies:

   ```bash
   pip install -r mcp/requirements.txt
   ```

3. Ask the user which scope they want:

   - **Global** (`--scope user`) — available in all projects. Best if they work with Starknet across multiple repos. Requires using the absolute path to `mcp/server.py`.
   - **Project** (default) — available only in this repo. Uses a relative path.

4. Register the MCP server with Claude Code using the chosen scope. Note that `--env` must come **before** `--` so Claude sets it in the server's environment (anything after `--` is passed as argv to the server itself):

   - Global: `claude mcp add --scope user --env STARKNET_RPC_URL=<the-url> starknet -- python <absolute-path-to-server.py>`
   - Project: `claude mcp add --env STARKNET_RPC_URL=<the-url> starknet -- python mcp/server.py`

5. Verify the server is registered by running:

   ```bash
   claude mcp list
   ```

6. Tell the user the installation is complete and they should restart Claude Code for the new MCP server to take effect. List a few example prompts they can try:
   - "What's the latest block number on Starknet?"
   - "Get me the transaction receipt for 0x..."
   - "What's the ETH token total supply on Starknet?"