Interzoid MCP Server

An MCP (Model Context Protocol) server that exposes Interzoid's AI-powered data quality, matching, enrichment, and standardization APIs to AI agents and LLM applications.

What This Does

This MCP server makes 29 Interzoid APIs discoverable and callable by any MCP-compatible client including Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, and other AI tools. AI agents can discover the available data quality tools and invoke them as needed during conversations and workflows.

Available APIs (29 Tools)

Authentication

There are three ways to authenticate, depending on how you're using the server:

1. API Key via Environment Variable (local installations)

Set INTERZOID_API_KEY in your MCP client config. This is the standard method when running the binary locally.

export INTERZOID_API_KEY="your-api-key-here"
./interzoid-mcp-server

2. API Key via Authorization Header (remote/hosted server)

When connecting to the hosted server at https://mcp.interzoid.com/mcp or any remote deployment, pass your API key in the Authorization header:

Authorization: Bearer your-api-key-here

The MCP server forwards this to the Interzoid API via the x-api-key header.

3. x402 USDC Micropayments (no API key needed)

When no API key is provided by either method above, requests trigger the x402 payment protocol. The Interzoid API returns a 402 Payment Required response with payment requirements, and the calling agent/client handles payment negotiation using USDC on Base. No signup or API key is needed — just a compatible wallet.

Where to Get an API Key

Sign up for a free API key at interzoid.com/register-api-account. Keys work with both the local binary (via environment variable) and the remote server (via Authorization header).

Example Interactions

Once configured, AI agents can use the tools naturally:

User: "Check if 'IBM' and 'International Business Machines' are the same company" Agent uses: interzoid_org_match_score with org1="IBM", org2="International Business Machines" Result: Score: 98

User: "What can you tell me about Anthropic's business?" Agent uses: interzoid_business_info with lookup="Anthropic" Result: Headquarters, revenue, employees, industry, description

User: "Translate 'Bonjour le monde' to English" Agent uses: interzoid_translate_to_english with text="Bonjour le monde" Result: Translation: "Hello world"

Self-Hosting the Remote Server

To host your own remote instance:

./interzoid-mcp-server -transport http -port 8080

The MCP endpoint will be available at http://localhost:8080/mcp. Place behind Nginx or a load balancer with HTTPS for production use. Ensure proxy_buffering off is set in your Nginx config to support SSE streaming.

x402 Payment Integration

All Interzoid APIs support the x402 protocol for native USDC micropayments. When accessed without an API key:

• Standard APIs: 12,500 atomic USDC ($0.0125) per call
• Premium APIs: 312,500 atomic USDC ($0.3125) per call
• Network: Base (EIP-155:8453)
• Asset: USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)

The .well-known/x402.json manifest at https://api.interzoid.com/.well-known/x402.json provides full machine-readable discovery for x402 clients.

Project Structure

interzoid-mcp-server/
├── main.go        # Entry point, transport selection (stdio/HTTP)
├── tools.go       # MCP tool registration for all 29 APIs
├── client.go      # HTTP client for calling api.interzoid.com
├── go.mod         # Go module definition
└── README.md      # This file

License

MIT

Getting Started

Option 1: Use the Hosted Remote Server (no installation required)

Connect any MCP client that supports remote HTTP servers to:

https://mcp.interzoid.com/mcp

Pass your API key via the Authorization header:

Authorization: Bearer your-api-key-here

Get a free API key at interzoid.com to get started.

Option 2: Download a Prebuilt Binary (no Go required)

Download the binary for your platform from the GitHub Releases page:

• Windows: interzoid-mcp-server-windows-amd64.exe
• macOS (Apple Silicon): interzoid-mcp-server-macos-arm64
• Linux: interzoid-mcp-server-linux-amd64

Then configure your MCP client to run it (see Client Configuration below).

Option 3: Build from Source

Requires Go 1.21+:

git clone https://github.com/interzoid/interzoid-mcp-server.git
cd interzoid-mcp-server
go mod tidy
go build -o interzoid-mcp-server .

Client Configuration

Cursor

One-click install: Use the install button on the Interzoid MCP Server page, or copy this deep link into your browser:

cursor://anysphere.cursor-deeplink/mcp/install?name=Interzoid&config=eyJ1cmwiOiJodHRwczovL21jcC5pbnRlcnpvaWQuY29tL21jcCJ9

Or manually add to .cursor/mcp.json:

{
  "mcpServers": {
    "interzoid": {
      "url": "https://mcp.interzoid.com/mcp",
      "type": "http"
    }
  }
}

Claude Code

Run in your terminal:

claude mcp add --transport http interzoid https://mcp.interzoid.com/mcp

Then use /mcp in Claude Code to verify the connection.

VS Code

Open the Command Palette (Ctrl+Shift+P / ⌘+Shift+P), select MCP: Open User Configuration, and add:

{
  "servers": {
    "interzoid": {
      "url": "https://mcp.interzoid.com/mcp",
      "type": "http"
    }
  }
}

Windsurf

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

{
  "mcpServers": {
    "interzoid": {
      "serverUrl": "https://mcp.interzoid.com/mcp"
    }
  }
}

Claude Desktop

Remote server (Pro/Max/Team/Enterprise): Go to Settings > Connectors > Add Custom Connector and enter https://mcp.interzoid.com/mcp.

Local binary: Add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

{
  "mcpServers": {
    "interzoid": {
      "command": "/path/to/interzoid-mcp-server",
      "env": {
        "INTERZOID_API_KEY": "your-api-key-here"
      }
    }
  }
}

Other MCP Clients

Point any MCP-compatible client to the hosted remote server:

https://mcp.interzoid.com/mcp

The server supports Streamable HTTP transport. Pass your API key via the Authorization: Bearer your-api-key header, or use x402 USDC micropayments with no API key needed.