Connect OnchainAI MCP

Add the OnchainAI search MCP server to your agent or editor. Each client has its own install path below.

Universal install

$ npx add-mcp https://www.onchain-ai.xyz/mcp

Official endpoint: https://www.onchain-ai.xyz/mcp

The only official OnchainAI MCP endpoint is https://www.onchain-ai.xyz/mcp.

MCP clients

Claude Code

  • Install Claude Code if needed: npm install -g @anthropic-ai/claude-code
  • Run the command below from your project directory.
  • Type /mcp in Claude Code to authenticate if required.
$ claude mcp add --transport http onchainai https://www.onchain-ai.xyz/mcp

Claude Desktop and Web

  • Open Settings → Connectors → Add custom connector.
  • Name: OnchainAI. URL: the MCP endpoint below.
  • Enable the connector in Claude Desktop or claude.ai.
https://www.onchain-ai.xyz/mcp

Cursor

  • Use Add to Cursor for one-click install, or add the JSON to .cursor/mcp.json.
  • Reload MCP after saving the config.
Add to Cursor
{ "mcpServers": { "onchainai": { "url": "https://www.onchain-ai.xyz/mcp" } } }

VS Code Copilot

  • Click Add to VS Code or run MCP: Add Server → HTTP.
  • URL: endpoint below. Name: OnchainAI.
  • Start the server from MCP: List Servers.
Add to VS Code
https://www.onchain-ai.xyz/mcp

Codex CLI

  • Install Codex CLI: npm i -g @openai/codex
  • Run the command below to register OnchainAI MCP.
  • Complete OAuth in the browser when Codex prompts you.
$ codex mcp add onchainai --url https://www.onchain-ai.xyz/mcp

Windsurf

  • Add the JSON snippet to your Windsurf mcp_config.json.
  • Restart Windsurf Cascade to load the server.
{ "mcpServers": { "onchainai": { "serverUrl": "https://www.onchain-ai.xyz/mcp" } } }

Gemini CLI and Code Assist

  • Add the JSON to ~/.gemini/settings.json under mcpServers.
  • Restart your IDE or Gemini CLI and authenticate when prompted.
{ "mcpServers": { "onchainai": { "command": "npx", "args": [ "mcp-remote", "https://www.onchain-ai.xyz/mcp" ] } } }

ChatGPT

  • Enable Developer mode (Settings → Connectors → Advanced settings).
  • Create a connector with Name OnchainAI and the MCP URL below.
  • Invoke the connector from Developer mode in chat.
https://www.onchain-ai.xyz/mcp

Generic MCP

  • Use the universal installer for any detected agent, or paste the JSON into your client.
  • Official endpoint URL is listed below.
$ npx add-mcp https://www.onchain-ai.xyz/mcp

HTTP config

  • Paste into clients that accept mcpServers JSON.
{ "mcpServers": { "onchainai": { "url": "https://www.onchain-ai.xyz/mcp" } } }