Quickstart

Make a real call in under a minute. No account, no API key; every tool gives you 25 free calls a day.

1. Make your first call

Every tool is a POST to /api/tools/<name> with a JSON body. This one converts 5 USDC into the exact raw units a transfer needs:

Terminal

curl -X POST 'https://trade-desk-1021990235790.us-central1.run.app/api/tools/convert' \
  -H 'content-type: application/json' \
  -d '{"token":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","amount":"5"}'

The answer includes "raw_amount": "5000000" and the decimals it used, read from the chain.

2. Check a transaction before your agent signs it

Serialize the unsigned transaction to base64 and send it to check_tx. You get OK, REVIEW or BLOCK, every wallet's exact balance change, and the reasons.

TypeScript

const base64 = Buffer.from(tx.serialize({ requireAllSignatures: false })).toString("base64");
const res = await fetch("https://trade-desk-1021990235790.us-central1.run.app/api/tools/check_tx", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({ tx: base64 }),
});
const { verdict, summary, balance_changes } = await res.json();
if (verdict === "BLOCK") throw new Error(summary);

Try it live with a real transaction

3. Give the tools to your agent

Connect any MCP client (Claude, Cursor, your own agent) to /mcp and all tools appear automatically, each with a "use when" line so the model knows when to call it.

Connect an agent

4. Pay for heavy use

After a tool's 25 free calls for the day, it answers 402 Payment Required. An x402 client pays the few-cent USDC price from a Solana wallet and retries automatically.

Pricing and x402 setup