APITier MCP Server
OfficialEnables LangChain agents to use APITier tools for data validation, address lookup, barcode/QR code generation, and data format conversion through MCP integration.
Allows LangGraph agents to incorporate APITier utility tools for validation, address services, code generation, and data conversion in agent workflows.
Enables Vercel AI SDK applications to use APITier tools for email/phone/VAT validation, address lookup, barcode/QR code generation, and data conversion through MCP client integration.
@apitier/mcp-server
MCP (Model Context Protocol) server exposing all APITier utility APIs as tools for AI agents.
Two integration modes:
Mode | Best for |
Hosted HTTP — | Anthropic connector directory, remote agents, server-to-server |
stdio (npx) — runs locally | Claude Desktop, Cursor, Windsurf, local agents |
Both modes use the same MCP Key — one key unlocks all your subscribed services.
Postman collection: import the ready-made collection to test all endpoints instantly:
https://raw.githubusercontent.com/apitier/apitier-mcp-server/main/postman/APITier%20MCP%20Server.postman_collection.json
In Postman: Import → Link → paste URL → set mcp_api_key collection variable.
Tools Available
🇬🇧 UK KYC Onboarding
Tool | Description |
| Full UK business onboarding check in one call. Validates VAT, verifies Companies House, retrieves PSC (beneficial owners), and confirms the registered address. Returns |
Example output:
{
"decision": "PASS",
"risk_score": 95,
"flags": [],
"checks": {
"company": { "status": "active", "data": { ... } },
"psc": { "status": "found", "data": { ... } },
"vat": { "status": "valid", "data": { ... } },
"address": { "status": "verified", "data": { ... } }
}
}🇬🇧 UK Address & Property
Tool | Description |
| Verify a UK address against Royal Mail PAF — returns canonical address, UPRN, UDPRN, and per-delivery-point geocode |
| Look up a full AddressBase record by UDPRN — returns UPRN, PAF canonical address, coordinates. Use UDPRN from |
| UK postcode → full PAF address list + district, ward, county, country, and geocode |
🇬🇧 UK Business & Compliance
Tool | Description |
| Look up a UK company on Companies House by name or number — status, address, SIC codes, filing health |
| Persons with Significant Control register for a UK company — required for AML beneficial ownership checks |
| Validate a UK sort code and optionally a bank account number (Vocalink modulus check). No API key required. |
🇬🇧🇪🇺 UK + EU VAT Compliance
Tool | Description |
| Validate UK and EU VAT numbers — checks HMRC for GB numbers, EU VIES for all other country prefixes. Returns registered business name and address. Accepts any country prefix (e.g. |
🌍 Global Identity
Tool | Description |
| Validate email — syntax, MX, SMTP reachability, disposable domain check. Works for any email address globally. |
| Validate and parse phone numbers — accepts any international format, returns country, carrier, and line type. |
🇮🇳 India
Tool | Description |
| Indian PIN code → state / district / town |
🌍 Utilities
Tool | Description |
| Generate barcode image (Code128, EAN-13, UPC, and more) |
| Generate QR code image with optional logo and colour |
| Convert between CSV, JSON, XML, YAML |
Related MCP server: agent-utils-mcp
Quick Start
1. Get your MCP Key
Sign up at apitier.com → Account → AI & MCP → Generate MCP Key.
Your MCP Key (mcp_...) automatically unlocks the tools for every APITier service you have subscribed to. No per-service configuration needed.
Hosted HTTP Endpoint
POST https://mcp.apitier.com/mcp?x-api-key=YOUR_MCP_KEY
Pass your MCP Key as the x-api-key query parameter. The endpoint resolves your subscribed services and returns only the tools available to you.
Required headers:
Content-Type: application/json
Accept: application/json, text/event-streamTest with curl:
curl -s -X POST 'https://mcp.apitier.com/mcp?x-api-key=YOUR_MCP_KEY' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | jq .Call a tool:
curl -s -X POST 'https://mcp.apitier.com/mcp?x-api-key=YOUR_MCP_KEY' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "verify_uk_company",
"arguments": { "q": "03977902" }
}
}' | jq .Health check:
curl https://mcp.apitier.com/healthUse with any HTTP MCP client
{
"mcpServers": {
"apitier": {
"url": "https://mcp.apitier.com/mcp?x-api-key=YOUR_MCP_KEY"
}
}
}Claude Desktop (stdio)
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
With MCP Key (recommended — single key, all subscribed tools):
{
"mcpServers": {
"apitier": {
"command": "npx",
"args": ["-y", "@apitier/mcp-server"],
"env": {
"APITIER_MCP_KEY": "mcp_your-key-here"
}
}
}
}With individual service keys (if you prefer explicit control):
{
"mcpServers": {
"apitier": {
"command": "npx",
"args": ["-y", "@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"
}
}
}
}Restart Claude Desktop after saving. Only tools for your active subscriptions will appear.
Cursor / Windsurf / VS Code
{
"mcp": {
"servers": {
"apitier": {
"command": "npx",
"args": ["-y", "@apitier/mcp-server"],
"env": {
"APITIER_MCP_KEY": "mcp_your-key-here"
}
}
}
}
}LangChain (Python)
stdio:
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=["-y", "@apitier/mcp-server"],
env={"APITIER_MCP_KEY": "mcp_your-key-here"},
)
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: test@example.com and look up postcode SW1A 1AA"
})
print(result["messages"][-1].content)HTTP endpoint:
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client
async def main():
async with streamablehttp_client(
"https://mcp.apitier.com/mcp?x-api-key=mcp_your-key-here"
) as (read, write, _):
async with ClientSession(read, write) as session:
await session.initialize()
tools = await load_mcp_tools(session)
# use tools with your agent...Vercel AI SDK (TypeScript)
stdio:
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: ["-y", "@apitier/mcp-server"],
env: { APITIER_MCP_KEY: process.env.APITIER_MCP_KEY! },
}),
});
const tools = await mcp.tools();
const { text } = await generateText({
model: anthropic("claude-sonnet-4-6"),
tools,
prompt: "Verify this UK company: Google UK Limited",
});
await mcp.close();HTTP endpoint:
import { experimental_createMCPClient as createMCPClient } from "ai";
const mcp = await createMCPClient({
transport: {
type: "sse",
url: `https://mcp.apitier.com/mcp?x-api-key=${process.env.APITIER_MCP_KEY}`,
},
});
const tools = await mcp.tools();Environment Variables
Variable | Description |
| Recommended. Single MCP Key from account page — resolves all subscribed service keys automatically |
| UK Postcode subscription — enables |
| Lead Agent subscription — enables |
| Email Validation subscription — enables |
| Phone Validation subscription — enables |
| VAT Validation subscription — enables |
| India Pincode subscription — enables |
| Barcode/QR Code subscription — enables |
| Data Conversion subscription — enables |
validate_sort_code requires no API key — it is always available.
kyc_onboard_uk requires APITIER_POSTCODE_KEY + APITIER_LEAD_AGENT_KEY + APITIER_VAT_KEY (or a unified APITIER_MCP_KEY with all three subscriptions). The tool only appears when all three services are active.
Individual service keys take precedence over APITIER_MCP_KEY if both are set.
Development
git clone https://github.com/apitier/apitier-mcp-server.git
cd apitier-mcp-server
npm install
npm run build
APITIER_MCP_KEY=mcp_your-key node dist/index.jsTest with the MCP Inspector:
npx @modelcontextprotocol/inspector npx @apitier/mcp-serverSet APITIER_MCP_KEY in the inspector's environment variables panel.
Example Agent Prompts
Once connected to Claude Desktop or any MCP-compatible agent:
UK KYC onboarding
"Run a KYC check on Vodafone Group Plc, VAT GB778476239, postcode EC1A 1BB"
"Onboard this supplier: company name Tesco PLC, VAT GB220437023"
"Verify this business before we sign the contract: company number 00445790"
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"
UK business & compliance
"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"
"Validate this UK VAT number: GB927065390"
"Validate this EU VAT number before I send the invoice: DE123456789"
Global identity
"Validate this list of emails and tell me which ones are invalid"
"Validate these phone numbers and tell me which country each is from"
Utilities
"Generate a QR code for apitier.com"
"Convert this CSV to JSON"
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/apitier/apitier-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server