Finds cheaper USDC bridge routes across different blockchains for AI agents to minimize transaction costs.
Also known as RectaBuild/recta, @recta/mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.3.4
- Last commit
- Nov 13, 2026
- License
- —
What is Recta MCP?
Recta finds cheaper USDC bridge routes across different blockchains for AI agents to minimize transaction costs.
Summary generated from the project's README
About Recta MCP server
Recta provides a preflight mechanism for AI agents that need to move USDC between different blockchains. It functions by checking if a cheaper bridge route exists at the current chain state before a transfer is initiated. This service is free if no savings are found, but it charges exactly 5% of any verified on-chain savings. The agent retains at least 95% of the money saved through these optimized routes.
Developers can run this as a local MCP server using the @recta/mcp package, which works with clients like Claude or Cursor. Because it is a local server, the agent's private keys remain on the machine and are never shared with the service. The server uses streamable HTTP and does not require an API key for operation. It also provides specialized integration as a Coinbase AgentKit action provider and a GOAT plugin to assist with transaction evaluation and execution.
What you can do with it
- 1Minimize stablecoin bridge costsAn AI agent can check for cheaper USDC transfer routes before committing to a blockchain bridge transaction.
- 2Secure transaction executionDevelopers can ensure that their AI agents sign and send every transaction themselves without sharing private keys.
- 3Verify network coverageAn agent can perform an unsigned check to see if a specific source and destination network pair is supported.
Written from the project's README. Every use case is checked against a quote from it.
How to install Recta MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Recta MCP in Claude Code
$ claude mcp add --env 'RECTA_PRIVATE_KEY=<YOUR_RECTA_PRIVATE_KEY>' recta -- npx -y @recta/mcpInstall Recta MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"recta": {
"command": "npx",
"args": [
"-y",
"@recta/mcp"
],
"env": {
"RECTA_PRIVATE_KEY": "<YOUR_RECTA_PRIVATE_KEY>"
}
}
}
}Install Recta MCP in VS Code
.vscode/mcp.json
{
"servers": {
"recta": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@recta/mcp"
],
"env": {
"RECTA_PRIVATE_KEY": "<YOUR_RECTA_PRIVATE_KEY>"
}
}
}
}Install Recta MCP in VS Code CLI
$ code --add-mcp '{"name":"recta","type":"stdio","command":"npx","args":["-y","@recta/mcp"],"env":{"RECTA_PRIVATE_KEY":"<YOUR_RECTA_PRIVATE_KEY>"}}'Install Recta MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"recta": {
"command": "npx",
"args": [
"-y",
"@recta/mcp"
],
"env": {
"RECTA_PRIVATE_KEY": "<YOUR_RECTA_PRIVATE_KEY>"
}
}
}
}Install Recta MCP in Codex
$ codex mcp add recta --env 'RECTA_PRIVATE_KEY=<YOUR_RECTA_PRIVATE_KEY>' -- npx -y @recta/mcpInstall Recta MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.recta] command = "npx" args = ["-y", "@recta/mcp"] [mcp_servers.recta.env] RECTA_PRIVATE_KEY = "<YOUR_RECTA_PRIVATE_KEY>"
Install Recta MCP in Gemini CLI
$ gemini mcp add -s user -e 'RECTA_PRIVATE_KEY=<YOUR_RECTA_PRIVATE_KEY>' recta npx -- -y @recta/mcpInstall Recta MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"recta": {
"command": "npx",
"args": [
"-y",
"@recta/mcp"
],
"env": {
"RECTA_PRIVATE_KEY": "<YOUR_RECTA_PRIVATE_KEY>"
}
}
}
}Configuration
RECTA_PRIVATE_KEYSecretThe agent wallet's private key (EOA), used only locally to sign and never sent to Recta. Optional: without it the server offers only the free tools recta_fit and recta_trial_evaluation.
RECTA_ADDRESSWithout a key: the public address the free trial uses as sender (never a key).
RECTA_ALLOWED_RECIPIENTSAddresses, separated by commas, that may receive a transfer besides the wallet itself. Any other recipient is refused before anything is signed.
RECTA_ALLOW_EXECUTESet to yes to let the agent sign fee permits and send transactions. Anything else keeps the server read and preview only.
RECTA_MAX_AMOUNTThe most one transfer may move, in whole tokens of the source asset (1000 with USDC means 1000 USDC). A larger amount is refused before anything is signed.
RECTA_MAX_FEE_USDCThe most one fee permit may authorize, in USDC.
RECTA_MIN_OUTPUT_BPSThe route must guarantee the recipient at least this share of the amount sent, in basis points.
| Name | Description | |
|---|---|---|
| RECTA_PRIVATE_KEY | The agent wallet's private key (EOA), used only locally to sign and never sent to Recta. Optional: without it the server offers only the free tools recta_fit and recta_trial_evaluation. | Secret |
| RECTA_ADDRESS | Without a key: the public address the free trial uses as sender (never a key). | |
| RECTA_ALLOWED_RECIPIENTS | Addresses, separated by commas, that may receive a transfer besides the wallet itself. Any other recipient is refused before anything is signed. | |
| RECTA_ALLOW_EXECUTE | Set to yes to let the agent sign fee permits and send transactions. Anything else keeps the server read and preview only. | |
| RECTA_MAX_AMOUNT | The most one transfer may move, in whole tokens of the source asset (1000 with USDC means 1000 USDC). A larger amount is refused before anything is signed. | |
| RECTA_MAX_FEE_USDC | The most one fee permit may authorize, in USDC. | |
| RECTA_MIN_OUTPUT_BPS | The route must guarantee the recipient at least this share of the amount sent, in basis points. |
Automated checks
Ran Nov 15, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachablerectabuild/recta is public and reachablegithub.com/rectabuild/recta ↗Pass
- Package names this repository as its source@recta/mcp names rectabuild/recta as sourcenpmjs.com/package/@recta/mcp ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for @recta/mcpnpmjs.com/package/@recta/mcp/v/0.1.14#provenance ↗Pass
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-13github.com/rectabuild/recta ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @recta/mcpPass
- No critical advisory in the package or its dependenciesthe package checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 136 msPass
README
View on GitHubRecta
Preflight for AI agents that move stablecoins between blockchains: before a bridge transfer, ask Recta whether a cheaper route exists at the same chain state. Free when there is none; otherwise exactly 5 % of the saving verified on chain. The agent keeps at least 95 % of every verified saving.
- Docs for agents: https://api.recta.build/llms.txt
- MCP server (Streamable HTTP, no API key): https://api.recta.build/mcp
- OpenAPI: https://api.recta.build/openapi.json
- Wallet allowlist for agent wallets: https://api.recta.build/v1/golden-corridor/wallet-policy
- Coverage check (unsigned, free): https://api.recta.build/v1/golden-corridor/fit?source_network=ethereum&source_asset=USDC&destination_network=arbitrum&destination_asset=USDC
Recta never holds keys or funds: your agent signs and sends every transaction itself.
Client package
packages/client is @recta/client: evaluate, authorize the fee, execute and report from your
agent's own wallet, with local checks before every signature. Published to npm from this repository with provenance.
Local MCP server
packages/mcp is @recta/mcp: a local MCP server over the client, so Claude, Cursor or any MCP agent
runs the same flow with its own key, which stays on the machine. Execution is off until the operator turns it on.
The evaluation tools also come as a Coinbase AgentKit action provider (@recta/mcp/agentkit) and a GOAT plugin
(@recta/mcp/goat).
What is in this repository
The tools an agent uses to call Recta: the Agent Skill, the AGENTS.md snippet and, as they are published, the client
and local MCP packages. The server behind api.recta.build is not published here; its MCP endpoint above is the one
listed in the official MCP Registry as io.github.RectaBuild/recta.
Recta MCP questions
How do I add Recta MCP to Claude Code?
Run claude mcp add --env 'RECTA_PRIVATE_KEY=<YOUR_RECTA_PRIVATE_KEY>' recta -- npx -y @recta/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Recta MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How much does Recta charge?
The service is free if no cheaper route is found; otherwise, it charges exactly 5% of the verified savings.
Does Recta hold my private keys or funds?
No, Recta does not hold any keys or funds; the agent is responsible for signing and sending every transaction.
How does the MCP server handle authentication?
The MCP server uses Streamable HTTP and does not require an API key.