Peer MCP server
online · 100% uptimeio.github.zkp2p/peer·v0.4.1Read Peer protocol, market, checkout, and Peer Cash data through one MCP server.
0 stars
Reviews
Write oneNobody has reviewed Peer yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Peer tools (97, 1 write)
write = sends, deletes, buys or postspeer_balanceFreeRead the current USDC balance for an address.
peer_cash_buyerFreeReturn protocol history for the buyer that matched an order so an automation can assess delivery context without trusting display identity.
peer_cash_capabilitiesFreeReturn live Base USDC destinations, payout platforms, fiat currencies, payee hints, amount bounds, and pricing. Call this before naming a rail or currency.
peer_cash_estimateFreeEstimate fiat received for Base USDC at the live Chainlink oracle rate. This is not a locked quote; the binding rate resolves when a buyer fills.
peer_cash_fill_statsFreeReturn trailing 30-day fill counts and first-fill timing by payout platform and currency. Use this as historical routing evidence, never as a guarantee.
peer_cash_finalizeFreeRead a confirmed Base createDeposit receipt and resolve the resumable Peer deposit id. Call only after the host confirms the createDeposit transaction.
peer_cash_orderwrite actionFreeReturn one order state, amounts, fills, and next actions from its deposit id. Brief ORDER_NOT_FOUND responses after finalization may be indexer lag; retry this read, never the deposit transaction.
peer_cash_ordersFreeList orders owned by a maker wallet, optionally limited to orders that still need attention.
peer_cash_quote_sourceFreeQuote a live Relay route from an EVM source asset into Base USDC. The response contains unsigned transaction data; this tool never signs or submits it.
peer_cash_relay_statusFreeTrack a previously submitted cross-chain source route by Relay request ID. Retry this read; never resubmit from an unknown status.
peer_cash_source_capabilitiesFreeReturn live Relay-supported EVM source chains and tokens that can route into Base USDC before a Peer Cash order.
peer_checkout_listFreeList checkout sessions from the Pay API, with a local cache fallback.
peer_checkout_showFreeShow a single checkout session or poll its latest status.
peer_config_currenciesFreeList supported fiat currencies.
peer_config_platformsFreeList supported payment platforms.
peer_config_showFreeShow the stored Peer CLI config merged with current global flags.
peer_delegate_showFreeShow current controller-based delegation for a deposit.
peer_deposit_listFreeList deposits owned by the configured wallet or explicit owner.
peer_deposit_showFreeShow a single deposit by deposit ID.
peer_deposit_show_manyFreeShow multiple deposits by ID.
peer_guardian_availableFreeCheck whether the selected environment has an IntentGuardian deployment.
peer_guardian_payer_fundingFreeRead payer token balance and allowance available to IntentGuardian.
peer_guardian_policyFreeRead the live IntentGuardian fee and extension policy.
peer_guardian_quote_extensionFreeQuote the authoritative on-chain cost to extend an intent.
peer_indexer_delegations_by_depositFreeFetch the delegation record for a composite deposit ID via the indexer.
peer_indexer_deposits_by_idsFreeFetch multiple deposits by composite ID.
peer_indexer_deposits_by_ids_relationsFreeFetch multiple deposits with relations by composite ID.
peer_indexer_deposits_fund_activitiesFreeFetch fund activities for a deposit.
peer_indexer_deposits_listFreeList deposits via the indexer.
peer_indexer_deposits_list_relationsFreeList deposits with related entities via the indexer.
peer_indexer_deposits_showFreeFetch a deposit by composite ID via the indexer.
peer_indexer_deposits_snapshotsFreeFetch deposit daily snapshots.
peer_indexer_intents_by_deposit_idsFreeFetch intents for multiple deposits via the indexer.
peer_indexer_intents_by_ownerFreeFetch intents by owner via the indexer.
peer_indexer_intents_expiredFreeFetch expired intents via the indexer.
peer_indexer_intents_fulfilled_eventsFreeFetch fulfillment events for intents.
peer_indexer_intents_fulfillment_amountsFreeFetch fulfillment amounts for an intent.
peer_indexer_intents_fulfillment_and_paymentFreeFetch fulfillment and payment records for an intent.
peer_indexer_intents_showFreeFetch a single intent via the indexer.
peer_indexer_makers_fund_activitiesFreeFetch maker-level fund activities.
peer_indexer_queryFreePerform a raw GraphQL query against the indexer. Use sparingly; arbitrary queries can be expensive.
peer_intent_fulfill_inputsFreeInspect fulfill routing inputs for an intent.
peer_intent_hook_pre_getFreeGet the pre-intent hook for a deposit.
peer_intent_listFreeList intents for the configured wallet or explicit owner.
peer_intent_showFreeShow a single intent by hash.
peer_market_activityFreeFetch recent protocol activity from Peerlytics.
peer_market_api_key_listFreeList Peerlytics API keys for the authenticated account.
peer_market_compareFreeCompare live quote availability across platforms using the published SDK quote route.
peer_market_creditsFreeCheck Peerlytics API credit balance and usage.
peer_market_depositsFreeQuery deposits from Peerlytics with filtering.
peer_market_explorer_addressFreeLook up a wallet address profile on Peerlytics.
peer_market_explorer_depositFreeLook up a deposit on Peerlytics.
peer_market_explorer_intentFreeLook up an intent on Peerlytics.
peer_market_explorer_makerFreeLook up a maker profile on Peerlytics.
peer_market_explorer_searchFreeSearch across addresses, deposits, intents, and vaults on Peerlytics.
peer_market_explorer_vaultFreeLook up a vault on Peerlytics.
peer_market_explorer_verifierFreeLook up a verifier profile on Peerlytics.
peer_market_intentsFreeQuery intents from Peerlytics with filtering.
peer_market_leaderboardFreeFetch maker and taker leaderboard data from Peerlytics.
peer_market_maker_historyFreeFetch maker activity history for an address from Peerlytics.
peer_market_meta_currenciesFreeList supported currencies from Peerlytics.
peer_market_meta_platformsFreeList supported payment platforms from Peerlytics with method hashes.
peer_market_orderbookFreeFetch the live P2P orderbook from Peerlytics.
peer_market_protocol_statsFreeFetch aggregate Peerlytics protocol statistics.
peer_market_spreadsFreeFetch current market spreads from Peerlytics.
peer_market_taker_historyFreeFetch taker activity history for an address from Peerlytics.
peer_market_vaultsFreeFetch Peerlytics vault analytics.
peer_market_volumeFreeFetch Peerlytics protocol volume and analytics for a time range.
peer_oracle_supports_inlineFreeCheck whether the current escrow deployment supports inline oracle configs.
peer_oracle_validate_feedsFreeValidate bundled oracle feeds on-chain.
peer_payee_resolve_hashFreeResolve a payee hash from on-chain deposit data.
peer_pv_deposit_list_ownerFreeFetch deposits for an owner directly from ProtocolViewer.
peer_pv_deposit_showFreeFetch a deposit directly from ProtocolViewer.
peer_pv_deposit_show_manyFreeFetch multiple deposits directly from ProtocolViewer.
peer_pv_intent_list_ownerFreeFetch intents for an owner directly from ProtocolViewer.
peer_pv_intent_showFreeFetch a single intent directly from ProtocolViewer.
peer_quoteFreeGet fiat-to-USDC exchange quotes.
peer_stake_admissions_pausedFreeRead whether chargebackable intent admissions are paused.
peer_stake_authorizationFreeRead whether a stake owner authorizes a taker.
peer_stake_balanceFreeRead total stake owned by an address.
peer_stake_claimableFreeRead non-stake USDC claimable by a beneficiary.
peer_stake_dispute_protection_enabledFreeRead whether a deposit has dispute protection enabled for a payment method.
peer_stake_freeFreeRead stake available for withdrawal or a new lock.
peer_stake_indexed_stateFreeRead indexed staking, authorization, claim, and risk-window state with freshness metadata.
peer_stake_lockedFreeRead stake locked behind active chargeback windows.
peer_stake_ownerFreeResolve the effective stake owner backing a taker.
peer_stake_risk_windowFreeRead the minimum collateral lock window for a payment method.
peer_stake_selected_ownerFreeRead the stake owner selected by a taker before authorization checks.
peer_stake_stateFreeRead the authoritative StakeVault state for a staker and optional taker.
peer_vault_delegatesFreeList delegated deposits for a vault.
peer_vault_effective_rateFreeRead the effective rate for a delegated deposit pair.
peer_vault_listFreeList vaults via the indexer.
peer_vault_manager_feeFreeRead the effective manager fee for a delegated deposit.
peer_vault_manual_rate_updatesFreeFetch manual rate updates for a vault.
peer_vault_oracle_config_updatesFreeFetch oracle config updates for a vault.
peer_vault_showFreeShow vault details by rateManagerId.
peer_vault_snapshotsFreeFetch daily snapshots for a vault.
Public scan report
scanner v0.1.10 · 2026-10-15 · same rubric, same numbers if you re-run it
- –Code scanremote-only server, no package to scann/a
- Live reliabilityremote reachable in 631ms20/20
- Tool poisoning97 tool descriptions checked15/15
- Auth qualityopen endpoint exposes 1 write-action tools with no auth3/15
- Maintenancelast push 12 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10
Findings (1)
- highWrite-action tools reachable without authentication
auth.open-write
How Peer compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 65% of 48,243 servers
- Tools
- 97
- the typical server has 7
- Tools that change things
- 1%
- typical: 0%. Fewer write tools means less an agent can break
- Uptime
- 100%
- of our recent checks; the typical remote server answers 100%
- Response time
- 450 ms
- faster than 37% of 30,027 servers
What its tools let an agent do: 96 read · 1 change
Release history: 2 versions in the registry since 2026-09-09, latest 2026-09-21, typically one every 12 days.
Install Peer in Claude Code, Cursor or VS Code
claude mcp add --transport http peer https://mcp.peer.xyz/mcp
What the publisher says
From the Peer repository's README, as published. We do not edit it. Read it on GitHub
<!-- mcp-name: io.github.zkp2p/peer -->
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.
agents/runtime-manifest.json
- Docs and agent-readable text:
- Exact CLI schemas: agents/tool-catalog.json
- Error contract: agents/error-catalog.json
- Runtime profiles and counts:
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 --helpRun without a global install:
npx -y peer-protocol-cli@0.4.1 quote --from USD --amount 100 --platform wiseSuccessful 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 PEERPRIVATEKEY 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:
broadcasting.
- read-only — default protocol reads plus Peer Cash reads. No signing or
unsigned transaction plans but never accepts a private key, signs, or broadcasts.
- cash — the complete custody-separated peercash surface. It prepares
still preview unless the MCP process was started with global --yes.
- full — every generic CLI-backed MCP tool plus Peer Cash. Generic write tools
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/mcpRun 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:
payout rails and Relay-supported source chains and tokens.
- peercashcapabilities / peercashsource_capabilities — fetch live
evidence and buyer protocol history.
- peercashfillstats / peercash_buyer — inspect historical fill
cross-chain route into Base USDC without granting signer authority.
- peercashquotesource / peercashrelaystatus — quote and track a
transactions.
- peercashestimate — estimate fiat received at the current oracle rate.
- peercashprepare — return ordered unsigned approval and deposit
depositId.
- peercashfinalize — resolve a confirmed receipt into a durable
peercashpreparetopup — prepare follow-up transactions.
- peercashorder / peercashorders — resume and inspect orders.
- peercashprepareaccesspolicy, peercashprepare_withdraw, and
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Peer: common questions
- Is Peer MCP server safe?
- Mostly: it is graded B (83/100). Read the Peer safety report
- How do I install Peer?
- It runs remotely at mcp.peer.xyz. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does Peer need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Peer maintained?
- The last commit was 34 days ago (2026-10-02). The latest release is v0.4.1.
- Is Peer up?
- 100% of our last 28 checks got an answer. We check remote servers about four times a day.
- How does Peer compare with other MCP servers?
- safety score 83/100 (higher than 65% of 48,243 servers); tools 97 (the typical server has 7); tools that change things 1% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.