Apitier Mcp Server

@apitier/mcp-server

AI エージェント向けのツールとして、APITier のすべてのユーティリティ API を公開する MCP（Model Context Protocol）サーバーです。

2 つの連携モードがあります。

モード	最適な用途
ホスト型 HTTP — https://mcp.apitier.com	Anthropic コネクターディレクトリ、リモートエージェント、サーバー間連携
stdio（npx） — ローカルで実行	Claude Desktop、Cursor、Windsurf、ローカルエージェント

どちらのモードでも同じ MCP Key を使用します。1 つのキーで、サブスクライブしているすべてのサービスを利用できます。

Postman コレクション： 用意済みのコレクションをインポートすると、すべてのエンドポイントをすぐにテストできます。 https://raw.githubusercontent.com/apitier/apitier-mcp-server/main/postman/APITier%20MCP%20Server.postman_collection.json

Postman で Import → Link → URL を貼り付け → コレクション変数 mcp_api_key を設定します。

---

利用可能なツール

🇬🇧 英国の KYC オンボーディング

ツール	説明
kyc_onboard_uk	英国企業のオンボーディング確認を 1 回の呼び出しで完了します。 VAT を検証し、Companies House を照会し、PSC（実質的支配者）を取得して、登録住所を確認します。PASS / REVIEW / FAIL、リスクスコア、およびすべてのデータを返します。postcode + vat + leadAgent のサブスクリプションが必要です。

出力例：

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

---

🇬🇧 英国の住所と不動産

ツール	説明
verify_uk_address	英国の住所を Royal Mail PAF と照合して検証します。正規化された住所、UPRN、UDPRN、および配達地点ごとのジオコードを返します
lookup_uprn	UDPRN で AddressBase の完全なレコードを検索し、UPRN、PAF 正規化住所、座標を返します。verify_uk_address の UDPRN を使用してください
lookup_uk_postcode	英国の郵便番号から、PAF の住所一覧、地区、区、州、国、およびジオコードを取得します

🇬🇧 英国の企業とコンプライアンス

ツール	説明
verify_uk_company	企業名または番号で Companies House の英国企業を検索し、ステータス、住所、SIC コード、提出状況を取得します
get_company_psc	英国企業の重要な支配者（PSC）登録情報を取得します。AML の実質的所有者確認に必要です
validate_sort_code	英国のソートコードと、任意で銀行口座番号を検証します（Vocalink モジュラスチェック）。API キーは不要です。

🇬🇧🇪🇺 英国と EU の VAT コンプライアンス

ツール	説明
validate_vat	英国と EU の VAT 番号を検証します。GB 番号は HMRC、それ以外の国コードはすべて EU VIES で確認します。登録事業者名と住所を返します。任意の国コードを使用できます（例：GB123456789、DE123456789、FR12345678901）。

🌍 グローバル ID

ツール	説明
validate_email	メールアドレスを検証します。構文、MX、SMTP 到達性、使い捨てドメインを確認します。世界中のあらゆるメールアドレスに対応します。
validate_phone	電話番号を検証して解析します。任意の国際形式を受け付け、国、通信事業者、回線種別を返します。

🇮🇳 インド

ツール	説明
lookup_india_pincode	インドの PIN コードから州／地区／町を取得します

🌍 ユーティリティ

ツール	説明
generate_barcode	バーコード画像を生成します（Code128、EAN-13、UPC など）
generate_qrcode	ロゴと色を任意で指定して QR コード画像を生成します
convert_data	CSV、JSON、XML、YAML の間で変換します

---

クイックスタート

1. MCP Key を取得する

apitier.com にサインアップし、Account → AI & MCP → Generate MCP Key を選択します。

MCP Key（mcp_...）を使うと、サブスクライブしている APITier サービスのツールをすべて自動的に利用できます。サービスごとの設定は不要です。

---

ホスト型 HTTP エンドポイント

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

x-api-key クエリパラメーターとして MCP Key を渡します。エンドポイントはサブスクライブ中のサービスを判定し、利用可能なツールのみを返します。

必須ヘッダー：

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

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 .

ツールを呼び出す：

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 .

ヘルスチェック：

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

任意の HTTP MCP クライアントで使用する

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

---

Claude Desktop（stdio）

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します。

MCP Key を使用する場合（推奨 — 1 つのキーですべての契約中のツールを利用できます）：

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

個別のサービスキーを使用する場合（明示的に制御したい場合）：

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

保存後、Claude Desktop を再起動してください。有効なサブスクリプションのツールのみが表示されます。

---

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: [email protected] and look up postcode SW1A 1AA"
            })
            print(result["messages"][-1].content)

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

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

---

環境変数

変数	説明
APITIER_MCP_KEY	推奨。 アカウントページから取得する単一の MCP Key。契約中のすべてのサービスキーを自動的に解決します
APITIER_POSTCODE_KEY	UK Postcode サブスクリプション — verify_uk_address、lookup_uprn、lookup_uk_postcode を有効にします
APITIER_LEAD_AGENT_KEY	Lead Agent サブスクリプション — verify_uk_company、get_company_psc を有効にします
APITIER_EMAIL_KEY	Email Validation サブスクリプション — validate_email を有効にします
APITIER_PHONE_KEY	Phone Validation サブスクリプション — validate_phone を有効にします
APITIER_VAT_KEY	VAT Validation サブスクリプション — validate_vat を有効にします
APITIER_PINCODE_KEY	India Pincode サブスクリプション — lookup_india_pincode を有効にします
APITIER_BARCODE_KEY	Barcode/QR Code サブスクリプション — generate_barcode、generate_qrcode を有効にします
APITIER_CONVERT_DATA_KEY	Data Conversion サブスクリプション — convert_data を有効にします

validate_sort_code に API キーは不要です。常に利用できます。

kyc_onboard_uk には APITIER_POSTCODE_KEY + APITIER_LEAD_AGENT_KEY + APITIER_VAT_KEY（または、3 つすべてのサブスクリプションを含む統合 APITIER_MCP_KEY）が必要です。3 つすべてのサービスが有効な場合にのみ、このツールが表示されます。

個別のサービスキーと APITIER_MCP_KEY の両方が設定されている場合は、個別のサービスキーが優先されます。

---

開発

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

MCP Inspector でテストします。

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

Inspector の環境変数パネルで APITIER_MCP_KEY を設定します。

---

エージェントプロンプトの例

Claude Desktop または MCP 互換のエージェントに接続したら、次のように指示できます。

UK の KYC オンボーディング

• 「Vodafone Group Plc、VAT GB778476239、郵便番号 EC1A 1BB の KYC チェックを実行してください」
• 「このサプライヤーをオンボーディングしてください。会社名は Tesco PLC、VAT は GB220437023 です」
• 「契約に署名する前に、この企業を確認してください。会社番号は 00445790 です」

UK の住所と不動産

• 「この住所を確認して、UPRN を教えてください：10 Downing Street, SW1A 2AA」
• 「UK の郵便番号 EC1A 1BB を検索して、住所フォームに入力してください」

UK の企業とコンプライアンス

• 「Companies House でこの UK 企業を確認してください：Barclays Bank UK PLC」
• 「会社番号 00026167 の重要な支配権を有する者は誰ですか？」
• 「この UK のソートコードと口座番号を確認してください：60-16-13 / 31926819」
• 「この UK の VAT 番号を確認してください：GB927065390」
• 「請求書を送る前に、この EU の VAT 番号を確認してください：DE123456789」

グローバルな本人確認

• 「このメールアドレス一覧を検証して、無効なものを教えてください」
• 「これらの電話番号を検証して、それぞれがどの国のものか教えてください」

ユーティリティ

• 「apitier.com の QR コードを生成してください」
• 「この CSV を JSON に変換してください」