Developer docs
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.
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"}}}'
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
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.
EXECUTE/REVIEW/REJECT + SMRI + evidence — the answer your agent actually needs.
Every paid answer ships an Ed25519 receipt verifiable offline + a transparency log.
Your ALLOW/DENY rules, fail-closed — named presets or your own thresholds.
Cites every source, says unknown over guessing. Verdict-free. Not financial advice.
| Endpoint | What it answers |
|---|---|
/v1/decision | Execute this or not? (flagship) + SMRI + firewall |
/v1/pretrade | One-call pre-trade sweep: risk + holders + liquidity + fees |
/v1/token-risk · /v1/token-holders | Mint/freeze authority, Token-2022 flags, whale map |
/v1/dex-quote · /v1/slippage-map | Best route, price impact, slippage-by-size |
/v1/wallet-scan | Counterparty wallet profile |
Full catalog + prices: /pricing · machine catalog: /.well-known/x402 · schema: /openapi.json.