Interzoid

You can run and connect to the Interzoid MCP Server to discover and invoke 29 AI-powered data quality, matching, enrichment, and standardization tools from any MCP-compatible client. This server lets you expose Interzoid APIs to AI agents and workflows with secure authentication and flexible hosting options, including a hosted remote endpoint or a self-hosted local binary.

How to use

You will connect your MCP client to either the hosted endpoint or a local server, then use the available tools to perform data matching, enrichment, standardization, enhancement, and utility tasks. With a valid API key, you can invoke functions such as organization matches, business information lookups, translations, weather, currency, and ZIP code data. Start by choosing your hosting option, then configure your MCP client with the appropriate URL and authentication method.

How to install

Prerequisites: you should have Git and Go installed, since you can build from source. If you prefer not to compile, you can use the prebuilt binaries for your platform.

# Option A: Install and run from source
# 1) Clone the repository
git clone https://github.com/interzoid/interzoid-mcp-server.git
cd interzoid-mcp-server

# 2) Tidy dependencies and build
go mod tidy
go build -o interzoid-mcp-server .

# Option B: Use a prebuilt binary
# Windows
interzoid-mcp-server-windows-amd64.exe

# macOS (Apple Silicon)
interzoid-mcp-server-macos-arm64

# Linux
interzoid-mcp-server-linux-amd64

Additional setup steps for self-hosting

If you choose to self-host, you can run the server locally and expose it via HTTP. Use the final start command shown below to ensure the MCP endpoint is available at the expected address.

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

Where to get an API key and how to authenticate

Sign up for a free API key to use the hosted server or to run the server locally with an API key. When using the hosted endpoint, pass the key in the Authorization header. When running locally, you can set the key in your environment so the local server forwards it to the Interzoid APIs.

Examples of common tasks you can perform

You can perform company and organization matching, extract business information, translate text, and retrieve weather, currency, and ZIP data. These actions map to the 29 available tools and are invoked through your MCP client by referencing the tool names like interzoid_org_match_score, interzoid_business_info, interzoid_translate_to_english, and similar.

Typical usage flows involve looking up a company by name, translating text, or enriching a record with verified business details. Your MCP client will handle the orchestration by calling the appropriate tool endpoints and presenting results in your dialog or workflow.

Security and payments overview

The server supports API key authentication for standard and hosted usage. If no API key is provided, requests may trigger the x402 crypto micropayments flow, with payments negotiated in USDC on the Base network. Ensure you understand the pricing model for the APIs you plan to use.

Configuration notes

Configure your MCP client with the correct server URL and authentication method. For the hosted server, use the URL https://mcp.interzoid.com/mcp and set Authorization: Bearer your-api-key-here. For self-hosted deployments, provide the path or URL to your self-hosted endpoint and ensure the Authorization header is forwarded appropriately.

Troubleshooting tips

If you cannot reach the MCP endpoint, verify network access to the host, confirm the server is running, and ensure the correct port is exposed. Check that the API key is valid and that the Authorization header is sent with each request when using the hosted server. For self-hosted setups, confirm that the server is listening on the expected port and that any reverse proxy configuration forwards requests to the MCP server correctly.

Available tools

interzoid_org_match_score

Compute a similarity score for organizational names and entities to determine if two records refer to the same organization.

interzoid_company_match

Match two company names to verify if they refer to the same company and return a match score.

interzoid_name_match

Compare two person or entity names and return a similarity score indicating potential equivalence.

interzoid_address_match

Assess whether two addresses refer to the same location and return a similarity score.

interzoid_global_address

Provide a global address normalization and matching capability to standardize addresses across regions.

interzoid_product_match

Match product identifiers or names to determine equivalence across datasets.

interzoid_business_info

Retrieve business information such as headquarters, revenue, employees, and industry for a given lookup.

interzoid_parent_company

Identify and return information about a parent company for a given entity.

interzoid_executives

Fetch information about executives associated with a company or organization.

interzoid_news

Provide recent news or press information related to a company or organization.

interzoid_email_trust

Assess the trustworthiness or confidence of an email address based on data signals.

interzoid_stock

Retrieve stock information for a company when available.

interzoid_verification

Verify data quality and correctness for given records.

interzoid_ip_profiles

Provide profiles related to IP addresses for enrichment and validation.

interzoid_phone_profiles

Provide profiles related to phone numbers for enrichment and validation.

interzoid_entity_type

Classify a record into a defined entity type (e.g., person, company, address).

interzoid_gender

Detect gender information based on names or other signals.

interzoid_name_origin

Infer likely name origin or ethnicity for given names.

interzoid_language_id

Identify the language of the provided text.

interzoid_translate_to_english

Translate text to English.

interzoid_translate

Translate text between languages.

interzoid_address_parsing

Parse and extract structured components from addresses.

interzoid_weather

Provide current weather information for a location.

interzoid_currency

Return exchange rates or currency information.

interzoid_zip_info

Retrieve ZIP code related information for a given location.