SolMachina

Developer docs

Ask before your agent executes.

SolMachina is the trust & decision layer for Solana & Base agents over x402. One call returns a decision, a risk score and the evidence — with a signed receipt you can verify offline. Pay per call in USDC. No account, no API key.

EXECUTEREVIEWREJECT+ SMRI 0–100+ signed receipt

1Try it free in 10 seconds

No account, no payment — via any MCP client (npx -y solmachina-x402-mcp, call solmachina_sample) or raw over our remote MCP endpoint:

curl -s -X POST https://api.solmachina.com/mcp -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"solmachina_sample","arguments":{"endpoint":"/v1/decision"}}}'

2Make a real decision (paid, USDC over x402)

GET https://api.solmachina.com/v1/decision?mint=<MINT>
  → HTTP 402 (USDC terms) → pay with any x402 client → retry →
  { "decision":"EXECUTE|REVIEW|REJECT", "smri":0-100, "confidence":0-1, "reason":"…", "evidence":{…} }
  + header X-SolMachina-Receipt  (Ed25519, verify offline: npx solmachina-verify)

Agent Financial Firewall — send your policy and get policy.verdict = ALLOW/DENY (fail-closed). Use a named preset or individual rules:

GET /v1/decision?mint=<MINT>&policy=anti-rug        # conservative | bluechip | anti-rug | degen
GET /v1/decision?mint=<MINT>&minSmri=80&denyMintAuthority=true

3Add it to your agent (one tool)

Drop a decision gate into any framework — LangChain, Vercel AI SDK, CrewAI, or the SendAI Solana Agent Kit. Full copy-paste guide: SolMachina × Solana Agent Kit.

// system rule: "Before any swap/buy, call solmachina_decision(mint); proceed only on EXECUTE."

Connect the whole toolset remotely (25 tools): MCP https://api.solmachina.com/mcp · registry io.github.imnotamob/solmachina-x402 · npm solmachina-x402-mcp.

4Why SolMachina (not a raw data feed)

Decisions, not data

EXECUTE/REVIEW/REJECT + SMRI + evidence — the answer your agent actually needs.

Signed receipts

Every paid answer ships an Ed25519 receipt verifiable offline + a transparency log.

Policy firewall

Your ALLOW/DENY rules, fail-closed — named presets or your own thresholds.

Trust-first

Cites every source, says unknown over guessing. Verdict-free. Not financial advice.

EndpointWhat it answers
/v1/decisionExecute this or not? (flagship) + SMRI + firewall
/v1/pretradeOne-call pre-trade sweep: risk + holders + liquidity + fees
/v1/token-risk · /v1/token-holdersMint/freeze authority, Token-2022 flags, whale map
/v1/dex-quote · /v1/slippage-mapBest route, price impact, slippage-by-size
/v1/wallet-scanCounterparty wallet profile

Full catalog + prices: /pricing · machine catalog: /.well-known/x402 · schema: /openapi.json.

api.solmachina.comx402 v2 · Solana + Base · USDCno account · no API keysigned receipts (SIR)