APITier MCP Server

Servidor MCP que expone 10 APIs de utilidad de APITier como herramientas de agente de IA

Documentación

@apitier/mcp-server

Servidor MCP (Model Context Protocol) que expone todas las APIs de utilidades de APITier como herramientas para agentes de IA.

Dos modos de integración:

Modo	Ideal para
HTTP alojado — `https://mcp.apitier.com`	Directorio de conectores de Anthropic, agentes remotos, servidor a servidor
stdio (npx) — se ejecuta localmente	Claude Desktop, Cursor, Windsurf, agentes locales

Ambos modos usan la misma MCP Key — una sola clave desbloquea todos tus servicios suscritos.

Colección de Postman: importa la colección ya preparada para probar todos los endpoints al instante: https://raw.githubusercontent.com/apitier/apitier-mcp-server/main/postman/APITier%20MCP%20Server.postman_collection.json

En Postman: Import → Link → pega la URL → establece la variable de colección mcp_api_key.

Herramientas disponibles

🇬🇧 Incorporación KYC en Reino Unido

Herramienta	Descripción
`kyc_onboard_uk`	Verificación completa de incorporación empresarial en el Reino Unido en una sola llamada. Valida el IVA, verifica Companies House, recupera el PSC (beneficiarios efectivos) y confirma la dirección registrada. Devuelve `PASS / REVIEW / FAIL`, una puntuación de riesgo y el paquete completo de datos. Requiere suscripciones a `postcode` + `vat` + `leadAgent`.

Ejemplo de salida:

{
  "decision": "PASS",
  "risk_score": 95,
  "flags": [],
  "checks": {
    "company": { "status": "active", "data": { ... } },
    "psc":     { "status": "found",  "data": { ... } },
    "vat":     { "status": "valid",  "data": { ... } },
    "address": { "status": "verified", "data": { ... } }
  }
}

🇬🇧 Dirección y propiedad en Reino Unido

Herramienta	Descripción
`verify_uk_address`	Verifica una dirección del Reino Unido contra Royal Mail PAF — devuelve dirección canónica, UPRN, UDPRN y geocódigo por punto de entrega
`lookup_uprn`	Consulta un registro completo de AddressBase por UDPRN — devuelve UPRN, dirección canónica PAF, coordenadas. Usa el UDPRN de `verify_uk_address`
`lookup_uk_postcode`	Código postal del Reino Unido → lista completa de direcciones PAF + distrito, municipio, condado, país y geocódigo

🇬🇧 Negocios y cumplimiento en Reino Unido

Herramienta	Descripción
`verify_uk_company`	Consulta una empresa del Reino Unido en Companies House por nombre o número — estado, dirección, códigos SIC, salud de presentaciones
`get_company_psc`	Registro de Personas con Control Significativo para una empresa del Reino Unido — requerido para verificaciones AML de beneficiarios efectivos
`validate_sort_code`	Valida un sort code del Reino Unido y opcionalmente un número de cuenta bancaria (verificación de módulo Vocalink). No requiere clave API.

🇬🇧🇪🇺 Cumplimiento de IVA en Reino Unido + UE

Herramienta	Descripción
`validate_vat`	Valida números de IVA del Reino Unido y la UE — verifica HMRC para números GB, VIES de la UE para todos los demás prefijos de país. Devuelve el nombre y la dirección de la empresa registrada. Acepta cualquier prefijo de país (p. ej., `GB123456789`, `DE123456789`, `FR12345678901`).

🌍 Identidad global

Herramienta	Descripción
`validate_email`	Valida correo electrónico — sintaxis, MX, alcanzabilidad SMTP, verificación de dominio desechable. Funciona para cualquier dirección de correo a nivel global.
`validate_phone`	Valida y analiza números de teléfono — acepta cualquier formato internacional, devuelve país, operador y tipo de línea.

🇮🇳 India

Herramienta	Descripción
`lookup_india_pincode`	Código PIN de India → estado / distrito / ciudad

🌍 Utilidades

Herramienta	Descripción
`generate_barcode`	Genera imagen de código de barras (Code128, EAN-13, UPC y más)
`generate_qrcode`	Genera imagen de código QR con logo y color opcionales
`convert_data`	Convierte entre CSV, JSON, XML, YAML

Inicio rápido

1. Obtén tu MCP Key

Regístrate en apitier.com → Cuenta → IA y MCP → Generar MCP Key.

Tu MCP Key (mcp_...) desbloquea automáticamente las herramientas de cada servicio de APITier al que estés suscrito. No se necesita configuración por servicio.

Endpoint HTTP alojado

POST https://mcp.apitier.com/mcp?x-api-key=YOUR_MCP_KEY

Pasa tu MCP Key como parámetro de consulta x-api-key. El endpoint resuelve tus servicios suscritos y devuelve solo las herramientas disponibles para ti.

Encabezados requeridos:

Content-Type: application/json
Accept: application/json, text/event-stream

Prueba con 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 .

Llama a una herramienta:

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 .

Verificación de estado:

curl https://mcp.apitier.com/health

Uso con cualquier cliente HTTP MCP

{
  "mcpServers": {
    "apitier": {
      "url": "https://mcp.apitier.com/mcp?x-api-key=YOUR_MCP_KEY"
    }
  }
}

Claude Desktop (stdio)

Añade a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

Con MCP Key (recomendado — una sola clave, todas las herramientas suscritas):

{
  "mcpServers": {
    "apitier": {
      "command": "npx",
      "args": ["-y", "@apitier/mcp-server"],
      "env": {
        "APITIER_MCP_KEY": "mcp_your-key-here"
      }
    }
  }
}

Con claves de servicio individuales (si prefieres control explícito):

{
  "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"
      }
    }
  }
}

Reinicia Claude Desktop después de guardar. Solo aparecerán las herramientas de tus suscripciones activas.

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)

Endpoint HTTP:

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();

Endpoint HTTP:

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();

Variables de entorno

Variable	Descripción
`APITIER_MCP_KEY`	Recomendada. MCP Key única desde la página de cuenta — resuelve automáticamente todas las claves de servicios suscritos
`APITIER_POSTCODE_KEY`	Suscripción de códigos postales del Reino Unido — habilita `verify_uk_address`, `lookup_uprn`, `lookup_uk_postcode`
`APITIER_LEAD_AGENT_KEY`	Suscripción Lead Agent — habilita `verify_uk_company`, `get_company_psc`
`APITIER_EMAIL_KEY`	Suscripción de validación de correo — habilita `validate_email`
`APITIER_PHONE_KEY`	Suscripción de validación de teléfono — habilita `validate_phone`
`APITIER_VAT_KEY`	Suscripción de validación de IVA — habilita `validate_vat`
`APITIER_PINCODE_KEY`	Suscripción de pincode de India — habilita `lookup_india_pincode`
`APITIER_BARCODE_KEY`	Suscripción de código de barras/QR — habilita `generate_barcode`, `generate_qrcode`
`APITIER_CONVERT_DATA_KEY`	Suscripción de conversión de datos — habilita `convert_data`

validate_sort_code no requiere clave API — siempre está disponible.

kyc_onboard_uk requiere APITIER_POSTCODE_KEY + APITIER_LEAD_AGENT_KEY + APITIER_VAT_KEY (o una APITIER_MCP_KEY unificada con las tres suscripciones). La herramienta solo aparece cuando los tres servicios están activos.

Las claves de servicio individuales tienen prioridad sobre APITIER_MCP_KEY si ambas están configuradas.

Desarrollo

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.js

Prueba con el MCP Inspector:

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

Establece APITIER_MCP_KEY en el panel de variables de entorno del inspector.

Ejemplos de indicaciones para agentes

Una vez conectado a Claude Desktop o a cualquier agente compatible con MCP:

Incorporación KYC en Reino Unido

"Ejecuta una verificación KYC en Vodafone Group Plc, IVA GB778476239, código postal EC1A 1BB"
"Incorpora a este proveedor: nombre de empresa Tesco PLC, IVA GB220437023"
"Verifica esta empresa antes de firmar el contrato: número de empresa 00445790"

Dirección y propiedad en Reino Unido

"Verifica esta dirección y dame su UPRN: 10 Downing Street, SW1A 2AA"
"Consulta el código postal del Reino Unido EC1A 1BB y completa el formulario de dirección"

Negocios y cumplimiento en Reino Unido

"Verifica esta empresa del Reino Unido en Companies House: Barclays Bank UK PLC"
"¿Quiénes son las personas con control significativo de la empresa número 00026167?"
"Valida este sort code y número de cuenta del Reino Unido: 60-16-13 / 31926819"
"Valida este número de IVA del Reino Unido: GB927065390"
"Valida este número de IVA de la UE antes de enviar la factura: DE123456789"

Identidad global

"Valida esta lista de correos y dime cuáles son inválidos"
"Valida estos números de teléfono y dime de qué país es cada uno"

Utilidades

"Genera un código QR para apitier.com"
"Convierte este CSV a JSON"