Orquscan MCP Server

A Model Context Protocol (MCP) server that lets AI assistants query blockchain data from the Orqus chain via Orquscan APIs.

Available Tools

| Tool | Description | |------|-------------| | get_balance | Get native and token balances for an address | | get_address_info | Get basic info about an address (contract status) | | get_address_transactions | Get recent transactions for an address | | get_block | Get block details by number | | get_latest_blocks | Get most recent blocks | | get_transaction | Get transaction details by hash | | get_latest_transactions | Get most recent transactions | | get_token_info | Get token details or list top tokens | | get_token_holders | Get top holders of a token | | get_contract_source | Get verified contract source code and ABI | | get_verified_contracts | List verified smart contracts | | search | Search for addresses, transactions, blocks, or tokens | | get_gas_price | Get current gas price estimates | | get_validators | Get validator list with status | | get_chain_stats | Get chain overview stats | | get_chart_data | Get historical chart data |

Setup

npm install
npm run build

Usage with Claude Code

Add to your Claude Code MCP config (~/.claude/claude_desktop_config.json or project .mcp.json):

{
  "mcpServers": {
    "orquscan": {
      "command": "node",
      "args": ["/path/to/orquscan-mcp/dist/index.js"],
      "env": {
        "ORQUSCAN_API_URL": "https://api.orquscan.io/api/v2"
      }
    }
  }
}

Or if published to npm:

{
  "mcpServers": {
    "orquscan": {
      "command": "npx",
      "args": ["@orqusio/mcp-server"]
    }
  }
}

Usage with Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "orquscan": {
      "command": "node",
      "args": ["/path/to/orquscan-mcp/dist/index.js"]
    }
  }
}

Usage with ChatGPT (SSE transport)

Start the SSE server:

npm run start:sse

Then connect using the SSE endpoint: http://localhost:3100/sse

Docker Deployment

docker build -t orquscan-mcp .
docker run -p 3100:3100 \
  -e ORQUSCAN_API_URL=https://api.orquscan.io/api/v2 \
  -e ORQUSCAN_CONTRACTS_URL=https://contracts.orquscan.io \
  orquscan-mcp

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | ORQUSCAN_API_URL | https://api.orquscan.io/api/v2 | Base URL for the orqus-stats v2 API | | ORQUSCAN_CONTRACTS_URL | https://contracts.orquscan.io | Base URL for the contract verification API | | ORQUSCAN_CHAIN_ID | 153871 | Chain ID for contract verification lookups | | PORT | 3100 | Port for SSE HTTP server |

Development

npm run dev     # Run with tsx (hot reload)
npm run build   # Compile TypeScript
npm start       # Run stdio transport
npm run start:sse  # Run SSE HTTP transport