@apitier/mcp-server

MCP (Model Context Protocol) server that exposes all APITier utility APIs as tools for AI agents.

Tools Available

| Tool | Description | | --- | --- | | lookup_uk_postcode | UK postcode → full address list + geocode | | search_uk_address | Free-text UK address search | | autocomplete_uk_address | Real-time UK address suggestions | | validate_email | Validate email — syntax, MX, SMTP, disposable check | | validate_phone | Validate & parse phone numbers (international) | | validate_vat | Validate EU/UK VAT numbers, returns registered business | | lookup_india_pincode | Indian PIN code → state/district/town | | generate_barcode | Generate barcode image (Code128, EAN-13, UPC, etc.) | | generate_qrcode | Generate QR code image with optional logo + colour | | convert_data | Convert between CSV, JSON, XML, YAML |

Setup

1. Get your API keys

Sign up at apitier.com. Each APITier service has its own subscription and API key. You only need keys for the services you want to use — tools without a configured key are automatically omitted from the MCP tool list.

2. Install

npm install -g @apitier/mcp-server
# or run directly without installing:
npx @apitier/mcp-server

Claude Desktop

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

{
  "mcpServers": {
    "apitier": {
      "command": "npx",
      "args": ["@apitier/mcp-server"],
      "env": {
        "APITIER_POSTCODE_KEY":     "key-from-postcode-subscription",
        "APITIER_EMAIL_KEY":        "key-from-email-subscription",
        "APITIER_PHONE_KEY":        "key-from-phone-subscription",
        "APITIER_VAT_KEY":          "key-from-vat-subscription",
        "APITIER_BARCODE_KEY":      "key-from-barcode-subscription",
        "APITIER_CONVERT_DATA_KEY": "key-from-data-conversion-subscription"
      }
    }
  }
}

Only set keys for services you have subscribed to. Restart Claude Desktop — you will see only the tools for your active subscriptions.

Cursor / Windsurf / other MCP clients

{
  "mcp": {
    "servers": {
      "apitier": {
        "command": "npx",
        "args": ["@apitier/mcp-server"],
        "env": {
          "APITIER_API_KEY": "your-api-key-here"
        }
      }
    }
  }
}

LangChain (Python)

from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client
from langchain_mcp_adapters.tools import load_mcp_tools
from langgraph.prebuilt import create_react_agent
from langchain_anthropic import ChatAnthropic

async def main():
    server_params = StdioServerParameters(
        command="npx",
        args=["@apitier/mcp-server"],
        env={"APITIER_API_KEY": "your-api-key"},
    )

    async with stdio_client(server_params) as (read, write):
        async with ClientSession(read, write) as session:
            await session.initialize()
            tools = await load_mcp_tools(session)

            model = ChatAnthropic(model="claude-sonnet-4-6")
            agent = create_react_agent(model, tools)

            result = await agent.ainvoke({
                "messages": "Validate this email: [email protected] and look up postcode SW1A 1AA"
            })
            print(result["messages"][-1].content)

Vercel AI SDK (TypeScript)

import { experimental_createMCPClient as createMCPClient } from "ai";
import { Experimental_StdioMCPTransport as StdioMCPTransport } from "ai/mcp-stdio";
import { anthropic } from "@ai-sdk/anthropic";
import { generateText } from "ai";

const mcp = await createMCPClient({
  transport: new StdioMCPTransport({
    command: "npx",
    args: ["@apitier/mcp-server"],
    env: { APITIER_API_KEY: process.env.APITIER_API_KEY! },
  }),
});

const tools = await mcp.tools();

const { text } = await generateText({
  model: anthropic("claude-sonnet-4-6"),
  tools,
  prompt: "Validate the email [email protected] and generate a QR code for https://apitier.com",
});

await mcp.close();

Environment Variables

| Variable | Required | Description | | --- | --- | --- | | APITIER_EMAIL_KEY | One or more required | API key from your Email Validation subscription | | APITIER_PHONE_KEY | One or more required | API key from your Phone Validation subscription | | APITIER_VAT_KEY | One or more required | API key from your VAT Validation subscription | | APITIER_POSTCODE_KEY | One or more required | API key from your UK Postcode subscription | | APITIER_PINCODE_KEY | One or more required | API key from your India Pincode subscription | | APITIER_BARCODE_KEY | One or more required | API key from your Barcode/QR Code subscription | | APITIER_CONVERT_DATA_KEY | One or more required | API key from your Data Conversion subscription | | APITIER_EMAIL_URL | No | Override email API base URL | | APITIER_PHONE_URL | No | Override phone API base URL | | APITIER_VAT_URL | No | Override VAT API base URL | | APITIER_POSTCODE_URL | No | Override UK postcode API base URL | | APITIER_PINCODE_URL | No | Override India pincode API base URL | | APITIER_BARCODE_URL | No | Override barcode API base URL | | APITIER_CONVERT_DATA_URL | No | Override data conversion API base URL |

Development

git clone ...
cd apitier-mcp-server
npm install
npm run build
APITIER_API_KEY=your-key node dist/index.js

To test with the MCP inspector:

npx @modelcontextprotocol/inspector npx @apitier/mcp-server

Set APITIER_API_KEY in the inspector's environment variables panel.

Example Agent Prompts

Once connected to Claude Desktop, you can say:

• "Validate this list of emails and tell me which ones are invalid: ..."
• "Look up UK postcode EC1A 1BB and fill in the address form"
• "Generate a QR code for our company website with our logo"
• "I have a CSV file — convert it to JSON"
• "Verify this VAT number before I send the invoice: GB123456789"
• "Validate these phone numbers and tell me which country each is from: ..."