AON MCP 서버

MCP를 지원하는 모든 에이전트에게 실제로 구매 가능한 제품과 서비스를 추천할 수 있는 기능을 제공합니다 — 모든 제안에 실시간 가격과 추적 가능한 링크가 포함되며, Agent Offer Network에서 제공됩니다.

• 엔드포인트: POST https://api.aon.pro/v1/mcp

• 전송 방식: Streamable HTTP(무상태 JSON-RPC 2.0 — SSE 없음, 세션 핸드셰이크 없음)

• 인증: Authorization: Bearer <AON API 키> — Developer Portal에서 무료 키 발급

• 지금 사용해 보기: 공용 데모 키가 Quick Start에 공개되어 있습니다 — curl 한 번이면 가입 없이 사용 가능

• 문서: docs.aon.pro/mcp

도구

에이전트가 활용할 수 있는 설계 참고 사항:

• 관대한 설계 — 잘못된 값은 검색을 실패시키지 않습니다. "전송되지 않음"으로 처리되고 extra.hints[]에서 수정됩니다. 잘못된 인증, 잘못된 JSON, 누락된 intent.content, 또는 과도한 크기의 본문만 하드 실패합니다.

• 관련성 게이트 — 빈 결과 목록은 실제 답변이지, 채우기용이 아닙니다.

• 안내 루프 — 후속 제안에는 다음 호출에 직접 병합되는 RFC 7386 request_patch와, 채택 귀속을 위해 다시 에코할 origin이 포함됩니다.

Related MCP server: Agentic Travel Recommendations Service

빠른 시작

curl -s -X POST https://api.aon.pro/v1/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AON_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "aon_search_offers",
      "arguments": {
        "intent": {
          "content": [
            { "type": "input_text", "text": "credit card with cashback" }
          ]
        }
      }
    },
    "id": 1
  }'

아직 키가 없으신가요? Quick Start에서 공용 데모 키를 복사하여 $AON_API_KEY에 넣으세요.

클라이언트 설정

바로 붙여넣을 수 있는 구성은 examples/에 있습니다:

속도 제한

/v1/mcp는 키당 분당 60회의 tools/call 요청을 허용합니다. 핸드셰이크 호출(initialize, tools/list, notifications/*)은 계산되지 않습니다. 한도를 초과한 tools/call은 HTTP 200과 함께 JSON-RPC 오류 -32000을 반환하여 모델이 재시도 조언을 읽을 수 있게 합니다. 자세한 내용: Rate Limits & FAQ.

수익화 및 귀속

모든 제안에는 추적된 대상 링크(action.payload.target)가 포함됩니다. 이를 그대로 표시하세요 — 클릭과 전환은 API 키의 애플리케이션에 귀속되며, 이는 개발자 수익 공유의 기준입니다. 보고는 Developer Portal에서 확인할 수 있습니다.

레지스트리 매니페스트

server.json은 이 서버의 MCP 레지스트리 매니페스트입니다(스키마 2025-12-11, 네임스페이스 pro.aon — aon.pro 도메인에 대해 DNS 검증됨).

관련 저장소

• protocol — AgentOffer Protocol 사양(표준)

• schema — JSON 스키마, TypeScript 타입, 분류 체계

• examples — HTTP / SDK / 에이전트 통합 예제

• rfcs — 프로토콜 발전 제안

라이선스

Apache-2.0