Interzoid MCP Server

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 58 Interzoid APIs discoverable and callable by any MCP-compatible client including Claude Desktop, Claude Code, Cursor, OpenAI Codex, Gemini CLI, VS Code, Windsurf, and other AI tools. AI agents can discover the available data quality and enrichment tools and invoke them as needed during conversations and workflows.

Available APIs (58 Tools)

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.23+:

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

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).

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 (project) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "interzoid": {
      "url": "https://mcp.interzoid.com/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key-here"
      }
    }
  }
}

The headers block is optional. Omit it to use x402 USDC micropayments instead of an API key.

Claude Code

Run in your terminal:

claude mcp add --transport http interzoid https://mcp.interzoid.com/mcp --header "Authorization: Bearer your-api-key-here"

The --header flag is optional. Omit it to use x402 USDC micropayments instead of an API key. Then use /mcp in Claude Code to verify the connection.

OpenAI Codex

Run in your terminal (works for Codex CLI, the IDE extension, and the Codex app, which share the same configuration):

codex mcp add interzoid --url https://mcp.interzoid.com/mcp --bearer-token-env-var INTERZOID_API_KEY

Then set the INTERZOID_API_KEY environment variable to your API key. Or edit ~/.codex/config.toml directly:

[mcp_servers.interzoid]
url = "https://mcp.interzoid.com/mcp"
bearer_token_env_var = "INTERZOID_API_KEY"

Run /mcp inside Codex to verify the server is connected.

Gemini CLI

Run in your terminal:

gemini mcp add -t http interzoid https://mcp.interzoid.com/mcp

Or manually add to ~/.gemini/settings.json (global) or .gemini/settings.json (project):

{
  "mcpServers": {
    "interzoid": {
      "httpUrl": "https://mcp.interzoid.com/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key-here"
      }
    }
  }
}

Run /mcp inside Gemini CLI 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.

Example Interactions

Once configured, AI agents can chain the tools into complete workflows:

User: "Here are 40 customer records. Find the duplicates even where names are spelled differently." Agent uses: interzoid_company_match_advanced on each record, then groups rows sharing a similarity key Result: A duplicate report with 'IBM', 'I.B.M.', and 'International Business Machines' correctly clustered

User: "Build me a briefing on Databricks before my call tomorrow." Agent uses: interzoid_business_info, interzoid_buying_signals, interzoid_competitor_analysis, interzoid_private_company_deal_intel Result: Revenue, funding history, competitors, and current buying signals in one briefing

User: "Is 'Mitsubishi UFJ' a legitimate entity? Get me the official legal name and registry details." Agent uses: interzoid_official_name, interzoid_company_verification Result: Official legal name, registry identifier, incorporation country, verification score, and an authoritative source URL

User: "What's the combined sales tax rate at our new Beverly Hills store? And the duty rate for importing laptops into Germany?" Agent uses: interzoid_sales_use_tax_rates, interzoid_customs_duty_rates (HS code 8471.30) Result: Rate breakdowns by jurisdiction, plus MFN duty rates and import VAT

User: "For each city on this list, get me life expectancy, flu vaccination coverage, and diabetes rate." Agent uses: interzoid_custom_data with topic "healthcare data by city" and self-defined output fields Result: Structured JSON with exactly the fields you asked for, for any subject domain

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

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

• Standard APIs: 10,000 atomic USDC ($0.01) per call
• X/Twitter APIs: 50,000 atomic USDC ($0.05) per call
• Premium APIs: 250,000 atomic USDC ($0.25) per call
• Customs Duty API: 350,000 atomic USDC ($0.35) 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 58 APIs
├── client.go      # HTTP client for calling api.interzoid.com
├── go.mod         # Go module definition
└── README.md      # This file

License

MIT