# Interzoid — how to use (mcp.ai)

Connect your Interzoid account and use 30 tools for analytics straight from your AI agent. Connect with your own API key. Interzoid offers APIs for data matching, verification, and enrichment, allowing developers to improve data quality and integrate real-time insights into applications.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_interzoid?ms=1787293380000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `interzoid_address_parse`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/interzoid`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/interzoid/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/interzoid/address/parse` — Tool to parse a free-form address into structured components. Use when you need to extract street, city, state, etc. from unstructured address strings.
  - body: { address: string, license: string }
- `POST https://api.mcp.ai/api/interzoid/email/trust/score` — Tool to return a trust score for an email address. Use when you need to assess the quality and legitimacy of an email address. Call after acquiring the target email.
  - body: { lookup: string, license?: string }
- `POST https://api.mcp.ai/api/interzoid/get/address/match/advanced` — Tool to generate a similarity key for a US street address. Use when performing fuzzy deduplication of addresses across datasets.
  - body: { address: string, license?: string, algorithm: string }
- `POST https://api.mcp.ai/api/interzoid/get/area/code` — Tool to retrieve telephone area code information including primary city and geographic locale. Use when you need to get details about a specific area code.
  - body: { license?: string, areacode: string, x_api_key?: string }
- `POST https://api.mcp.ai/api/interzoid/get/area/code/from/number` — Tool to get area code information from a telephone number. Use when you need to identify the geographic location or area code details for a given phone number.
  - body: { number: string, license?: string }
- `POST https://api.mcp.ai/api/interzoid/get/business/info` — Tool to retrieve comprehensive company profiles and business intelligence. Use when you need detailed company information by name, domain, or email.
  - body: { lookup: string, license?: string }
- `POST https://api.mcp.ai/api/interzoid/get/company/match/advanced` — Tool to generate a fuzzy-matching key for an organization name. Use when normalizing and deduplicating company names after extraction.
  - body: { company: string, license?: string, algorithm: string }
- `POST https://api.mcp.ai/api/interzoid/get/country/info` — Tool to standardize a country name and return metadata like ISO codes, currency, TLD, and calling code. Use when you need detailed country information based on a country name or code.
  - body: { country: string, license: string, algorithm: string }
- `POST https://api.mcp.ai/api/interzoid/get/currency/rate` — Tool to retrieve live USD exchange rate for a currency symbol. Use when you need current market rate for a three-letter ISO 4217 currency.
  - body: { symbol: string, license?: string }
- `POST https://api.mcp.ai/api/interzoid/get/custom/data` — Tool to retrieve custom enriched data based on a topic and lookup value. Use after specifying the desired output fields.
  - body: { model?: string, topic: string, lookup: string, output: string[], license?: string, x_api_key?: string }
- `POST https://api.mcp.ai/api/interzoid/get/email/info` — Tool to validate an email and return enrichment/demographics. Use when you need in-depth email analysis after confirming the email address.
  - body: { email: string, license: string }
- `POST https://api.mcp.ai/api/interzoid/get/entity/type` — Tool to classify a text string into an entity type. Use when you need to identify if input refers to a Location, Organization, or Individual.
  - body: { text: string, license?: string }
- `POST https://api.mcp.ai/api/interzoid/get/executive/profile` — Tool to retrieve executive profile details based on company and title keywords. Use when you need executive information such as LinkedIn and biography links.
  - body: { lookup: string, license?: string }
- `POST https://api.mcp.ai/api/interzoid/get/full/name/match` — Tool to generate a similarity key for a full name. Use when performing fuzzy matching or deduplication of individual names.
  - body: { license?: string, fullname: string }
- `POST https://api.mcp.ai/api/interzoid/get/full/name/match/score` — Tool to return a similarity score between two full names. Use when determining if two person names likely refer to the same individual.
  - body: { license?: string, fullname1: string, fullname2: string }
- `POST https://api.mcp.ai/api/interzoid/get/global/address/match` — Tool to generate a similarity key for a global address. Use when performing fuzzy matching and deduplication of international addresses.
  - body: { address: string, license: string, algorithm: string }
- `POST https://api.mcp.ai/api/interzoid/get/global/page/load/performance` — Tool to measure page/API load time from a specified global origin. Use when benchmarking response times across geographic locations.
  - body: { url: string, origin: string, license: string }
- `POST https://api.mcp.ai/api/interzoid/get/global/weather` — Tool to return current weather conditions for a global location. Use when you need up-to-the-minute weather details for any city worldwide.
  - body: { license?: string, location: string }
- `POST https://api.mcp.ai/api/interzoid/get/ip/profile` — Tool to retrieve IP intelligence including ASN, organization, geolocation, and reputation. Use when profiling an IP address for threat analysis.
  - body: { lookup: string, license?: string, x-api-key?: string }
- `POST https://api.mcp.ai/api/interzoid/get/license` — Tool to retrieve the configured Interzoid API license key. Use when you need to inspect which API key is active in the current connection.
  - body: { license?: string, x_api_key?: string, authorization?: string, query_license?: string }
- `POST https://api.mcp.ai/api/interzoid/get/name/origin` — Tool to infer the likely country or region of origin from a personal name. Use after obtaining a name to guess its origin.
  - body: { name: string, license?: string }
- `POST https://api.mcp.ai/api/interzoid/get/org/match/score` — Tool to return a 1–99 match score between two organization names. Use after gathering both names to evaluate organization similarity.
  - body: { license?: string, company1: string, company2: string }
- `POST https://api.mcp.ai/api/interzoid/get/org/standard` — Tool to standardize an organization name to a canonical English form. Use when you need consistent company naming for data normalization.
  - body: { org: string, license?: string, x-api-key?: string }
- `POST https://api.mcp.ai/api/interzoid/get/parent/company/info` — Tool to retrieve ultimate parent company information. Use when you have a company name or domain and need its ownership details.
  - body: { lookup: string, license?: string }
- `POST https://api.mcp.ai/api/interzoid/get/phone/profile` — Tool to retrieve phone number intelligence including validation, normalization, carrier, and risk assessment. Use when you need to enrich and validate a phone number after capture.
  - body: { lookup: string, license?: string, x-api-key?: string }
- `POST https://api.mcp.ai/api/interzoid/get/product/match` — Tool to generate a similarity key for a product name. Use when normalizing and fuzzy-matching names across catalogs.
  - body: { license?: string, product: string, algorithm: string }
- `POST https://api.mcp.ai/api/interzoid/get/remaining/credits` — Tool to retrieve remaining Interzoid API credits. Use when you need to check your credit balance after usage.
  - body: { license?: string, x_api_key?: string }
- `POST https://api.mcp.ai/api/interzoid/get/weather/zipcode` — Tool to get current weather conditions for a US ZIP code. Use when you need real-time weather information for a specific area after confirming the ZIP code is valid.
  - body: { zip: string, license?: string }
- `POST https://api.mcp.ai/api/interzoid/identify/language` — Tool to detect the language of a text string. Use when you need to identify the language of arbitrary text. Call after obtaining the text input.
  - body: { text: string, license: string }
- `POST https://api.mcp.ai/api/interzoid/translate/to/any` — Tool to auto-detect the input language and translate given text to the specified target language. Use when you need quick translations without specifying the source language.
  - body: { to: string, text: string, license: string }

## Example prompts
- "What can I do in Interzoid?"
- "Show me a summary of my Interzoid account"

## More
- Page: https://mcp.ai/interzoid
- Agent spec (llms.txt): https://mcp.ai/interzoid/llms.txt
- Postman collection: https://mcp.ai/interzoid/postman.json