MCP x402 — AI 에이전트를 위한 증거 기반 웹 검증

에이전트가 행동하기 전에 판매자, 제품, 제안, 정책 또는 주장을 검증하세요

AI 에이전트에게 공개 HTTP(S) 페이지와 1~10개의 구체적인 조건을 제공하세요. verificar_condicoes 도구는 각 조건에 대해 증거 기반 결정을 반환합니다:

• confirmado — 페이지가 조건을 명확히 지지합니다.

• rejeitado — 페이지가 조건을 명확히 반박합니다.

• incerto — 사용 가능한 페이지 증거가 불충분합니다.

각 검증에는 최종 소스 URL, 페이지 제목, 타임스탬프, 조건별 설명, 가능한 경우 인용된 증거, 고유한 verificationId, SHA-256 pageHash가 포함됩니다.

설계 대상

• AI 구매 및 조달 에이전트;

• 판매자, 제품 및 제안 검증;

• 구매 전 실사;

• 정책 및 약관 확인;

• 행동을 취하기 전에 증거가 필요한 상업 자동화.

간단한 x402 통합

• 결제 전 무료 사전 검증.

• Base 메인넷에서 검증당 $0.05 USDC.

• 계정이나 구독 불필요.

• MCP 및 HTTP를 통해 사용 가능.

• 이 저장소에 즉시 실행 가능한 구매자 포함.

• Coinbase x402 검증 통과 및 Bazaar 검색 활성화.

라이브 엔드포인트

• MCP: https://mcp-x402-production.up.railway.app/mcp

• 무료 검증 사전 검사: POST https://mcp-x402-production.up.railway.app/preflight/verify-conditions

• 유료 검증: POST https://mcp-x402-production.up.railway.app/verify-conditions

• 상태 확인: GET https://mcp-x402-production.up.railway.app/health

서비스는 또한 analisar_url 및 consultar_ia를 통해 유료 공개 URL 분석 및 일반 AI 상담을 제공합니다.

Related MCP server: Pylon MCP Server

라이브 서비스

• 기본 URL: https://mcp-x402-production.up.railway.app

• 상태 확인: GET /health

• MCP 엔드포인트: POST /mcp

• 유료 URL 분석: POST /analyze

• 가격: 유료 요청당 $0.05 USDC

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

프로덕션 상태

• Railway에서 프로덕션 배포 활성

• x402 버전 2 결제 흐름

• Base 메인넷 결제 (eip155:8453)

• Coinbase x402 검증 통과

• HTTP 402로 시뮬레이션 수락

• Bazaar 검색 메타데이터 활성화

• Coinbase 인덱스 활성

MCP 도구

결정 검증

verificar_condicoes — $0.05 USDC

에이전트를 위한 유료 결정 검증 도구.

공개 URL과 하나 이상의 구체적인 조건을 제공하세요. 해당 페이지에서 추출된 증거만을 기반으로 결정을 반환합니다:

• confirmado — 페이지가 조건을 명확히 입증합니다.

• rejeitado — 페이지가 조건을 명확히 반박합니다.

• incerto — 페이지가 충분한 증거를 제공하지 않습니다.

각 결과에는 최종 소스 URL, 페이지 제목, 검증 타임스탬프, 조건별 설명, 가능한 경우 짧은 인용 증거가 포함됩니다.

예시 조건:

• "페이지가 판매자를 식별합니다."

• "제품이 포르투갈에서 제공됩니다."

• "페이지가 유로 가격을 표시합니다."

• "문서가 서비스가 x402를 지원한다고 명시합니다."

이 도구는 다음 행동을 취하기 전에 증거 기반 결정이 필요한 에이전트를 위해 설계되었습니다.

기술

• Node.js 및 TypeScript

• Express

• Model Context Protocol

• OpenAI Responses API

• x402 결제

• viem

• Cheerio

• Railway

보안

• Railway 제공 HTTPS

• Helmet 보안 헤더

• 15분당 100개 요청 속도 제한

• 고유 요청 ID가 있는 구조화된 요청 로그

• 호스트 검증 및 Railway 상태 확인 지원

• /v1/responses에만 액세스할 수 있는 제한된 OpenAI API 키

• 환경 파일 및 비밀은 Git에서 제외

환경 변수

서버

로컬 구매자

로컬 .env.test 파일 예시:

EVM_PRIVATE_KEY=your_private_key_here

로컬 개발

의존성 설치:

npm install

개발 서버 시작:

npm run dev

프로젝트 빌드:

npm run build

컴파일된 서버 시작:

npm start

상태 확인

상태 엔드포인트는 공개이며 결제가 필요하지 않습니다:

curl https://mcp-x402-production.up.railway.app/health

즉시 실행 가능한 x402 구매자

저장소에는 애플리케이션 및 AI 에이전트를 위한 즉시 실행 가능한 구매자가 포함되어 있습니다. MCP 구매자는 라이브 서비스에 연결하고, Base 메인넷 USDC 및 최대 $0.05 결제에 대해 x402 결제 요구 사항을 검증하고, 결제에 서명하고, 동일한 도구 호출을 재시도하고, 정산 영수증과 결과를 출력합니다.

구매자 복제 및 준비:

git clone https://github.com/Diogoup26/mcp-x402.git
cd mcp-x402
npm install

프로젝트 루트에 로컬 .env.test 파일 생성:

EVM_PRIVATE_KEY=0xYOUR_64_HEX_CHARACTER_PRIVATE_KEY

.env.test를 커밋하거나 개인 키를 노출하지 마세요.

프로젝트 빌드:

npm run build

다음 명령은 Base 메인넷에서 실제 x402 결제를 승인합니다:

• consultar_ia: $0.02 USDC

• analisar_url: $0.05 USDC

• verificar_condicoes: $0.05 USDC

HTTP URL 분석

npm run analyze -- "https://example.com" "Summarize this page."

HTTP 결정 검증

npm run verify -- "https://example.com" "The page identifies the seller."

MCP URL 분석

npm run mcp:analyze -- "https://example.com" "Summarize this page."

MCP AI 상담

npm run mcp:consult -- "Reply only with: MCP OK"

MCP 결정 검증

npm run mcp:verify -- "https://example.com" "The page identifies the seller."

성공적인 MCP 결제는 다음을 출력합니다:

• PAGAMENTO MCP: success

• 정산 영수증

• 도구 응답

MCP 구매자는 개인 키를 절대 출력하지 않으며 다음 결제를 거부합니다:

• Base 메인넷이 아닌 경우;

• 구성된 Base USDC 계약을 사용하지 않는 경우;

• $0.05 USDC를 초과하는 경우.

배포

main 브랜치는 Railway에 연결되어 있습니다. 성공적인 푸시마다 새 배포가 트리거됩니다. Railway는 다음을 사용합니다:

npm run build
npm start

배포 상태 확인 경로는 /health입니다.

라이선스

ISC