BlinkCodes 에이전트 인터페이스

blinkcodes.com을 위한 기계 판독 가능 인터페이스 — 기프트 카드 코드, 서비스 충전, 여행용 eSIM을 판매하고 이메일로 수 초 내에 전달하는 스토어입니다.

여기의 모든 것은 원격 호스팅 서비스입니다. 설치할 것도, 실행할 서버도 없습니다. 아래 URL에 클라이언트를 연결하기만 하면 됩니다. 이 저장소는 해당 엔드포인트를 문서화하고 스키마를 고정하며 작동 예제를 제공하기 위해 존재합니다.

검색 문서: /.well-known/agent-card.json, /.well-known/mcp/server-card.json, /.well-known/api-catalog, /.well-known/agent-skills/index.json, /.well-known/acp.json, /.well-known/ucp.

MCP 서버

공식 MCP 레지스트리에 **com.blinkcodes/catalog**로 게시됨 (server.json).

세 가지 도구. 두 카탈로그 도구는 읽기 전용이며 무료입니다 — 키도, 계정도, 결제도 필요 없습니다. 세 번째는 돈을 받으며, x402를 통해서만 가능합니다:

buy_product는 아래의 POST /api/v1/buy와 동일한 레일을 사용합니다 — 검증, 예약, 정산, 이행 순서로 — 따라서 MCP를 통해 스토어를 찾은 에이전트는 구매를 완료하기 위해 프로토콜을 변경할 필요가 없습니다. 첫 번째 호출에서는 아무것도 청구되지 않으며, 다른 두 도구를 사용하는 데 지갑이 필요하지 않습니다.

원격 MCP를 지원하는 클라이언트에 추가하세요:

{
  "mcpServers": {
    "blinkcodes": {
      "type": "http",
      "url": "https://blinkcodes.com/mcp"
    }
  }
}

전체 도구 스키마와 curl 트랜스크립트: docs/mcp.md.

stdio 전용 클라이언트는 Dockerfile의 브리지를 사용할 수 있으며, 이는 동일한 호스팅 엔드포인트로 프록시합니다:

docker build -t blinkcodes-mcp . && docker run -i --rm blinkcodes-mcp

클라이언트가 원격 MCP를 지원하는 곳에서는 위의 직접 URL을 선호하세요 — 브리지는 홉을 추가할 뿐 아무것도 사지 않습니다.

Related MCP server: the402-mcp-server

에이전트를 위한 구매

결제는 x402를 통한 Base의 USDC입니다. 하나의 엔드포인트, 두 번의 패스:

1. 주문 본문이 포함된 POST /api/v1/buy → 해당 정확한 항목에 대해 가격이 책정된 결제 요구사항과 order 블록(id, 액세스 토큰, 상태 URL)을 담은 402.

2. PAYMENT-SIGNATURE 헤더가 포함된 동일한 요청 → 코드와 함께 200, 또는 이행이 동기화 창을 초과하면 202 + status_url.

// the body, in both passes
{
  "email": "buyer@example.com",
  "product_type": "giftcard",   // giftcard | topup | esim | phone_rental
  "product_id": 187,
  "item_id": 1195,
  "quantity": 1
}

• 네트워크 eip155:8453, 자산 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 (USDC).

• x402 기본적으로 v2; v1 클라이언트는 X-PAYMENT를 보내거나 X-PAYMENT-VERSION: 1로 v1 견적을 요청합니다.

• GET /api/v1은 레일을 무료로 설명합니다.

• 아무것도 지정하지 않고 /api/v1/buy를 호출하면 레일의 최소 금액을 인용하는 402로 응답하며 주문을 생성하지 않습니다 — 이것이 크롤러에게 안전한 프로브 형태입니다.

작동 예제: examples/x402-buy.mjs. 레일, 최소 금액, 결제 가능한 코인 쌍: GET /api/public/payment-methods.

A2A

에이전트 카드는 /.well-known/agent-card.json, JSON-RPC message/send는 https://blinkcodes.com/a2a에 있습니다. 스킬은 두 카탈로그 도구에 buy_product를 더한 것이며, 이 전송 방식에서는 a2a-x402 결제 확장(https://github.com/google-a2a/a2a-x402/v0.1, 카탈로그 스킬이 무료이므로 required: false로 선언됨)을 전달합니다.

견적 → x402.payment.required가 포함된 input-required 상태의 Task; 결제 → x402.payment.payload가 포함된 동일한 taskId → completed 상태의 Task와 아티팩트로 전달. examples/a2a.sh를 참조하세요.

인간용 문서

스토어, 가격 및 약관: https://blinkcodes.com. 지원: support@blinkcodes.com.

라이선스

MIT — 이 저장소의 문서와 예제에 적용됩니다. 서비스 자체는 사이트에 게시된 약관의 적용을 받습니다.