Priors — Claude Code MCP server: what it does, how to install
Equips an agent with a Robinhood Chain USDG wallet to handle x402 API payments and manage credit lines.
claude mcp add --env PRIORS_KEY=<PRIORS_KEY> --env PRIORS_KEY_FILE=<PRIORS_KEY_FILE> --env PRIORS_AGENT_ID=<PRIORS_AGENT_ID> --env PRIORS_MAX_PRICE_USD=<PRIORS_MAX_PRICE_USD> --env PRIORS_MAX_SPEND_USD=<PRIORS_MAX_SPEND_USD> --transport stdio mcp -- npx -y @priors/mcpWhat Priors does
Priors connects your agent to a USDG wallet on Robinhood Chain. It processes HTTP 402 responses to settle machine-to-machine x402 invoices, checking prices against preset limits before spending. Public inspection tools can run directly via the hosted endpoint https://mcp.priors.trade/mcp without configuring secrets.
The local @priors/mcp package handles active financial operations. Through its interface, an agent inspects credit scores, borrows against Priors credit lines, repays debt, and deposits unallocated funds into Morpho vaults. Every state-changing transaction demands ETH for gas alongside PRIORS_KEY; lacking gas stops transaction execution immediately.
What it helps with
- settle x402 HTTP invoices directly in USDG
- inspect agent credit ratings and outstanding debt
- borrow and return funds on a Priors credit line
- deposit idle USDG balances into Morpho savings
Example prompts for the agent
- Check the USDG wallet balance and inspect our open credit line.
- Fetch the target endpoint and settle the x402 invoice if it is under the price cap.
- Deposit unspent USDG into the savings vault.
How to install Priors
Platform CLI
claude mcp add --env PRIORS_KEY=<PRIORS_KEY> --env PRIORS_KEY_FILE=<PRIORS_KEY_FILE> --env PRIORS_AGENT_ID=<PRIORS_AGENT_ID> --env PRIORS_MAX_PRICE_USD=<PRIORS_MAX_PRICE_USD> --env PRIORS_MAX_SPEND_USD=<PRIORS_MAX_SPEND_USD> --transport stdio mcp -- npx -y @priors/mcpReplace <…> with your own values. 4 more environment variables are in the server README
Platform CLI
codex mcp add mcp --env PRIORS_KEY=<PRIORS_KEY> --env PRIORS_KEY_FILE=<PRIORS_KEY_FILE> --env PRIORS_AGENT_ID=<PRIORS_AGENT_ID> --env PRIORS_MAX_PRICE_USD=<PRIORS_MAX_PRICE_USD> --env PRIORS_MAX_SPEND_USD=<PRIORS_MAX_SPEND_USD> -- npx -y @priors/mcpReplace <…> with your own values. 4 more environment variables are in the server README
Config file
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@priors/mcp"
],
"env": {
"PRIORS_KEY": "<PRIORS_KEY>",
"PRIORS_KEY_FILE": "<PRIORS_KEY_FILE>",
"PRIORS_AGENT_ID": "<PRIORS_AGENT_ID>",
"PRIORS_MAX_PRICE_USD": "<PRIORS_MAX_PRICE_USD>",
"PRIORS_MAX_SPEND_USD": "<PRIORS_MAX_SPEND_USD>"
}
}
}
}Replace <…> with your own values. 4 more environment variables are in the server README
Config file
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@priors/mcp"
],
"env": {
"PRIORS_KEY": "<PRIORS_KEY>",
"PRIORS_KEY_FILE": "<PRIORS_KEY_FILE>",
"PRIORS_AGENT_ID": "<PRIORS_AGENT_ID>",
"PRIORS_MAX_PRICE_USD": "<PRIORS_MAX_PRICE_USD>",
"PRIORS_MAX_SPEND_USD": "<PRIORS_MAX_SPEND_USD>"
}
}
}
}Replace <…> with your own values. 4 more environment variables are in the server README
Platform CLI
gemini mcp add -e PRIORS_KEY=<PRIORS_KEY> -e PRIORS_KEY_FILE=<PRIORS_KEY_FILE> -e PRIORS_AGENT_ID=<PRIORS_AGENT_ID> -e PRIORS_MAX_PRICE_USD=<PRIORS_MAX_PRICE_USD> -e PRIORS_MAX_SPEND_USD=<PRIORS_MAX_SPEND_USD> mcp npx -y @priors/mcpReplace <…> with your own values. 4 more environment variables are in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Priors
How to install Priors in Claude Code?
Run the registration command: claude mcp add priors -e PRIORS_KEY=<PRIORS_KEY> -- npx -y @priors/mcp.
What does Priors do?
It lets AI assistants operate a USDG wallet on Robinhood Chain to pay for x402 endpoints, access credit lines, and store idle balances.
What is required to sign transactions?
Write operations require a private key configured in PRIORS_KEY and sufficient ETH in the wallet to pay blockchain gas fees.
