Peer MCP server
2026년 11월 12일 커밋다양한 MCP 프로필을 통해 AI 클라이언트가 Peer 프로토콜, 마켓, 체크아웃 및 Peer Cash 워크플로우와 상호작용할 수 있도록 지원합니다.
다른 이름 zkp2p/peer-cli, peer-cli
- 스타
- 0
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 0.4.1
- 마지막 커밋
- 2026년 11월 12일
- 라이선스
- MIT
Peer MCP란?
Peer은(는) MCP server입니다. 다양한 MCP 프로필을 통해 AI 클라이언트가 Peer 프로토콜, 마켓, 체크아웃 및 Peer Cash 워크플로우와 상호작용할 수 있도록 지원합니다.
프로젝트 README에서 생성된 요약
Peer MCP server 정보
이 MCP server는 AI 클라이언트를 사용하는 개발자가 Peer 프로토콜, 마켓 및 Peer Cash 워크플로우와 상호작용할 수 있도록 지원합니다. 견적 확인, 수취인 등록, 입금 라이프사이클과 같은 복잡한 금융 작업을 관리할 수 있는 구조화된 인터페이스를 제공합니다. 사용자는 보안 요구 사항에 따라 세 가지 MCP 프로필 중 하나를 선택할 수 있습니다. 프로토콜 및 Peer Cash 데이터 조회를 위한 read-only, 서명되지 않은 트랜잭션을 준비하는 수탁 분리 워크플로우용 cash, 그리고 일반 쓰기 도구를 포함한 전체 운영 기능을 제공하는 full 프로필이 있습니다.
이 server를 사용하려면 peer-protocol-cli npm 패키지를 사용하여 stdio를 통해 로컬에서 실행하거나 HTTP를 통해 호스팅 버전에 연결할 수 있습니다. 로컬 설치 시 PEER_PRIVATE_KEY 환경 변수나 지갑 경로를 통해 개인 키를 제공하면 상태 변경 명령을 실행할 수 있습니다. 이 server는 production, preproduction, staging을 포함한 다양한 환경을 지원하며, 로컬 설정을 위해 Node.js 22 이상의 버전이 필요합니다. StakeVault 입출금부터 Peerlytics 마켓 탐색 및 USDC 전송에 이르기까지 다양한 작업을 관리합니다.
활용 사례
- 1크로스체인 결제 견적 요청AI agent가 견적을 가져오고 Base USDC로의 크로스체인 경로를 추적할 수 있습니다.
- 2Peer Cash 트랜잭션 관리개발자는 cash 프로필을 사용하여 서명되지 않은 승인 및 입금 트랜잭션을 준비할 수 있습니다.
- 3마켓 및 프로토콜 데이터 조사agent가 read-only 프로필을 사용하여 Peerlytics 마켓 히스토리와 프로토콜 정보를 조회할 수 있습니다.
- 4전체 프로토콜 작업 실행개인 키를 보유한 로컬 프로세스는 StakeVault 관리를 포함한 전체 운영 작업을 수행할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Peer MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Peer MCP 설치
$ claude mcp add --transport http peer-cli https://mcp.peer.xyz/mcpCursor에 Peer MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"peer-cli": {
"url": "https://mcp.peer.xyz/mcp"
}
}
}VS Code에 Peer MCP 설치
.vscode/mcp.json
{
"servers": {
"peer-cli": {
"type": "http",
"url": "https://mcp.peer.xyz/mcp"
}
}
}VS Code CLI에 Peer MCP 설치
$ code --add-mcp '{"name":"peer-cli","type":"http","url":"https://mcp.peer.xyz/mcp"}'Codex에 Peer MCP 설치
$ codex mcp add peer-cli --url https://mcp.peer.xyz/mcpCodex config.toml에 Peer MCP 설치
~/.codex/config.toml
[mcp_servers.peer-cli] url = "https://mcp.peer.xyz/mcp"
Gemini CLI에 Peer MCP 설치
$ gemini mcp add -s user --transport http peer-cli https://mcp.peer.xyz/mcpGemini settings.json에 Peer MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"peer-cli": {
"url": "https://mcp.peer.xyz/mcp",
"type": "http"
}
}
}자동 검사
2026년 11월 15일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능zkp2p/peer-cli is public and reachablegithub.com/zkp2p/peer-cli ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-12github.com/zkp2p/peer-cli ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답initialize answered with protocol 2025-06-18 in 462 ms통과
README
GitHub에서 보기peer-cli
The canonical agent interface for Peer: one JSON-first CLI, local and hosted MCP servers, and one generated contract for protocol, indexer, market, checkout, and Peer Cash workflows.
- Docs and agent-readable text: https://agents.peer.xyz
- Exact CLI schemas:
agents/tool-catalog.json - Error contract:
agents/error-catalog.json - Runtime profiles and counts:
agents/runtime-manifest.json
The generated files come from the runtime registries. Do not hand-maintain a second command list in documentation.
Install
Node.js 22 or newer is required.
The package is peer-protocol-cli; do not install the unrelated unscoped
peer-cli package.
npm install --global peer-protocol-cli@0.4.1
peer --help
Run without a global install:
npx -y peer-protocol-cli@0.4.1 quote --from USD --amount 100 --platform wise
Successful output is JSON by default. Errors always use the canonical JSON
error envelope on stderr. --format table changes successful human-facing
output only.
Safety model
Read commands execute immediately. Commands that can mutate state return a
transaction or API preview first and execute only when the process receives
--yes.
Signer material resolves from PEER_PRIVATE_KEY or --wallet-path. Passing a
private key on the command line is supported but visible in process listings;
prefer the environment or an owner-readable wallet file. Persistent config and
checkout caches are written with owner-only permissions.
Never start a write-capable MCP process with --yes unless every write tool in
that process is intentionally allowed to broadcast without a second CLI
preview.
MCP profiles
peer mcp requires one of three explicit profiles:
read-only— default protocol reads plus Peer Cash reads. No signing or broadcasting.cash— the complete custody-separatedpeer_cash_*surface. It prepares unsigned transaction plans but never accepts a private key, signs, or broadcasts.full— every generic CLI-backed MCP tool plus Peer Cash. Generic write tools still preview unless the MCP process was started with global--yes.
The current tool counts are generated in agents/runtime-manifest.json.
{
"mcpServers": {
"peer": {
"command": "npx",
"args": [
"-y",
"peer-protocol-cli@0.4.1",
"mcp",
"--profile",
"read-only"
]
}
}
}
Use --profile cash for the portable Peer Cash workflow or --profile full
for the complete operator surface.
The hosted MCP server exposes only the read-only profile over Streamable HTTP:
https://mcp.peer.xyz/mcp
Run the same transport yourself with peer mcp --transport http. HTTP refuses
the cash and full profiles; those authority-bearing profiles remain local
stdio processes.
Peer Cash
The retired standalone peer-cash-mcp server now lives here. Its tool names and
custody boundary are unchanged:
peer_cash_capabilities/peer_cash_source_capabilities— fetch live payout rails and Relay-supported source chains and tokens.peer_cash_fill_stats/peer_cash_buyer— inspect historical fill evidence and buyer protocol history.peer_cash_quote_source/peer_cash_relay_status— quote and track a cross-chain route into Base USDC without granting signer authority.peer_cash_estimate— estimate fiat received at the current oracle rate.peer_cash_prepare— return ordered unsigned approval and deposit transactions.peer_cash_finalize— resolve a confirmed receipt into a durabledepositId.peer_cash_order/peer_cash_orders— resume and inspect orders.peer_cash_prepare_access_policy,peer_cash_prepare_withdraw, andpeer_cash_prepare_top_up— prepare follow-up transactions.
Base USDC amounts are decimal strings in 6-decimal base units: 100 USDC is
100000000. Estimates are not locked quotes; the binding Chainlink rate
resolves when a buyer fills.
Install the packaged portable skill from
skills/peer-cash/SKILL.md when the agent host
supports Agent Skills.
Configuration
Configuration resolves in this order:
- CLI flags
- environment variables
~/.peer/config.json- runtime defaults
Common settings:
PEER_ENV:production,preproduction, orstagingPEER_PRIVATE_KEY/PEER_WALLET_PATH: signer material for generic write commandsPEER_RPC_URL: Base RPC overridePEER_API_KEY: Curator API key when requiredPEER_INDEXER_API_KEY/PEER_INDEXER_URL: indexer overridesPEER_MARKET_API_KEY/PEER_MARKET_BASE_URL: Peerlytics accessPEER_PAY_API_KEY/PEER_PAY_BASE_URL: hosted checkout accessPEER_BASE_API_URL: Curator override. Defaults followPEER_ENV:api.zkp2p.xyz,api-preprod.zkp2p.xyz, orapi-staging.zkp2p.xyz.PEER_CASH_RPC_URL,PEER_CASH_API_KEY,PEER_CASH_REFERRAL_CODE, andPEER_CASH_REFERRER: cash-profile overrides
Use peer config show, set, unset, and reset for persistent local
settings. peer config show masks secret values. Prefer environment variables
for credentials.
Command families
The CLI covers:
- quotes, payee registration, and payee-hash resolution
- deposit lifecycle, payment methods, currencies, oracle configuration, and batch updates
- intents, pre-intent hooks, fulfillment, release, and cleanup
- StakeVault deposits, withdrawals, authorization, indexed freshness, and matured chargeback releases
- IntentGuardian policy, live extension quotes, payer funding, and preview-first intent extension
- ProtocolViewer and indexer reads, including a raw GraphQL escape hatch
- vaults, rate managers, delegation, fees, and snapshots
- Peerlytics market, explorer, history, attribution, and API-key operations
- USDC balances and transfers
- hosted checkout creation, reads, cancellation, and local resume cache
- local config and environment inspection
Run peer --help, peer <family> --help, or inspect the generated tool catalog
for the exact current paths, flags, schemas, auth requirements, and danger
markers.
Every command also accepts --params <json> and --params-file <path>. Typed
flags override raw values.
Development
This repository uses npm and its committed package-lock.json.
npm install
npm run dev -- quote --from USD --amount 100 --platform wise
npm run check
npm run build regenerates all agent catalogs before bundling peer and the
public MCP library entry point. Run npm run test:e2e after changing networked
flows or checkout behavior.
The documentation application for agents.peer.xyz is owned by
zkp2p/zkp2p-clients at clients/agents; this repository owns the executable
runtime, package manifests, portable skill, and generated contracts it
documents.
Release, deploy and publish
One release ships three things from the same commit: the hosted MCP server
(https://mcp.peer.xyz), the npm package peer-protocol-cli, and the MCP
Registry entry from server.json. Do them in this order:
- Version on
main. Align the version inpackage.json,mcp.json,plugin.json,server.jsonand the packaged skill, and merge tomainwith CI green. - Deploy. Fast-forward
releases/prodto that commit..github/workflows/deploy.ymlrequires a successfulci.ymlrun for the commit, buildsdeploy/Dockerfile, and deploys it over SSM with peer-deploy's blue-green strategy. Afterwardshttps://mcp.peer.xyz/healthreports the newversion. - Publish to npm. Dispatch
publish.ymlonmainwhilemainstill points at the release commit. It runsnpm run checkandnpm publishthrough npm trusted publishing (GitHub OIDC); there is no npm token. - Publish to the MCP Registry. Dispatch
publish-mcp.ymlonmain. It checks that npm haspeer-protocol-cli@<server.json version>and that the hosted/healthreports that version, then publishesserver.jsonwith GitHub OIDC. It skips a version the registry already has.
Production config is Infisical project mcp, env prod; config CD snapshots it
to Secrets Manager peer/mcp/prod and runs Deploy releases/prod (reconcile)
automatically. Roll back the hosted server by moving releases/prod to the last
known-good commit; npm and registry versions are not rolled back, so ship a new
version instead. Deploy output is in CloudWatch /peer/deploy/mcp. See
deploy/AWS.md for details.
UPI
UPI/INR is available in production, preproduction and staging, matching the
@zkp2p/sdk catalog. peer config platforms lists it alongside the other
rails, and peer quote --from INR --amount 100 --platform upi requests a
quote. Deposit creation, payee registration and intent previews accept the same
platform.
Peer MCP 질문
Peer MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --transport http peer-cli https://mcp.peer.xyz/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Peer MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
사용 가능한 MCP 프로필에는 어떤 것들이 있나요?
세 가지 프로필이 있습니다: 프로토콜 및 Peer Cash 읽기 전용인 'read-only', 수탁이 분리된 Peer Cash 인터페이스를 위한 'cash', 그리고 Peer Cash를 포함하여 CLI 기반의 모든 도구를 지원하는 'full' 프로필입니다.