AI 에이전트를 위한 MCP 서버

Q: 어떻게 연결하나요?

엔드포인트 https://mcp.seldons.ai/mcp · Streamable HTTP · MCP 규격 2026-07-28. 인증은 Authorization: Bearer 헤더입니다. 키가 없어도 서버는 응답하고 무료 툴 둘이 목록에 보입니다 — 수출가 계산기가 거기 있으므로, 키를 받기 전에 답의 품질을 직접 확인하실 수 있습니다.

Q: 과금은 어떻게 되나요?

크레딧은 선불이고 툴이 실행된 뒤에 차감합니다. 절대 먼저 깎지 않습니다. 툴마다 정해진 크레딧이 있고(위 표), 유료 응답에는 _meta.credits_remaining 이 실려 에이전트가 스스로 잔액을 알고 사용자에게 알릴 수 있습니다. 평가용 키는 100 크레딧으로 시작합니다 — 답의 품질을 판단하기에는 충분하고 실서비스로 쓰기에는 부족한 자리입니다.

Q: 오류는 어떤 모양인가요?

툴 실패는 JSON-RPC 오류가 아니라 isError: true 인 정상 결과 로 옵니다. MCP 규격이 그렇게 요구하고, 그래야 모델이 읽고 스스로 고칠 수 있습니다.

Seldons 는 mcp.seldons.ai 에 Model Context Protocol 서버를 운영합니다. 이 사이트가 사람에게 제공하는 무역 도구 — HS 코드 추정, 착륙원가와 권장 정가, 인증 확인, 상세페이지 분석 — 을 AI 에이전트가 호출할 수 있는 툴로 노출합니다.

어떻게 연결하나요?

엔드포인트 https://mcp.seldons.ai/mcp · Streamable HTTP · MCP 규격 2026-07-28. 인증은 Authorization: Bearer 헤더입니다. 키가 없어도 서버는 응답하고 무료 툴 둘이 목록에 보입니다 — 수출가 계산기가 거기 있으므로, 키를 받기 전에 답의 품질을 직접 확인하실 수 있습니다.

Claude Code:

claude mcp add --transport http seldons https://mcp.seldons.ai/mcp \
  --header "Authorization: Bearer sk_live_YOUR_KEY"

mcpServers 블록을 읽는 클라이언트라면 어디든 — Claude Code 의 .mcp.json, Claude Desktop 설정 파일, Cursor 의 mcp.json:

{
  "mcpServers": {
    "seldons": {
      "type": "http",
      "url": "https://mcp.seldons.ai/mcp",
      "headers": { "Authorization": "Bearer sk_live_YOUR_KEY" }
    }
  }
}

키 없이 붙이려면 headers 블록을 빼면 됩니다.

어떤 툴이 있나요?

툴	크레딧	하는 일
`check_business_number`	0	사업자등록번호의 형식과 체크섬을 검증합니다. 외부 조회가 없어 무료입니다.
`calculate_export_price`	0	제조원가와 무게에서 목적지 시장의 권장 정가까지. 운임·관세·세금·수수료·마진을 반영하고, 계산이 스스로 가정한 값을 전부 함께 돌려줍니다.
`lookup_hs_code`	5	상품 페이지에서 6자리 HS 코드를 추정합니다. 확신도와 대안 함께.
`check_certifications`	5	필요한 인증, 페이지에 표시된 인증, 빠져 보이는 인증.
`analyze_product_page`	8	이 페이지가 해외에서 안 팔리는 이유를 근거 인용과 함께.

전체 스키마는 tools/list 로 받습니다. 각 설명은 그 툴이 무엇을 하는지와 어디서부터 믿으면 안 되는지를 함께 적습니다. 뒤쪽이 읽을 가치가 있는 부분입니다.

과금은 어떻게 되나요?

크레딧은 선불이고 툴이 실행된 뒤에 차감합니다. 절대 먼저 깎지 않습니다. 툴마다 정해진 크레딧이 있고(위 표), 유료 응답에는 _meta.credits_remaining 이 실려 에이전트가 스스로 잔액을 알고 사용자에게 알릴 수 있습니다. 평가용 키는 100 크레딧으로 시작합니다 — 답의 품질을 판단하기에는 충분하고 실서비스로 쓰기에는 부족한 자리입니다.

과금하지 않는 경우 — 이 목록을 공개하는 것 자체가 정책입니다:

인증·검증·레이트 리밋 실패
우리 쪽 오류와 타임아웃
isError: true 로 돌아온 모든 호출. 모델 요금을 이미 냈더라도 분석이 실패했으면 그건 우리 손실이지 고객 손실이 아닙니다
이미 답한 요청의 5분 이내 재시도

차감은 툴이 실행된 뒤에 합니다. 먼저 받고 나중에 돌려주지 않습니다. 유료 응답에는 _meta.credits_remaining 이 실려 있어 에이전트가 스스로 잔액을 알고 사용자에게 알릴 수 있습니다.

멱등. 에이전트는 재시도가 잦습니다. params._meta["ai.seldons/requestId"] 를 보내면 5분 안의 재요청은 첫 답을 그대로 무료로 돌려줍니다. 안 보내면 계정·툴·인자에서 우리가 만듭니다.

오류는 어떤 모양인가요?

툴 실패는 JSON-RPC 오류가 아니라 isError: true 인 정상 결과로 옵니다. MCP 규격이 그렇게 요구하고, 그래야 모델이 읽고 스스로 고칠 수 있습니다.

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Not enough credits for this call.",
    "retryable": false,
    "required": 3,
    "remaining": 0
  }
}

코드: AUTH_REQUIRED · INSUFFICIENT_CREDITS · INVALID_INPUT · RATE_LIMITED · URL_UNREACHABLE · INTERNAL_ERROR · UPSTREAM_UNAVAILABLE. retryable 은 항상 들어갑니다. 없으면 에이전트가 무한 재시도하거나, 반대로 일시 장애를 영구 실패로 처리하고 자기 추측으로 답을 만듭니다.

호출 한도는 얼마인가요?

키 없이 분당 10회·일 100회(IP 기준). 키가 있으면 요금제에 따라 분당 20회·일 500회부터 시작합니다. 상한은 우리가 의존하는 원천 데이터의 한도에서 역산했습니다 — 우리 한도가 원천보다 느슨하면 원천이 먼저 막히고, 그때는 한 사람이 아니라 전원이 동시에 실패합니다.

키는 어떻게 받나요?

크레딧 팩을 구매하시면 Lemon Squeezy 가 라이선스 키를 메일로 보냅니다. 그 키를 클레임 페이지에 붙여넣으면 크레딧이 이미 충전된 sk_live_… 키를 그 자리에서 돌려드립니다. 먼저 만들 계정도, 저희를 기다릴 일도 없습니다.

팩	크레딧	가격
Starter	3,000 크레딧	$29	구매
Team	20,000 크레딧	$149	구매
Scale	100,000 크레딧	$599	구매

사기 전에 유료 툴을 써보고 싶으시다면 무엇을 만드시는지 알려주세요. 100 크레딧이 든 평가용 키를 드립니다 — 답의 품질을 판단하기에는 충분하고 실서비스로 쓰기에는 부족한 자리입니다. 여기로 요청하세요.

크레딧은 만료되지 않고 구독이 아닙니다. Starter 는 상품 페이지 분석 약 375회, 수출가 계산 약 1,000회입니다. 팩은 호출 속도도 정합니다 — Starter 는 starter 티어, Team 과 Scale 은 team 티어입니다:

플랜	분당 호출	하루 호출
평가용 키	20	500
Starter	60	5,000
Team · Scale	300	50,000

같은 이메일로 다시 구매하시면 쓰시던 계정에 충전됩니다 — 키가 하나 더 생기지 않고 쓰던 키를 그대로 쓰십니다. 환불하시면 크레딧을 회수하며, 이미 쓰셨다면 잔액이 음수가 됩니다. 숨기는 것보다 그대로 보여드리는 편이 낫다고 봅니다.

가격은 미국 달러이고 Lemon Squeezy 가 판매자(merchant of record)입니다. 부가세·GST 처리와 세금계산서는 저희가 아니라 그쪽에서 나갑니다.

키는 sk_live_… 모양입니다. 저장하는 것은 해시뿐이라 잃어버리면 다시 보여드릴 수 없습니다 — 폐기하고 새로 발급합니다.

왜 만들었나요?

이 사이트의 도구들은 브랜드가 국경을 넘어 팔 때 생기는 질문에 답합니다. 저 시장에 도착시키면 얼마인지, 어떤 인증이 필요한지, 국내에서 되던 페이지가 왜 해외에서 안 되는지. 사람은 브라우저에서 무료로 씁니다.

같은 일을 하는 에이전트는 브라우저 폼을 쓸 수 없습니다. 같은 답을 데이터로 받아야 하고, 가정에는 이름표가, 출처에는 출처가 붙어 있어야 하며, 조회가 실패하면 명확한 모르겠다가 와야 합니다. 마지막이 생각보다 중요합니다 — 깨끗한 "모름"을 받지 못한 에이전트는 빈칸을 추측으로 채우고 그것을 답으로 내놓습니다.

웹 도구와 이 서버는 같은 코드를 부릅니다. 여기서 받은 숫자는 이 사이트의 계산기가 주는 숫자와 같습니다 — 주장이 아니라 빌드마다 검사합니다.