Skip to main content
Glama
apitier

APITier MCP Server

Official
by apitier

@apitier/mcp-server

모든 APITier 유틸리티 API를 AI 에이전트를 위한 도구로 노출하는 MCP(Model Context Protocol) 서버입니다.

사용 가능한 도구

도구

설명

lookup_uk_postcode

영국 우편번호 → 전체 주소 목록 + 지오코드

search_uk_address

자유 텍스트 영국 주소 검색

autocomplete_uk_address

실시간 영국 주소 추천

validate_email

이메일 검증 — 구문, MX, SMTP, 일회용 여부 확인

validate_phone

전화번호 검증 및 파싱 (국제)

validate_vat

EU/UK VAT 번호 검증, 등록된 사업체 반환

lookup_india_pincode

인도 PIN 코드 → 주/지구/도시

generate_barcode

바코드 이미지 생성 (Code128, EAN-13, UPC 등)

generate_qrcode

로고 및 색상 옵션이 포함된 QR 코드 이미지 생성

convert_data

CSV, JSON, XML, YAML 간 변환

Related MCP server: APIbase

설정

1. API 키 발급

apitier.com에서 가입하세요. 각 APITier 서비스는 별도의 구독과 API 키가 필요합니다. 사용하려는 서비스의 키만 있으면 됩니다. 키가 설정되지 않은 도구는 MCP 도구 목록에서 자동으로 제외됩니다.

2. 설치

npm install -g @apitier/mcp-server
# or run directly without installing:
npx @apitier/mcp-server

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json(macOS) 또는 %APPDATA%\Claude\claude_desktop_config.json(Windows)에 추가하세요:

{
  "mcpServers": {
    "apitier": {
      "command": "npx",
      "args": ["@apitier/mcp-server"],
      "env": {
        "APITIER_POSTCODE_KEY":     "key-from-postcode-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 / 기타 MCP 클라이언트

{
  "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: test@example.com 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 user@example.com and generate a QR code for https://apitier.com",
});

await mcp.close();

환경 변수

변수

필수 여부

설명

APITIER_EMAIL_KEY

하나 이상 필수

이메일 검증 구독의 API 키

APITIER_PHONE_KEY

하나 이상 필수

전화번호 검증 구독의 API 키

APITIER_VAT_KEY

하나 이상 필수

VAT 검증 구독의 API 키

APITIER_POSTCODE_KEY

하나 이상 필수

영국 우편번호 구독의 API 키

APITIER_PINCODE_KEY

하나 이상 필수

인도 핀코드 구독의 API 키

APITIER_BARCODE_KEY

하나 이상 필수

바코드/QR 코드 구독의 API 키

APITIER_CONVERT_DATA_KEY

하나 이상 필수

데이터 변환 구독의 API 키

APITIER_EMAIL_URL

아니요

이메일 API 기본 URL 재정의

APITIER_PHONE_URL

아니요

전화번호 API 기본 URL 재정의

APITIER_VAT_URL

아니요

VAT API 기본 URL 재정의

APITIER_POSTCODE_URL

아니요

영국 우편번호 API 기본 URL 재정의

APITIER_PINCODE_URL

아니요

인도 핀코드 API 기본 URL 재정의

APITIER_BARCODE_URL

아니요

바코드 API 기본 URL 재정의

APITIER_CONVERT_DATA_URL

아니요

데이터 변환 API 기본 URL 재정의


개발

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

MCP 인스펙터로 테스트하려면:

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

인스펙터의 환경 변수 패널에서 APITIER_API_KEY를 설정하세요.


에이전트 프롬프트 예시

Claude Desktop에 연결되면 다음과 같이 요청할 수 있습니다:

  • "이 이메일 목록을 검증하고 유효하지 않은 것을 알려줘: ..."

  • "영국 우편번호 EC1A 1BB를 조회해서 주소 양식을 채워줘"

  • "우리 회사 로고를 넣어서 회사 웹사이트용 QR 코드를 생성해줘"

  • "CSV 파일이 있는데 JSON으로 변환해줘"

  • "송장을 보내기 전에 이 VAT 번호를 확인해줘: GB123456789"

  • "이 전화번호들을 검증하고 각각 어느 국가의 번호인지 알려줘: ..."

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    A
    maintenance
    Unified MCP gateway for AI agents with 56+ tools and growing. Travel (Amadeus, Sabre GDS), e-commerce, local services, financial markets (Polymarket), and marketing APIs — all through a single endpoint. Pay-per-call via x402 micropayments in USDC.
    100
    24 npm
    10
    MIT
  • F
    license
    A
    quality
    F
    maintenance
    MCP server that exposes 300+ AI agents as tools via a single API key. Supports listing agents, invoking any agent with chat-completion style messages, checking agent health, and retrieving platform statistics.
    5
    4
    -