
solmachina-x402
Solana & Base DeFi intelligence for AI agents over x402: decisions, risk, signed receipts.
What it can do
What data it sees
Do you need an account
No: the server works without sign-in
Solana & Base DeFi intelligence for AI agents over x402: decisions, risk, signed receipts.
How to connect
How to connect solmachina-x402 to Claude
The server address to paste into Claude settings:
https://api.solmachina.com/mcp
- Open Claude (claude.ai or the desktop app).
- Go to Settings → Connectors.
- Click Add custom connector.
- Paste the server address copied below into Remote MCP server URL and click Add.
- In a chat, click + → Connectors and switch the new connector on.
Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.
Authorization
After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.
How to connect solmachina-x402 to ChatGPT
The server address to paste into ChatGPT settings:
https://api.solmachina.com/mcp
- Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
- Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
- Open Settings → Connectors and click Create.
- Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
- Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
- In a new chat open + → Apps/Connectors and enable the connector.
OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.
Authorization
On first use ChatGPT opens the service's sign-in window. Sign in and approve access.
How to connect solmachina-x402 to Cursor
The server address to paste into Cursor settings:
https://api.solmachina.com/mcp
Fastest: click Open in Cursor below and confirm the prompt.
Manually:
- In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
- Paste the JSON copied below into
~/.cursor/mcp.json(per project:.cursor/mcp.jsonin the repo root). - Save the file. The server appears in the MCP list; authorize it there if asked.
Authorization
If the service needs sign-in, an authorize button appears next to the server in the MCP list.
Server tool list (25)
Raw names from tools/list. Only developers need these.
| solmachina_catalog | Discover the x402 catalog (endpoints, USDC prices, category, network, payTo). FREE. |
| solmachina_sample | FREE preview of any endpoint: response shape/example, inputs and price — inspect before paying. |
| solmachina_how_to_pay | Explain the x402 402->sign->retry flow so an agent can pay a paid endpoint with its own wallet. FREE. |
| solmachina_verify_receipt | How to verify a paid answer's Ed25519 SIR receipt OFFLINE (proof of what you paid for). FREE. |
| solmachina_status | Trust/health snapshot: version, uptime, WAL entry count + SHA-256 chain head. FREE. |
| solmachina_smri | SolMachina Machine Risk Index (SMRI) for an SPL token: a 0-100 risk index (higher = lower assessed risk) with transparent components (contract authorities, top-10 concentration), a risk band, and confidence (= data completeness). The cheap, high-frequency score behind /v1/decision — for agents that just want the number. Verdict-free, returns 'unknown' over guessing. NOT financial advice. Requires ?mint=<token mint address>. |
| solmachina_simulate | Pre-flight transaction simulation for agents: dry-run a serialized Solana transaction (simulateTransaction) BEFORE executing — will it succeed, compute units consumed, program logs, and the error if any. NEVER signs or sends; simulation only, NOT a guarantee of the real on-chain outcome. NOT financial advice. Requires ?tx=<base64 serialized transaction>. |
| solmachina_decision | SolMachina Decision — the decision layer for autonomous agents: composes on-chain risk signals into ONE answer — EXECUTE / REVIEW / REJECT + SMRI (SolMachina Machine Risk Index 0-100) + confidence + full evidence. A transparent RISK GATE against stated thresholds — NOT financial advice, NOT a profit prediction; returns REVIEW/unknown instead of guessing. Requires ?mint=<token mint address>; optional ?action=, ?amountUsd=, and a named firewall ?policy= (conservative|bluechip|anti-rug|degen). |
| solmachina_token_holders | Solana SPL token holder distribution / whale map: the largest token accounts (up to 20) each with its share of supply, plus top-1/5/10/20 concentration and simple buckets. More detailed than /v1/token-risk's single top-10 signal. Owners are NOT resolved and an account is not necessarily a distinct wallet; concentration is a structural signal, NOT a verdict. NOT financial advice. Requires ?mint=<token mint address>. |
| solmachina_slippage_map | Solana swap slippage / price-impact curve by trade SIZE: quotes the same pair at decade multiples of your base amount (via the Jupiter aggregator) and returns the impact per size plus a factual depth summary (largest tested size that stays under 1% / 5% impact). Execution intelligence beyond a single /v1/dex-quote. A quote, NOT an execution guarantee. NOT financial advice. Requires ?inputMint=&outputMint=&amount= (input base units). |
| solmachina_tipfloor | Jito bundle tip-floor snapshot + rolling history (p50/p95/p99/EMA). Optional ?fresh=true bypasses the ~60s cache for a live snapshot. |
| solmachina_epoch | Live epoch info + ETA to epoch end (dual measured slot-rates labeled). Optional ?rate= selects which measured rate drives the ETA. |
| solmachina_kamino_markets | Kamino mainnet market list (trimmed JSON). Optional ?limit caps how many markets are returned. |
| solmachina_sgp_checkpoint | SolMachina's own Solana epoch-transition checkpoint series: the live epoch/slot reading (getEpochInfo via multi-RPC) measured against our accumulating on-disk series to yield a MEASURED slot-rate + ETA (not a model) and last epoch-transition detection. Optional ?n sets how many recent series points to return. |
| solmachina_token_risk | Heuristic Solana SPL token risk/signal scan: mint + freeze authority, Token-2022 dangerous extensions, top-10 holder concentration, plus best-effort holder-count/age context. Transparent methodology, conservative (reports 'unknown' over guessing). NOT financial advice. Requires ?mint=<token mint address>. |
| solmachina_wallet_scan | Solana wallet activity profile: age, transaction activity, SOL balance, SPL token holdings, and a factual footprint band (fresh/active/heavy/empty). Transparent, conservative ('unknown' over guessing), never a trust/scam judgement. NOT financial advice. Requires ?address=<wallet address>. |
| solmachina_token_intel | One-call Solana token intelligence bundle: the full token-risk analysis PLUS a decision-ready executive digest and factual top-holder classification (burn/system labels; unknowns left unresolved with owner exposed). Verdict-free, transparent, conservative ('unknown' over guessing). NOT financial advice. Requires ?mint=<token mint address>. |
| solmachina_batch_token_risk | Batch heuristic risk scan for up to 10 SPL token mints in ONE call (mint + freeze authority, Token-2022 dangerous extensions, top-10 holder concentration per token). A portfolio/watchlist bundle over the token-risk engine; each mint returns its own result or an explicit error. Transparent, conservative ('unknown' over guessing). NOT financial advice. Requires ?mints=<comma-separated mint addresses>. |
| solmachina_priority_fee | Solana priority-fee intelligence: the observed distribution (percentiles + suggested economy/normal/fast/aggressive bands) of prioritization fees actually paid in recent slots, in micro-lamports per compute unit. Optional ?accounts= narrows to txs write-locking specific markets. Observed history, NOT a prediction or inclusion guarantee. |
| solmachina_dex_quote | Live aggregated Solana swap quote from the Jupiter aggregator: best-route output, price impact with stated thresholds (minimal/low/moderate/high), min-received after slippage, transparent route path, USD value and a freshness slot. A quote, NOT an execution guarantee (impact/liquidity move block to block). NOT financial advice. Requires ?inputMint=&outputMint=&amount= (amount in the input token's base units). |
| solmachina_trending_tokens | Observed trending Solana tokens/pools (GeckoTerminal ranking of recent volume + activity): name, base mint, price + 1h/6h/24h change, 24h volume, liquidity, FDV, market cap, tx counts and pool age. Market-activity facts, NOT a recommendation, prediction or 'pump' signal — high volume does not imply safety. NOT financial advice. Optional ?limit (1-20, default 15). |
| solmachina_new_pairs | Newest Solana liquidity pools (GeckoTerminal): name, base mint, creation time, age in minutes, liquidity, 24h volume and price change. New pools are UNVETTED and structurally high-risk — pair each mint with /v1/token-risk before acting. Factual observation only, NOT a recommendation. NOT financial advice. Optional ?limit (1-20, default 15). |
| solmachina_nft_collection | Solana NFT collection snapshot from Magic Eden: floor price (SOL + lamports), listed count, 24h average price and 7-day volume. The floor is the lowest CURRENT ask (not a guaranteed sale price) and moves continuously. Factual snapshot, NOT a recommendation. NOT financial advice. Requires ?symbol=<Magic Eden collection symbol>. |
| solmachina_tx_inspect | Decode a Solana transaction into a structured summary: success/fee/compute-units, the programs it invoked (named for well-known ones), SOL balance deltas and SPL token balance deltas. Reports on-chain effects only, never intent. Requires ?sig=<transaction signature>. |
| solmachina_pretrade | One-call PRE-TRADE SWEEP for a token: the full token-intel bundle (risk + executive digest + factual holder classification) PLUS a wallet-activity profile of the largest remaining holder PLUS observed priority-fee landing bands, distilled into a factual, threshold-stated checklist. Verdict-free (never 'buy'/'avoid'); partial sub-analyses are explicit errors, never silence. NOT financial advice. Requires ?mint=<token mint address>. |