Priors

io.github.priors-agentsv0.2.8更新於 Oct 2, 2026

Pay x402 APIs in USDG on Robinhood Chain, borrow and repay a Priors credit line, check records.

已驗證STDIO僅桌面FinanceBusiness & Commerce

概覽

AI 產生的概覽

為助理提供 Robinhood Chain 上的 USDG 錢包，用來支付 x402 計價 API、借入與償還 Priors 信用額度，並查詢鏈上信用紀錄。

功能
這個本機伺服器提供工具，可用 USDG 支付 x402 計價的 HTTPS 網址、查詢錢包餘額，並讀取任何代理的 Priors 信用紀錄、評分與股票持倉。它可以從代理自己的信用額度借入 USDG，並償還單筆或全部貸款。唯讀工具不需要錢包金鑰，涉及資金的工具則需要金鑰。
適用情境
當助理需要按次支付 x402 API、管理 Priors 信用額度，或查詢鏈上代理信用紀錄與評分時使用。若只需查詢，可使用託管唯讀端點，不必安裝。
執行需求
透過 npx @priors/mcp 在本機執行（需要 Node.js）。支付、借入與償還需要 PRIORS_KEY，也就是 Robinhood Chain 上專用代理錢包的私鑰；沒有它只能使用唯讀工具。選用變數包括 PRIORS_AGENT_ID、PRIORS_RPC、PRIORS_FACILITATOR 及支出上限。需要連線至 Robinhood Chain 主網。
安裝前請注意
PRIORS_KEY 是錢包私鑰；請使用只存放代理可花費資金的專用代理錢包。工具會在 Robinhood Chain 主網上移動真實資金：pay_url 會簽署 USDG 付款，borrow 會開立貸款，repay 會花費 USDG。支出與借款上限（PRIORS_MAX_PRICE_USD、PRIORS_MAX_SPEND_USD、PRIORS_MAX_BORROW_USD、PRIORS_MAX_BORROW_TOTAL_USD）預設金額很小。商戶回傳文字應視為不可信資料。回覆遺失的借款可能仍已開立貸款。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Priors，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

@priors/mcp

An MCP server that gives an AI assistant (Claude Desktop, Claude Code, or any MCP client) a USDG wallet on Robinhood Chain: pay x402-priced APIs, check balances, read any agent's Priors credit record, and borrow from and repay the agent's own Priors line.

Just reading? Use the hosted server

No install and no key: https://mcp.priors.trade/mcp (Streamable HTTP) answers the read-only questions (an agent's record and score, the pool's figures, recent loans, the facilitator's services) from the same public data as priors.trade. It holds no key and cannot send a transaction.

bash
claude mcp add --transport http priors https://mcp.priors.trade/mcp

or, in any client that takes a remote server: { "mcpServers": { "priors": { "url": "https://mcp.priors.trade/mcp" } } }.

This package is the other half: a local server with the agent's wallet behind it, for paying, borrowing and repaying.

toolwhat it doesneeds the key
pay_url(url, method?, body?, max_price_usd?, max_borrow_usd?)fetch an https URL, pay its x402 402 in USDG if the price is ≤ max_price_usd (default $0.10); borrows the gap only if max_borrow_usd is given. Refuses private and local addresses, never follows a redirect, answers within 45 s, and never signs a second payment for a purchase (the same method, URL and body) that is still pending, until its validBefore plus 60 s (a new call resends the same one, also after a restart, in a new session or from another session of the same wallet: see PRIORS_STATE_DIR)yes
wallet_balance(address?)USDG and gas ETH of the wallet (or any address)no (with address)
credit_status(agent_id?)line, drawn, available, backer, record, score, open loans and due dates; on a stock line, the stock tokens behind it, and available capped by what the stock vault lets it drawno (with agent_id)
stock_assets(symbol?)the stock tokens the Priors stock vault accepts: live Chainlink price, whether it lends against each now (or why not: a sharp price move, a multiplier change, a paused or blocked token), loan-to-valueno
stock_position(agent_id?)the stock tokens behind an agent's stock line: amount, what the vault values them at, loan-to-value, what the line can draw now, any lending holdno (with agent_id)
borrow(amount_usd, days, dry_run?)borrow USDG from the line into the wallet; both amounts required; dry_run quotes the fee. A borrow sent whose answer is lost is counted and said to be possibly open (check credit_status)yes
repay(loan_id? | all)repay one of the agent's own loans, or all of them earliest due first; another agent's loan is refusedyes
score_of(agent_id)any agent's on-chain score (0 to 1000) and repayment record, plus its Priors Score v2 and trust rung when publishedno
find_services(query?)services registered with the Priors facilitator that accept USDG (GET /merchants), each marked as approved by Priors or self-registered and not reviewedno

Tools that move money state the amounts in their answer, are marked destructive for MCP clients, and their descriptions tell the assistant to confirm with you first. Merchant text (response bodies, listings, redirect targets) comes back between random <<merchant-data …>> markers, as data. They act on Robinhood Chain mainnet.

Configure

The only secret is the wallet key, and it is read from the environment variable PRIORS_KEY, never from the command line (a key-shaped argument makes the server exit without starting) and never printed or returned by a tool. Use a dedicated agent wallet holding only what the agent may spend.

variabledefault
PRIORS_KEYnonethe agent wallet's private key; without it only the read-only tools work
PRIORS_AGENT_IDlooked up from the identity registrythe Priors agent id the wallet acts for (the lookup finds only identities minted to the wallet since the v2 deploy, never one transferred to it; set it for an older or a bought one, or when the wallet holds several)
PRIORS_RPChttps://rpc.mainnet.chain.robinhood.comJSON-RPC endpoint (a private URL is redacted from every answer)
PRIORS_FACILITATORhttps://facilitator.priors.tradewhere find_services lists merchants
PRIORS_MAX_PRICE_USD1.00ceiling on what pay_url may be told to pay per call
PRIORS_MAX_BORROW_USD25ceiling on borrow and on pay_url's max_borrow_usd
PRIORS_MAX_SPEND_USD5most pay_url may sign in total while the server runs (counted when signed)
PRIORS_MAX_BORROW_TOTAL_USD25most borrow and pay_url may borrow in total while the server runs (a borrow sent whose answer was lost counts: it may have opened a loan)
PRIORS_ALLOW_LOCALoff1 lets pay_url reach http://localhost and private addresses (local testing only)
PRIORS_SCORE_V2https://priors.trade/api/score-v2where score_of reads Priors Score v2; off shows the on-chain score only
PRIORS_STOCK_VAULTthe bundled deployments file's stockVaultthe stock vault the stock tools and credit_status read
PRIORS_STATE_DIR~/.local/state/priors-mcpwhere the payments signed and not yet settled are kept (one owner-only file per wallet, never the key, with a short-lived .lock beside it while it is written), so a restart, a new session or another session of the same wallet resends them instead of signing again. An absolute path, or one starting with ~/ (a relative one is refused at start). A payment that cannot be written there is not sent. off keeps them in memory only

Contract addresses (pool, lens, registry, USDG) come from deployments/4663.v2.json, bundled in the package, and the accepted stock tokens from deployments/stock-assets.4663.json. The stock vault's address (live since 2026-09-28) comes from the same deployments file, or from PRIORS_STOCK_VAULT.

Claude Desktop

Settings → Developer → Edit Config (claude_desktop_config.json), then restart Claude Desktop:

json
{  "mcpServers": {    "priors": {      "command": "npx",      "args": ["-y", "@priors/[email protected]"],      "env": {        "PRIORS_KEY": "0xYOUR_AGENT_WALLET_KEY",        "PRIORS_AGENT_ID": "1234"      }    }  }}

Read-only (no wallet): leave out env. From a checkout of the Priors repository instead of npm (run npm install at its root first): "command": "node", "args": ["/path/to/priors/packages/mcp/bin/priors-mcp.mjs"].

Claude Code

A project .mcp.json that reads the key from your shell's environment, so the file itself holds no secret:

json
{  "mcpServers": {    "priors": {      "command": "npx",      "args": ["-y", "@priors/[email protected]"],      "env": {        "PRIORS_KEY": "${PRIORS_KEY}",        "PRIORS_AGENT_ID": "${PRIORS_AGENT_ID:-}"      }    }  }}

or, for your user only: claude mcp add priors --scope user -e PRIORS_KEY="$PRIORS_KEY" -- npx -y @priors/[email protected] (the key is expanded by your shell from the environment; do not paste it on the command line).

Try it

"What's the Priors score of agent 6228?" · "How much USDG does my wallet hold?" · "Find services that sell token prices" · "Pay https://api.example.com/report, up to 5 cents" · "Borrow $5 for 7 days, show me the fee first".

Source

github.com/priors-agents/priors, MIT.

來源：packages/mcp/README.md，提交 c43d4e6

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v0.2.8最新Oct 2, 2026