gold402-mcp

gold-402 위에 구축된 MCP 서버 — 24K Labs가 유지 관리하는 선별된 x402 디렉터리입니다. MCP를 지원하는 모든 에이전트(Claude, Cursor 또는 MCP를 말하는 모든 것)에게 x402 서비스를 찾고, 비용을 지출하기 전에 엔드포인트를 확인하는 네 가지 도구를 제공합니다.

상태: v0.1 — 테스트 완료, 패키징 완료, 아직 게시되지 않음. stdio를 통해 실행됩니다.

도구

무료 vs 유료

다섯 가지 도구 중 네 가지는 무료이며 계속 무료입니다 — 검색, 선반, 항목 조회, 실시간 프로브. 키, 지갑, 계정이 필요 없습니다.

gold402_verdict는 유료입니다: Base에서 $0.001 USDC. 유일한 유료 도구이며, 무료 프로브가 명시적으로 제공하지 않는 것, 즉 인간의 판단을 구매합니다. 유효한 402는 문이 작동한다는 것을 증명합니다. 평결은 유지 관리자가 낯선 사람의 돈을 쓸 가치가 있다고 말하는 것입니다.

이 서버는 지갑을 보유하지 않으며 귀하를 대신하여 결제하지 않습니다. gold402_verdict를 payment_signature 없이 한 번 호출하면 디코딩된 x402 조건(가격, 네트워크, 자산, payTo, 시간 제한)을 반환합니다. 자신의 지갑으로 서명하고 서명과 함께 다시 호출하세요. 돈은 귀하에서 24K Labs로 이동합니다. 이 프로세스는 경로에 포함되지 않습니다.

gold402_check_endpoint는 유지 관리자가 실행하는 문 확인을 호출 가능하게 만든 것입니다. 디렉터리에 없는 엔드포인트에서 작동하며, 이것이 핵심입니다: 낯선 사람에게 결제하려는 에이전트가 먼저 물어볼 수 있습니다.

Related MCP server: Secant Agent Research

답변이 주장하는 것과 주장하지 않는 것

목록에 등재된다는 것은 유지 관리자가 프로브하여 검토 시점에 x402 요청에 올바르게 응답했고, 주기적으로 다시 프로브한다는 의미입니다. 이는 제공자에 대한 감사, 가동 시간 보장, 또는 어떤 호출이 성공할 것이라는 약속이 아닙니다. 유효한 402는 문이 작동한다는 것을 증명합니다 — 서비스가 전달한다는 것은 아닙니다. 모든 응답에는 as_of 스탬프와 출처가 포함됩니다.

디렉터리에 없다는 것은 서비스에 대한 평결이 아닙니다. 선별된 목록이지 인구 조사가 아닙니다.

설치

uvx gold402-mcp            # no install step
pip install gold402-mcp    # then run: gold402-mcp

클론에서:

python3 -m venv .venv && ./.venv/bin/pip install -e .
./.venv/bin/gold402-mcp

클라이언트 구성

Claude Desktop / Claude Code (claude_desktop_config.json 또는 .mcp.json):

{
  "mcpServers": {
    "gold402": {
      "command": "uvx",
      "args": ["gold402-mcp"]
    }
  }
}

pip를 선호하시나요? 설치한 다음 인수 없이 "command": "gold402-mcp"를 사용하세요.

데이터 소스

https://24klabs.ai/directory.json — 공개, 게시, 15분 캐시. 키, 인증, 스크래핑 없음. 가져오기가 실패하고 캐시된 복사본이 있으면 캐시된 복사본이 제공되고 그 나이가 숨겨지지 않고 공개됩니다.

적용 범위, 명확히 설명. 해당 엔드포인트는 의도적인 미리보기입니다: 전체 선반 구조와 실제 선반별 개수를 포함하지만, 레코드로는 가장 최근에 등록된 항목만 포함합니다. 24K Labs는 익명 호출자에게 전체 세트를 대량으로 제공하지 않습니다(이유). 따라서 이 서버는 가지지 않은 도달 범위를 암시하지 않습니다:

• 모든 응답은 선별된 총계와 실제로 검색된 항목 수 둘 다 보고합니다;

• 미리보기 레코드가 없는 선반은 적용 범위 제한으로 보고되며, 빈 선반이나 존재하지 않는 선반으로 보고되지 않습니다;

• 미리보기 외의 항목: https://24klabs.ai/directory를 탐색하거나, /api/v1/verify?resource=<url>에서 리소스 하나를 조회하거나, gold402_check_endpoint를 사용하세요. 이 도구는 나열 여부와 관계없이 모든 엔드포인트에서 작동합니다.

테스트

./.venv/bin/python test_tools.py    # tool-level, incl. error paths
./.venv/bin/python test_stdio.py    # end-to-end over the real MCP protocol

둘 다 2026-08-20 기준으로 통과하며, 설치된 콘솔 스크립트(깨끗한 venv, 빌드된 휠에서 pip install)에 대해서도 통과합니다 — 소스 파일뿐만 아니라.

24K Labs가 선별 · 디렉터리: https://github.com/Haustorium12/gold-402