APITier MCP Server

Servidor MCP que expõe 10 APIs utilitárias do APITier como ferramentas de agente de IA

Documentação

@apitier/mcp-server

Servidor MCP (Model Context Protocol) que expõe todas as APIs de utilitários da APITier como ferramentas para agentes de IA.

Dois modos de integração:

Modo	Melhor para
HTTP hospedado — `https://mcp.apitier.com`	Diretório de conectores da Anthropic, agentes remotos, servidor para servidor
stdio (npx) — executa localmente	Claude Desktop, Cursor, Windsurf, agentes locais

Ambos os modos usam a mesma MCP Key — uma única chave desbloqueia todos os seus serviços assinados.

Coleção Postman: importe a coleção pronta para testar todos os endpoints instantaneamente: https://raw.githubusercontent.com/apitier/apitier-mcp-server/main/postman/APITier%20MCP%20Server.postman_collection.json

No Postman: Importar → Link → cole a URL → defina a variável de coleção mcp_api_key.

Ferramentas Disponíveis

🇬🇧 Onboarding KYC no Reino Unido

Ferramenta	Descrição
`kyc_onboard_uk`	Verificação completa de onboarding empresarial no Reino Unido em uma única chamada. Valida o VAT, verifica a Companies House, recupera o PSC (beneficiários efetivos) e confirma o endereço registrado. Retorna `PASS / REVIEW / FAIL`, uma pontuação de risco e o pacote completo de dados. Requer assinaturas de `postcode` + `vat` + `leadAgent`.

Exemplo de saída:

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

🇬🇧 Endereço e Propriedade no Reino Unido

Ferramenta	Descrição
`verify_uk_address`	Verifique um endereço do Reino Unido no Royal Mail PAF — retorna endereço canônico, UPRN, UDPRN e geocódigo por ponto de entrega
`lookup_uprn`	Consulte um registro completo do AddressBase por UDPRN — retorna UPRN, endereço canônico PAF e coordenadas. Use o UDPRN de `verify_uk_address`
`lookup_uk_postcode`	Código postal do Reino Unido → lista completa de endereços PAF + distrito, distrito eleitoral, condado, país e geocódigo

🇬🇧 Negócios e Conformidade no Reino Unido

Ferramenta	Descrição
`verify_uk_company`	Consulte uma empresa do Reino Unido na Companies House por nome ou número — status, endereço, códigos SIC, saúde de arquivamento
`get_company_psc`	Registro de Pessoas com Controle Significativo para uma empresa do Reino Unido — necessário para verificações de beneficiários efetivos em AML
`validate_sort_code`	Valide um sort code do Reino Unido e, opcionalmente, um número de conta bancária (verificação de módulo Vocalink). Nenhuma chave de API necessária.

🇬🇧🇪🇺 Conformidade de VAT no Reino Unido + UE

Ferramenta	Descrição
`validate_vat`	Valide números de VAT do Reino Unido e da UE — verifica a HMRC para números GB e o VIES da UE para todos os outros prefixos de países. Retorna o nome e o endereço da empresa registrada. Aceita qualquer prefixo de país (ex.: `GB123456789`, `DE123456789`, `FR12345678901`).

🌍 Identidade Global

Ferramenta	Descrição
`validate_email`	Valide e-mail — sintaxe, MX, acessibilidade SMTP, verificação de domínio descartável. Funciona para qualquer endereço de e-mail globalmente.
`validate_phone`	Valide e analise números de telefone — aceita qualquer formato internacional, retorna país, operadora e tipo de linha.

🇮🇳 Índia

Ferramenta	Descrição
`lookup_india_pincode`	Código PIN indiano → estado / distrito / cidade

🌍 Utilitários

Ferramenta	Descrição
`generate_barcode`	Gere imagem de código de barras (Code128, EAN-13, UPC e outros)
`generate_qrcode`	Gere imagem de código QR com logotipo e cor opcionais
`convert_data`	Converta entre CSV, JSON, XML, YAML

Início Rápido

1. Obtenha sua MCP Key

Cadastre-se em apitier.com → Conta → IA e MCP → Gerar MCP Key.

Sua MCP Key (mcp_...) desbloqueia automaticamente as ferramentas para todos os serviços da APITier que você assinou. Nenhuma configuração por serviço é necessária.

Endpoint HTTP Hospedado

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

Envie sua MCP Key como o parâmetro de consulta x-api-key. O endpoint resolve seus serviços assinados e retorna apenas as ferramentas disponíveis para você.

Cabeçalhos necessários:

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

Teste com 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 .

Chame uma ferramenta:

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 .

Verificação de saúde:

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

Use com qualquer cliente HTTP MCP

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

Claude Desktop (stdio)

Adicione em ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

Com MCP Key (recomendado — chave única, todas as ferramentas assinadas):

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

Com chaves de serviço individuais (se você preferir controle 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"
      }
    }
  }
}

Reinicie o Claude Desktop após salvar. Apenas as ferramentas para suas assinaturas ativas aparecerão.

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

Variáveis de Ambiente

Variável	Descrição
`APITIER_MCP_KEY`	Recomendado. MCP Key única da página da conta — resolve automaticamente todas as chaves de serviços assinados
`APITIER_POSTCODE_KEY`	Assinatura de Código Postal do Reino Unido — habilita `verify_uk_address`, `lookup_uprn`, `lookup_uk_postcode`
`APITIER_LEAD_AGENT_KEY`	Assinatura Lead Agent — habilita `verify_uk_company`, `get_company_psc`
`APITIER_EMAIL_KEY`	Assinatura de Validação de E-mail — habilita `validate_email`
`APITIER_PHONE_KEY`	Assinatura de Validação de Telefone — habilita `validate_phone`
`APITIER_VAT_KEY`	Assinatura de Validação de VAT — habilita `validate_vat`
`APITIER_PINCODE_KEY`	Assinatura de Código PIN da Índia — habilita `lookup_india_pincode`
`APITIER_BARCODE_KEY`	Assinatura de Código de Barras/QR Code — habilita `generate_barcode`, `generate_qrcode`
`APITIER_CONVERT_DATA_KEY`	Assinatura de Conversão de Dados — habilita `convert_data`

validate_sort_code não requer chave de API — está sempre disponível.

kyc_onboard_uk requer APITIER_POSTCODE_KEY + APITIER_LEAD_AGENT_KEY + APITIER_VAT_KEY (ou uma APITIER_MCP_KEY unificada com todas as três assinaturas). A ferramenta só aparece quando todos os três serviços estão ativos.

Chaves de serviço individuais têm precedência sobre APITIER_MCP_KEY se ambas estiverem definidas.

Desenvolvimento

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

Teste com o MCP Inspector:

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

Defina APITIER_MCP_KEY no painel de variáveis de ambiente do inspector.

Exemplos de Prompts para Agentes

Depois de conectado ao Claude Desktop ou a qualquer agente compatível com MCP:

Onboarding KYC no Reino Unido

"Execute uma verificação KYC na Vodafone Group Plc, VAT GB778476239, código postal EC1A 1BB"
"Cadastre este fornecedor: nome da empresa Tesco PLC, VAT GB220437023"
"Verifique esta empresa antes de assinarmos o contrato: número da empresa 00445790"

Endereço e propriedade no Reino Unido

"Verifique este endereço e me dê o UPRN: 10 Downing Street, SW1A 2AA"
"Consulte o código postal do Reino Unido EC1A 1BB e preencha o formulário de endereço"

Negócios e conformidade no Reino Unido

"Verifique esta empresa do Reino Unido na Companies House: Barclays Bank UK PLC"
"Quem são as pessoas com controle significativo da empresa número 00026167?"
"Valide este sort code e número de conta do Reino Unido: 60-16-13 / 31926819"
"Valide este número de VAT do Reino Unido: GB927065390"
"Valide este número de VAT da UE antes de eu enviar a fatura: DE123456789"

Identidade global

"Valide esta lista de e-mails e me diga quais são inválidos"
"Valide estes números de telefone e me diga de qual país cada um é"

Utilitários

"Gere um código QR para apitier.com"
"Converta este CSV para JSON"