Katana Foundry MCP Server

What it does

The Katana Development Starter Kit ships a Foundry MCP server that connects AI coding tools directly to the Katana blockchain development workflow. Once configured, your AI can interact with Foundry's full toolkit — compiling contracts, running tests, deploying to local forks or live chains, and querying on-chain state — without leaving the chat interface.

Katana is a high-performance EVM chain (Chain ID 747474, 1-second block times) designed for DeFi money legos. The starter kit also supports Bokuto, Katana's testnet.

Tools

• call-contract — Call any deployed contract function on the active chain or local fork
• check-balance — Query ETH or token balances for any address
• start-anvil — Start a local Anvil fork of Katana mainnet or Bokuto testnet
• stop-anvil — Stop the running Anvil instance
• create-contract — Scaffold and deploy a new smart contract
• deploy-contract — Deploy a compiled Foundry contract to local, Bokuto, or Katana
• run-forge-test — Execute the Foundry test suite
• forge-build — Compile all contracts in the forge workspace

Installation

First, build the MCP server from the starter kit:

git clone https://github.com/katana-network/specialk
cd specialk
bun install
bun run build:all

Then add to your Cursor config at .cursor/mcp.json:

{
  "mcpServers": {
    "foundry": {
      "command": "bun run",
      "args": ["/absolute/path/to/specialk/dist-mcp/index.js"],
      "env": {
        "PRIVATE_KEY": "0xYourPrivateKeyHere",
        "RPC_URL": "http://localhost:8545"
      }
    }
  }
}

Start a local chain before use:

bun run start:anvil bokuto

Supported hosts

Cursor (confirmed in README). The stdio MCP server should also work with any MCP-compatible client that supports stdio transport.