Priors MCP (read-only), v0.1.0

Priors is agent credit on Robinhood Chain (chain 4663): AI agents borrow USDG from a pool, backed by sponsors, and
build a public repayment record. This is a hosted Model Context Protocol server that reads it. No key, no wallet.

Connect (MCP Streamable HTTP): https://mcp.priors.trade/mcp

  Claude Code:   claude mcp add --transport http priors-read https://mcp.priors.trade/mcp
  Claude Desktop / claude.ai: Settings > Connectors > Add custom connector > https://mcp.priors.trade/mcp
  Config file:   {"mcpServers": {"priors-read": {"type": "http", "url": "https://mcp.priors.trade/mcp"}}}

Tools (all read-only):
  agent_record(agent_id)   an agent's line, drawn, available, backer, record, score, open loans, default status
  score_of(agent_id)       an agent's score (0 to 1000) and repayment record
  pool_stats()             liquidity, principal out, reserve, fees, agents, open loans, loan terms
  recent_activity(limit?)  latest borrows, repays and defaults
  find_services(query?)    services that accept x402 payments in USDG through the Priors facilitator
  facilitator_info()       the facilitator's health and supported x402 kinds
  how_to_connect()         this page, plus how to pay and borrow

## Read-only (this server, no key)
Streamable HTTP MCP endpoint: https://mcp.priors.trade/mcp
- Claude Code: claude mcp add --transport http priors-read https://mcp.priors.trade/mcp
- Claude Desktop / claude.ai: Settings → Connectors → Add custom connector → https://mcp.priors.trade/mcp
- Any client config: {"mcpServers": {"priors-read": {"type": "http", "url": "https://mcp.priors.trade/mcp"}}}
Tools: agent_record, score_of, pool_stats, recent_activity, find_services, facilitator_info, how_to_connect.

## Paying, borrowing, repaying (local server, your own wallet)
Money-moving tools (pay_url, borrow, repay, wallet_balance, credit_status) run only in the local stdio server @priors/mcp, on your machine. The key stays in its environment: never paste a key into a chat, a tool argument or a command line. Use a dedicated agent wallet that holds only what the agent may spend.
{
  "mcpServers": {
    "priors": {
      "command": "npx",
      "args": ["-y", "@priors/mcp"],
      "env": { "PRIORS_KEY": "${PRIORS_KEY}", "PRIORS_AGENT_ID": "<your agent id>" }
    }
  }
}
Claude Code: claude mcp add priors --scope user -e PRIORS_KEY="$PRIORS_KEY" -- npx -y @priors/mcp
Limits (env): PRIORS_MAX_PRICE_USD (default 1.00 per call), PRIORS_MAX_BORROW_USD (default 25).
Getting a line: register an agent identity and get backed (the priors CLI: priors join, then an invite or a seat); see https://priors.trade.

## How an x402 payment works (USDG on Robinhood Chain, chain 4663)
1. The client requests the URL; a paid endpoint answers HTTP 402 with its payment requirements (price, payTo, asset USDG, network eip155:4663).
2. The client signs an EIP-3009 transferWithAuthorization for that amount on USDG's "Global Dollar" v1 domain (no gas for the payer).
3. It retries the request with the signed payment: header PAYMENT-SIGNATURE (x402 v2) or X-PAYMENT (v1).
4. The merchant has the facilitator (https://facilitator.priors.trade) verify and settle it on-chain, then serves the response (PAYMENT-RESPONSE header carries the settlement).
5. If the wallet is short, pay_url with max_borrow_usd borrows the gap from the agent's Priors line first; that loan (principal + fee) must be repaid before its due date, or the agent's record is burnt and its backer pays.
pay_url does all of this and refuses prices above max_price_usd (default 0.10 USD).

Site: https://priors.trade