@apitier/mcp-server

@apitier/mcp-server

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

Tools Available

UK Address & Property

Tool	Description
verify_uk_address	Verify a UK address against Royal Mail PAF — returns canonical address, UPRN, UDPRN, and per-delivery-point geocode. Accepts optional query fragment to filter to a specific premise.
lookup_uprn	Look up a full AddressBase record by UDPRN — returns UPRN, PAF canonical address, lat/lng/easting/northing, and Welsh address where applicable. Use UDPRN from verify_uk_address.
lookup_uk_postcode	UK postcode → full PAF address list + district, ward, county, country, and geocode

UK Business & Compliance

Tool	Description
verify_uk_company	Look up a UK company on Companies House by name or company number — returns registered name, address, status (active/dissolved/dormant), SIC codes, incorporation date, and filing health flags.
get_company_psc	Retrieve the Persons with Significant Control (PSC) register for a UK company — returns each PSC's name, nature of control, notified date, and ceased status. Required for UK AML beneficial ownership checks.
validate_vat	Validate EU/UK VAT numbers, returns registered business name and address
validate_sort_code	Validate a UK bank sort code and optionally a bank account number using the Vocalink modulus 10/11 algorithm. Self-contained — no API key required.

Global Utilities

Tool	Description
validate_email	Validate email — syntax, MX, SMTP, disposable check
validate_phone	Validate & parse phone numbers (international)
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_LEAD_AGENT_KEY":      "key-from-lead-agent-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: [e-mail] 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 [e-mail] and generate a QR code for https://apitier.com",
});

await mcp.close();

Environment Variables

Variable	Required	Description
APITIER_POSTCODE_KEY	One or more required	UK Postcode subscription — enables verify_uk_address, lookup_uprn, lookup_uk_postcode
APITIER_LEAD_AGENT_KEY	One or more required	Lead Agent subscription — enables verify_uk_company, get_company_psc
APITIER_EMAIL_KEY	One or more required	Email Validation subscription — enables validate_email
APITIER_PHONE_KEY	One or more required	Phone Validation subscription — enables validate_phone
APITIER_VAT_KEY	One or more required	VAT Validation subscription — enables validate_vat
APITIER_PINCODE_KEY	One or more required	India Pincode subscription — enables lookup_india_pincode
APITIER_BARCODE_KEY	One or more required	Barcode/QR Code subscription — enables generate_barcode, generate_qrcode
APITIER_CONVERT_DATA_KEY	One or more required	Data Conversion subscription — enables convert_data

validate_sort_code requires no API key — it is always available.

Development

git clone https://github.com/apitier/apitier-mcp-server.git
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:

UK address & property

• "Verify this address and give me its UPRN: 10 Downing Street, SW1A 2AA"
• "Look up UK postcode EC1A 1BB and fill in the address form"
• "I have a UDPRN — look it up and return the full address record including UPRN"

UK business & compliance (KYC)

• "Verify this UK company on Companies House: Barclays Bank UK PLC"
• "Who are the persons with significant control for company number 00026167?"
• "Validate this UK sort code and account number: 60-16-13 / 31926819"
• "Verify this VAT number before I send the invoice: GB123456789"

Global utilities

• "Validate this list of emails and tell me which ones are invalid: ..."
• "Generate a QR code for our company website with our logo"
• "I have a CSV file — convert it to JSON"
• "Validate these phone numbers and tell me which country each is from: ..."