MCP server that gives AI assistants access to Midnight blockchain—search contracts, analyze code, and explore documentation.

Add to your claude_desktop_config.json:

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

Add to Cursor's MCP settings (Settings → MCP → Add Server):

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

Or add to .cursor/mcp.json in your project:

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

Add to ~/.codeium/windsurf/mcp_config.json:

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

Restart your editor after adding the config. All features work out of the box—no API keys or setup required.

By default, the MCP uses a hosted API for semantic search:

• ✅ Zero configuration — just install and use
• ✅ Semantic search works immediately
• ✅ No API keys needed

Run everything locally for privacy or offline use:

{
  "mcpServers": {
    "midnight": {
      "command": "npx",
      "args": ["-y", "midnight-mcp"],
      "env": {
        "MIDNIGHT_LOCAL": "true",
        "OPENAI_API_KEY": "sk-...",
        "CHROMA_URL": "http://localhost:8000"
      }
    }
  }
}

Local mode requires ChromaDB (docker run -d -p 8000:8000 chromadb/chroma) and an OpenAI API key.

Add "GITHUB_TOKEN": "ghp_..." for higher GitHub API rate limits (60 → 5000 requests/hour).

• midnight://docs/* — Documentation (Compact reference, SDK API, ZK concepts)
• midnight://code/* — Examples, patterns, and templates
• midnight://schema/* — AST, transaction, and proof schemas

• midnight:create-contract — Create new contracts
• midnight:review-contract — Security review
• midnight:explain-concept — Learn Midnight concepts
• midnight:compare-approaches — Compare implementation approaches
• midnight:debug-contract — Debug issues

For contributors:

git clone https://github.com/Olanetsoft/midnight-mcp.git
cd midnight-mcp
npm install
npm run build
npm test

To test against a local API server instead of production:

# Terminal 1: Start local API
cd api
npm install
npm run dev  # Starts at http://localhost:8787

# Terminal 2: Run MCP with local API
MIDNIGHT_API_URL=http://localhost:8787 npm start

The hosted API runs on Cloudflare Workers + Vectorize. See api/README.md for deployment and development instructions.

MIT

• Midnight Docs
• MCP Spec
• Midnight GitHub