btcmatic-mcp-server

MCP 서버는 BTCMatic agent API를 위한 것입니다: 자율 에이전트를 위한 호출당 지불 비트코인 컨텍스트 — 자체 보관 보안 레이더, 수수료 백분위, 가격 변동 창 및 조건 빈도 — 라이트닝을 통해 sats로 지불. 계정, API 키, 신용카드 없음: API는 인보이스와 함께 402로 응답하고, 에이전트의 지갑이 지불하며, 도구 호출은 preimage로 완료됩니다.

BTCMatic은 비트코인 이벤트 엔진입니다; 이 패키지는 에이전트의 진입점입니다. 여기의 모든 것은 읽기 전용 컨텍스트입니다 — 규칙을 생성하거나, 주문을 하거나, 누구에게 알리거나, 자금을 건드릴 수 없습니다.

도구

유료 호출 한 번은 약 21 sats입니다 (실시간 가격은 btcmatic_discover에 있습니다).

Related MCP server: x402-api

결제 작동 방식

1. 증명 없이 유료 도구를 호출하세요. 결과는 오류가 아닌 데이터로서의 402 제안입니다: { kind: "offer", price_sats, bolt11, payment_hash, next_step }.

2. 지갑이 bolt11을 지불하고 preimage를 표시합니다.

3. 동일한 도구를 { payment_hash, preimage }와 함께 다시 호출하세요. 증명은 일회용입니다.

선불: btcmatic_topup → 지불 → btcmatic_topup_claim → 토큰. 서버를 BTCMATIC_AGENT_TOKEN=agt_…로 시작하면 모든 유료 도구가 잔액에서 차감됩니다; 잔액이 0이면 도구는 { kind: "topup_needed" }로 응답합니다.

이 서버는 키를 보관하지 않으며 지불하지 않습니다. 증명을 이동할 뿐입니다; 지불은 항상 당신이 제어하는 지갑의 결정입니다. 증명 형식은 Authorization: L402 <payment_hash>:<preimage>입니다 — 결제 해시는 BTCMatic이 발행한 인보이스를 지칭하고 sha256(preimage) = payment_hash가 증명이므로 macaroon이 필요 없습니다.

설치

{
	"mcpServers": {
		"btcmatic": {
			"command": "npx",
			"args": ["-y", "btcmatic-mcp-server"],
			"env": { "BTCMATIC_AGENT_TOKEN": "agt_…" }
		}
	}
}

BTCMATIC_AGENT_TOKEN은 선택 사항입니다 (없으면 호출당 402 흐름). BTCMATIC_API_URL은 API 기본 URL을 재정의합니다 (기본값 https://api.btcmatic.com).

숫자가 의미하는 것 — 그리고 아닌 것

• 소스별 정확도는 BTCMatic이 수동으로 설정하고 btcmatic.com/radar에 게시하는 라벨에서 비롯됩니다; 라벨이 없는 소스는 정확도를 전혀 표시하지 않습니다.

• 수수료 백분위, 변동 창 및 빈도는 공개 시리즈에 대한 기술 통계입니다. 과거를 설명할 뿐이며, 어떤 것도 예측하지 않으며 여기의 어떤 것도 매수 또는 매도 추천이 아닙니다.

• 모든 유료 응답에는 지불된 가격, 남은 잔액, 면책 조항 및 가입 링크가 포함된 meta 블록이 포함됩니다 — 동일한 데이터는 BTCMatic 계정으로 무료입니다; 이 API는 계정을 가질 수 없는 클라이언트를 위해 존재합니다.

개발

pnpm install
pnpm build && pnpm test && pnpm lint
BTCMATIC_API_URL=http://localhost:3000 node dist/cli.js   # stdio transport

리소스

• 에이전트 API 문서: https://btcmatic.com/integrations/agents

• OpenAPI (agent 태그): https://api.btcmatic.com/docs

• 자동화를 위한 BTCMatic (API 키, n8n): https://btcmatic.com/integrations/n8n

라이선스

MIT