{
  "markdown": "# Interzoid MCP Server\n\nAn MCP (Model Context Protocol) server that exposes [Interzoid](https://interzoid.com)'s AI-powered data quality, matching, enrichment, and standardization APIs to AI agents and LLM applications.\n\n## What This Does\n\nThis 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.\n\n### Available APIs (58 Tools)\n\n| Category | Tools | Price (x402 USDC) |\n|---|---|---|\n| **Data Matching** (10) | Similarity keys and match scores for company names, individual names, US and global addresses, products, plus combined keys (company+address, name+address, company+name) for high-precision deduplication | $0.01/call |\n| **Company Intelligence** (13) | Business info, parent company, executives, recent news, verification, industry codes (NAICS/SIC), competitor analysis, buying signals, private company deal intel, ESG profile, government contracts, facilities profile, tech stack | $0.25/call |\n| **Contact & Identity** (3) | Email trust score, IP address profile, phone number profile | $0.25/call |\n| **Financial & Market** (2) | Stock analysis by ticker, municipal issuer profile | $0.25/call |\n| **Property & Location** (3) | Commercial building profile, property transaction history, nearest coffee shops | $0.25/call |\n| **Tax & Regulatory** (4) | US sales & use tax rates, IRS per diem rates, European VAT rates, customs duty rates by HS code | $0.25-$0.35/call |\n| **Research & Lookup** (2) | University and college info, product recall information | $0.25/call |\n| **X / Twitter** (3) | Find X handle for any entity, profile snapshot by handle, last three posts by handle | $0.05/call |\n| **Custom & Identity Resolution** (2) | AI custom self-defined data enrichment (you define the output fields), official legal organization name resolution for KYB and compliance | $0.25/call |\n| **Data Standardization** (5) | Organization, country, country info, city, state abbreviation | $0.01/call |\n| **Data Enhancement** (7) | Entity type, gender, name origin, language ID, translation (to English & any language), address parsing | $0.01/call |\n| **Utility** (4) | Global weather, currency exchange rates, ZIP code info, global page latency measurement | $0.01/call |\n\n## Getting Started\n\n### Option 1: Use the Hosted Remote Server (no installation required)\n\nConnect any MCP client that supports remote HTTP servers to:\n\n```\nhttps://mcp.interzoid.com/mcp\n```\n\nPass your API key via the `Authorization` header:\n\n```\nAuthorization: Bearer your-api-key-here\n```\n\nGet a free API key at [interzoid.com](https://www.interzoid.com/register-api-account) to get started.\n\n### Option 2: Download a Prebuilt Binary (no Go required)\n\nDownload the binary for your platform from the [GitHub Releases](https://github.com/interzoid/interzoid-mcp-server/releases) page:\n\n- **Windows:** `interzoid-mcp-server-windows-amd64.exe`\n- **macOS (Apple Silicon):** `interzoid-mcp-server-macos-arm64`\n- **Linux:** `interzoid-mcp-server-linux-amd64`\n\nThen configure your MCP client to run it (see [Client Configuration](#client-configuration) below).\n\n### Option 3: Build from Source\n\nRequires Go 1.23+:\n\n```bash\ngit clone https://github.com/interzoid/interzoid-mcp-server.git\ncd interzoid-mcp-server\ngo mod tidy\ngo build -o interzoid-mcp-server .\n```\n\n## Authentication\n\nThere are three ways to authenticate, depending on how you're using the server:\n\n### 1. API Key via Environment Variable (local installations)\n\nSet `INTERZOID_API_KEY` in your MCP client config. This is the standard method when running the binary locally.\n\n```bash\nexport INTERZOID_API_KEY=\"your-api-key-here\"\n./interzoid-mcp-server\n```\n\n### 2. API Key via Authorization Header (remote/hosted server)\n\nWhen connecting to the hosted server at `https://mcp.interzoid.com/mcp` or any remote deployment, pass your API key in the `Authorization` header:\n\n```\nAuthorization: Bearer your-api-key-here\n```\n\nThe MCP server forwards this to the Interzoid API via the `x-api-key` header.\n\n### 3. x402 USDC Micropayments (no API key needed)\n\nWhen no API key is provided by either method above, requests trigger the [x402 payment protocol](https://x402.org). 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.\n\n### Where to Get an API Key\n\nSign up for a free API key at [interzoid.com/register-api-account](https://www.interzoid.com/register-api-account). Keys work with both the local binary (via environment variable) and the remote server (via Authorization header).\n\n## Client Configuration\n\n### Cursor\n\n**One-click install:** Use the install button on the [Interzoid MCP Server page](https://www.interzoid.com/mcp-server#cursor), or copy this deep link into your browser:\n\n```\ncursor://anysphere.cursor-deeplink/mcp/install?name=Interzoid&config=eyJ1cmwiOiJodHRwczovL21jcC5pbnRlcnpvaWQuY29tL21jcCJ9\n```\n\nOr manually add to `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global):\n\n```json\n{\n  \"mcpServers\": {\n    \"interzoid\": {\n      \"url\": \"https://mcp.interzoid.com/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\nThe `headers` block is optional. Omit it to use x402 USDC micropayments instead of an API key.\n\n### Claude Code\n\nRun in your terminal:\n\n```bash\nclaude mcp add --transport http interzoid https://mcp.interzoid.com/mcp --header \"Authorization: Bearer your-api-key-here\"\n```\n\nThe `--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.\n\n### OpenAI Codex\n\nRun in your terminal (works for Codex CLI, the IDE extension, and the Codex app, which share the same configuration):\n\n```bash\ncodex mcp add interzoid --url https://mcp.interzoid.com/mcp --bearer-token-env-var INTERZOID_API_KEY\n```\n\nThen set the `INTERZOID_API_KEY` environment variable to your API key. Or edit `~/.codex/config.toml` directly:\n\n```toml\n[mcp_servers.interzoid]\nurl = \"https://mcp.interzoid.com/mcp\"\nbearer_token_env_var = \"INTERZOID_API_KEY\"\n```\n\nRun `/mcp` inside Codex to verify the server is connected.\n\n### Gemini CLI\n\nRun in your terminal:\n\n```bash\ngemini mcp add -t http interzoid https://mcp.interzoid.com/mcp\n```\n\nOr manually add to `~/.gemini/settings.json` (global) or `.gemini/settings.json` (project):\n\n```json\n{\n  \"mcpServers\": {\n    \"interzoid\": {\n      \"httpUrl\": \"https://mcp.interzoid.com/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\nRun `/mcp` inside Gemini CLI to verify the connection.\n\n### VS Code\n\nOpen the Command Palette (`Ctrl+Shift+P` / `⌘+Shift+P`), select **MCP: Open User Configuration**, and add:\n\n```json\n{\n  \"servers\": {\n    \"interzoid\": {\n      \"url\": \"https://mcp.interzoid.com/mcp\",\n      \"type\": \"http\"\n    }\n  }\n}\n```\n\n### Windsurf\n\nAdd to `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"interzoid\": {\n      \"serverUrl\": \"https://mcp.interzoid.com/mcp\"\n    }\n  }\n}\n```\n\n### Claude Desktop\n\n**Remote server (Pro/Max/Team/Enterprise):** Go to **Settings > Connectors > Add Custom Connector** and enter `https://mcp.interzoid.com/mcp`.\n\n**Local binary:** Add to `claude_desktop_config.json` (macOS: `~/Library/Application Support/Claude/`, Windows: `%APPDATA%\\Claude\\`):\n\n```json\n{\n  \"mcpServers\": {\n    \"interzoid\": {\n      \"command\": \"/path/to/interzoid-mcp-server\",\n      \"env\": {\n        \"INTERZOID_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n### Other MCP Clients\n\nPoint any MCP-compatible client to the hosted remote server:\n\n```\nhttps://mcp.interzoid.com/mcp\n```\n\nThe 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.\n\n## Example Interactions\n\nOnce configured, AI agents can chain the tools into complete workflows:\n\n> **User:** \"Here are 40 customer records. Find the duplicates even where names are spelled differently.\"\n> **Agent uses:** `interzoid_company_match_advanced` on each record, then groups rows sharing a similarity key\n> **Result:** A duplicate report with 'IBM', 'I.B.M.', and 'International Business Machines' correctly clustered\n\n> **User:** \"Build me a briefing on Databricks before my call tomorrow.\"\n> **Agent uses:** `interzoid_business_info`, `interzoid_buying_signals`, `interzoid_competitor_analysis`, `interzoid_private_company_deal_intel`\n> **Result:** Revenue, funding history, competitors, and current buying signals in one briefing\n\n> **User:** \"Is 'Mitsubishi UFJ' a legitimate entity? Get me the official legal name and registry details.\"\n> **Agent uses:** `interzoid_official_name`, `interzoid_company_verification`\n> **Result:** Official legal name, registry identifier, incorporation country, verification score, and an authoritative source URL\n\n> **User:** \"What's the combined sales tax rate at our new Beverly Hills store? And the duty rate for importing laptops into Germany?\"\n> **Agent uses:** `interzoid_sales_use_tax_rates`, `interzoid_customs_duty_rates` (HS code 8471.30)\n> **Result:** Rate breakdowns by jurisdiction, plus MFN duty rates and import VAT\n\n> **User:** \"For each city on this list, get me life expectancy, flu vaccination coverage, and diabetes rate.\"\n> **Agent uses:** `interzoid_custom_data` with topic \"healthcare data by city\" and self-defined output fields\n> **Result:** Structured JSON with exactly the fields you asked for, for any subject domain\n\n## Self-Hosting the Remote Server\n\nTo host your own remote instance:\n\n```bash\n./interzoid-mcp-server -transport http -port 8080\n```\n\nThe 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.\n\n## x402 Payment Integration\n\nInterzoid APIs support the [x402 protocol](https://x402.org) for native USDC micropayments. When accessed without an API key:\n\n- **Standard APIs:** 10,000 atomic USDC ($0.01) per call\n- **X/Twitter APIs:** 50,000 atomic USDC ($0.05) per call\n- **Premium APIs:** 250,000 atomic USDC ($0.25) per call\n- **Customs Duty API:** 350,000 atomic USDC ($0.35) per call\n- **Network:** Base (EIP-155:8453)\n- **Asset:** USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)\n\nThe `.well-known/x402.json` manifest at `https://api.interzoid.com/.well-known/x402.json` provides full machine-readable discovery for x402 clients.\n\n## Project Structure\n\n```\ninterzoid-mcp-server/\n├── main.go        # Entry point, transport selection (stdio/HTTP)\n├── tools.go       # MCP tool registration for all 58 APIs\n├── client.go      # HTTP client for calling api.interzoid.com\n├── go.mod         # Go module definition\n└── README.md      # This file\n```\n\n## License\n\nMIT",
  "bytes": 11129,
  "sha": "8c30dcd5b5eed77eaf3ad427fb125a5de7b24cc55d3b5193b809766604c6a0f7",
  "repo_slug": "interzoid/interzoid-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_interzoid_mcp_server_13684a6f/readme"
}