Peer MCP server
Commit 12 Nov 2026Memungkinkan AI client untuk berinteraksi dengan protokol Peer, market, checkout, dan workflow Peer Cash melalui berbagai profil MCP.
Juga dikenal sebagai zkp2p/peer-cli, peer-cli
- Stars
- 0
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- 0.4.1
- Commit terakhir
- 12 Nov 2026
- Lisensi
- MIT
Apa itu Peer MCP?
Peer adalah MCP server. Memungkinkan AI client untuk berinteraksi dengan protokol Peer, market, checkout, dan workflow Peer Cash melalui berbagai profil MCP.
Ringkasan dibuat dari README proyek
Tentang Peer MCP server
Server ini memungkinkan developer yang menggunakan AI client untuk berinteraksi dengan protokol Peer, market, dan workflow Peer Cash. Server ini menyediakan interface terstruktur untuk mengelola operasi finansial yang kompleks seperti quote, registrasi payee, dan lifecycle deposit. Anda dapat memilih di antara tiga profil MCP yang berbeda tergantung pada kebutuhan keamanan Anda: read-only untuk data protokol dan Peer Cash, cash untuk workflow terpisah secara custody yang menyiapkan transaksi tanpa tanda tangan (unsigned), dan full untuk kapabilitas operator lengkap termasuk tool write generik.
Untuk menggunakan server ini, Anda dapat menjalankannya secara lokal via stdio menggunakan npm package peer-protocol-cli atau terhubung ke versi hosted melalui HTTP. Instalasi lokal memungkinkan perintah yang mengubah state dengan menyediakan private key melalui environment variable PEER_PRIVATE_KEY atau path wallet. Server ini mendukung berbagai environment termasuk production, preproduction, dan staging, serta memerlukan Node.js versi 22 atau terbaru untuk setup lokal. Server ini mengelola berbagai tugas mulai dari deposit dan penarikan StakeVault hingga eksplorasi market Peerlytics dan transfer USDC.
Apa yang bisa Anda lakukan dengannya
- 1Meminta quote pembayaran cross-chainAI agent dapat mengambil quote dan melacak rute cross-chain ke Base USDC.
- 2Mengelola transaksi Peer CashDeveloper dapat menggunakan profil cash untuk menyiapkan transaksi approval dan deposit yang belum ditandatangani.
- 3Memeriksa data market dan protokolAgent dapat menggunakan profil read-only untuk melihat riwayat market Peerlytics dan informasi protokol.
- 4Menjalankan operasi protokol secara penuhProses lokal dengan private key dapat melakukan tugas operator lengkap termasuk manajemen StakeVault.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal Peer MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal Peer MCP di Claude Code
$ claude mcp add --transport http peer-cli https://mcp.peer.xyz/mcpInstal Peer MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"peer-cli": {
"url": "https://mcp.peer.xyz/mcp"
}
}
}Instal Peer MCP di VS Code
.vscode/mcp.json
{
"servers": {
"peer-cli": {
"type": "http",
"url": "https://mcp.peer.xyz/mcp"
}
}
}Instal Peer MCP di VS Code CLI
$ code --add-mcp '{"name":"peer-cli","type":"http","url":"https://mcp.peer.xyz/mcp"}'Instal Peer MCP di Codex
$ codex mcp add peer-cli --url https://mcp.peer.xyz/mcpInstal Peer MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.peer-cli] url = "https://mcp.peer.xyz/mcp"
Instal Peer MCP di Gemini CLI
$ gemini mcp add -s user --transport http peer-cli https://mcp.peer.xyz/mcpInstal Peer MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"peer-cli": {
"url": "https://mcp.peer.xyz/mcp",
"type": "http"
}
}
}Pengecekan otomatis
Berjalan 15 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkauzkp2p/peer-cli is public and reachablegithub.com/zkp2p/peer-cli ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-11-12github.com/zkp2p/peer-cli ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPinitialize answered with protocol 2025-06-18 in 462 msLolos
README
Lihat di GitHubpeer-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.
Pertanyaan tentang Peer MCP
Bagaimana cara menambahkan Peer MCP ke Claude Code?
Jalankan claude mcp add --transport http peer-cli https://mcp.peer.xyz/mcp di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan Peer MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Apa saja profil MCP yang tersedia?
Terdapat tiga profil: 'read-only' untuk membaca protokol dan Peer Cash, 'cash' untuk surface Peer Cash yang terpisah secara custody, dan 'full' untuk semua tool berbasis CLI termasuk Peer Cash.