agentsvc-mcp

agentsvc.io MCP 서버 — x402 소액 결제 프로토콜을 통해 AI 에이전트가 20가지 종량제 유틸리티 서비스를 이용할 수 있게 합니다. 에이전트는 Base 메인넷에서 USDC로 자동 결제하며, 계정 생성, API 키 발급, 구독이 필요 없습니다.

소개

MCP 호환 AI 에이전트라면 무엇이든 20가지 유용한 도구를 사용할 수 있게 해주는 단일 MCP 서버입니다. 각 도구 호출 시 $0.001–$0.008 USDC가 에이전트 지갑에서 자동으로 결제됩니다.

사용 가능한 도구 (20종)

설치

요구 사항

• Node.js 18 이상

• npm install viem x402 (결제 서명용)

• Base 메인넷에 USDC가 포함된 지갑 개인 키

Claude Desktop

curl -O https://agentsvc.io/mcp-server.mjs
npm install viem x402

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "agentsvc": {
      "command": "node",
      "args": ["/path/to/mcp-server.mjs"],
      "env": {
        "X402_PRIVATE_KEY": "0x..."
      }
    }
  }
}

MCP 호환 에이전트

MCP 서버는 시작 시 라이브 카탈로그에서 20가지 도구를 모두 자동으로 검색합니다. 도구는 동적으로 로드되므로 서버를 업데이트하지 않아도 새로운 서비스가 자동으로 나타납니다.

결제 방식

각 도구 호출은 x402 프로토콜을 사용합니다:

1. 에이전트가 도구를 호출합니다.

2. 서버가 서비스를 확인합니다 (결제 요구 사항이 포함된 HTTP 402 응답).

3. MCP 서버가 개인 키를 사용하여 Base 메인넷에서 USDC 결제에 서명합니다.

4. 서비스가 실행되고 결과를 반환합니다.

결제는 **호출당 원자적(atomic)**으로 이루어지며, 호출이 성공할 때만 비용이 청구됩니다. 지갑에는 Base 메인넷의 USDC가 필요합니다.

Base에서 USDC 얻기:

• Ethereum에서 브리지: bridge.base.org

• Coinbase에서 구매 → Base로 출금

• Uniswap/Aerodrome (Base)에서 스왑

비용 예시

REST API

모든 도구는 MCP 없이 직접 REST API로도 사용할 수 있습니다:

# Step 1: probe (get payment requirements)
curl -X POST https://agentsvc.io/api/v1/proxy/ip-lookup \
  -H "Content-Type: application/json" \
  -d '{"ip": "8.8.8.8"}'
# → HTTP 402 with accepts[] payment requirements

# Step 2: sign + retry with X-Payment header
# See: https://agentsvc.io/docs

엔드포인트:

• GET /api/v1/services — 스키마 및 가격이 포함된 전체 카탈로그

• GET /api/openapi.json — OpenAPI 3.1 사양

• GET /.well-known/agent-services.json — 기계 판독 가능한 매니페스트

링크

• 라이브: agentsvc.io

• MCP 서버 다운로드: agentsvc.io/mcp-server.mjs

• 서비스 카탈로그: agentsvc.io/api/v1/services

• OpenAPI 사양: agentsvc.io/api/openapi.json

• 에이전트 매니페스트: agentsvc.io/.well-known/agent-services.json

• 문서: agentsvc.io/docs

결제 세부 정보

• 프로토콜: x402 exact scheme

• 네트워크: Base 메인넷 (체인 ID: 8453)

• 통화: USDC

• USDC 컨트랙트: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

• 원자 단위: 1 USDC = 1,000,000 단위

라이선스

MIT