Peer MCP sunucusu
Commit 12 Kas 2026Çeşitli MCP profilleri aracılığıyla bir yapay zeka istemcisinin Peer protokolü, market, ödeme ve Peer Cash iş akışlarıyla etkileşime girmesine olanak tanır.
Ayrıca bilinen adı zkp2p/peer-cli, peer-cli
- Yıldızlar
- 0
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- 0.4.1
- Son commit
- 12 Kas 2026
- Lisans
- MIT
Peer MCP nedir?
Peer bir MCP sunucusudur. Çeşitli MCP profilleri aracılığıyla bir yapay zeka istemcisinin Peer protokolü, market, ödeme ve Peer Cash iş akışlarıyla etkileşime girmesine olanak tanır.
Özet, projenin README dosyasından oluşturuldu
Peer MCP sunucusu hakkında
Bu sunucu, yapay zeka istemcileri kullanan geliştiricilerin Peer protokolü, market ve Peer Cash iş akışlarıyla etkileşime girmesini sağlar. Teklifler, alıcı kaydı ve para yatırma yaşam döngüleri gibi karmaşık finansal işlemlerin yönetilmesi için yapılandırılmış bir arayüz sunar. Kullanıcılar güvenlik ihtiyaçlarına göre üç farklı MCP profili arasından seçim yapabilirler: protokol ve Peer Cash verileri için read-only, imzalanmamış işlemleri hazırlayan saklama hizmetinden ayrılmış iş akışları için cash ve genel yazma araçları dahil tam operatör yetenekleri için full.
Sunucuyu kullanmak için peer-protocol-cli npm paketini kullanarak stdio üzerinden yerel olarak çalıştırabilir veya HTTP üzerinden barındırılan sürüme bağlanabilirsiniz. Yerel kurulumlar, PEER_PRIVATE_KEY ortam değişkeni veya bir cüzdan yolu aracılığıyla bir özel anahtar sağlayarak durum değiştiren komutlara izin verir. Sunucu; üretim, ön üretim ve staging dahil olmak üzere çeşitli ortamları destekler ve yerel kurulumlar için Node.js 22 veya daha yeni bir sürüm gerektirir. StakeVault para yatırma ve çekme işlemlerinden Peerlytics market keşfine ve USDC transferlerine kadar çeşitli görevleri yönetir.
Neler yapabilirsiniz
- 1Zincirler arası ödeme teklifi istemeBir yapay zeka ajanı, bir teklif alabilir ve Base USDC'ye giden zincirler arası bir rotayı takip edebilir.
- 2Peer Cash işlemlerini yönetmeGeliştiriciler, imzalanmamış onay ve para yatırma işlemlerini hazırlamak için cash profilini kullanabilirler.
- 3Market ve protokol verilerini incelemeBir ajan, Peerlytics market geçmişini ve protokol bilgilerini görüntülemek için read-only profilini kullanabilir.
- 4Tam protokol operasyonlarını yürütmeÖzel anahtara sahip yerel bir süreç, StakeVault yönetimi dahil olmak üzere tam operatör görevlerini gerçekleştirebilir.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Peer MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a eklePeer MCP'yi Claude Code içine yükleyin
$ claude mcp add --transport http peer-cli https://mcp.peer.xyz/mcpPeer MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"peer-cli": {
"url": "https://mcp.peer.xyz/mcp"
}
}
}Peer MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"peer-cli": {
"type": "http",
"url": "https://mcp.peer.xyz/mcp"
}
}
}Peer MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"peer-cli","type":"http","url":"https://mcp.peer.xyz/mcp"}'Peer MCP'yi Codex içine yükleyin
$ codex mcp add peer-cli --url https://mcp.peer.xyz/mcpPeer MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.peer-cli] url = "https://mcp.peer.xyz/mcp"
Peer MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user --transport http peer-cli https://mcp.peer.xyz/mcpPeer MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"peer-cli": {
"url": "https://mcp.peer.xyz/mcp",
"type": "http"
}
}
}Otomatik kontroller
Çalıştırıldı 15 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirzkp2p/peer-cli is public and reachablegithub.com/zkp2p/peer-cli ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-12github.com/zkp2p/peer-cli ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorinitialize answered with protocol 2025-06-18 in 462 msGeçti
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 soruları
Peer MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --transport http peer-cli https://mcp.peer.xyz/mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Peer MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Mevcut farklı MCP profilleri nelerdir?
Üç profil bulunmaktadır: protokol ve Peer Cash okumaları için 'read-only', saklama hizmetinden ayrılmış Peer Cash arayüzü için 'cash' ve Peer Cash dahil tüm CLI destekli araçlar için 'full'.