io.github.imnotamob/solmachina-x402

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Solana & Base DeFi intelligence for AI agents over x402: decisions, risk, signed receipts.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "solmachina-x402": {
      "url": "https://api.solmachina.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (25)

• solmachina_catalog

  Discover the x402 catalog (endpoints, USDC prices, category, network, payTo). FREE.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• solmachina_sample

  FREE preview of any endpoint: response shape/example, inputs and price — inspect before paying.

  Parameters:

  • endpoint (required) — string — e.g. /v1/token-holders

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• solmachina_how_to_pay

  Explain the x402 402->sign->retry flow so an agent can pay a paid endpoint with its own wallet. FREE.

  Parameters:

  • endpoint — string — optional endpoint path, e.g. /v1/decision

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• solmachina_verify_receipt

  How to verify a paid answer's Ed25519 SIR receipt OFFLINE (proof of what you paid for). FREE.

  Parameters:

  • receipt — string — base64 X-SolMachina-Receipt value or the receipt JSON

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• solmachina_status

  Trust/health snapshot: version, uptime, WAL entry count + SHA-256 chain head. FREE.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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>.

  Parameters:

  • mint (required) — string — Base58 SPL token mint to score, e.g. DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 (BONK).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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>.

  Parameters:

  • tx (required) — string — Base64-encoded serialized Solana transaction to dry-run.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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).

  Parameters:

  • mint (required) — string — Base58 SPL token mint to assess, e.g. DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 (BONK).
  • tx — string — Optional base64 serialized transaction to BIND the signed authorization to: the response's authorization.subject.boundTxSha256 = sha256(tx), so your executor honors it only for that exact transaction (Proof-of-Decision per-tx). Also decoded OFFLINE to cross-check that the tx actually references the guarded mint — authorization.subject.txReferencesGuardedMint = true | false | "unknown".
  • action — string — Single nonblank context string; default assess. Does not execute an action.
  • policy — string — Named firewall preset: conservative | bluechip | anti-rug | degen — expands to a full ALLOW/DENY policy (the individual params above override preset values). The response echoes policyTemplate.
  • minSmri — number — Agent Financial Firewall — your policy: require SMRI >= this (0-100). Adds policy.verdict = ALLOW/DENY (fail-closed).
  • amountUsd — string — Single finite non-negative decimal USD amount, context only; does not change the score. No exponent notation or repeated values.
  • minConfidence — number — Firewall: DENY if data confidence is below this (0-1).
  • denyHighRiskBand — boolean — Firewall: DENY if the token-risk band is 'high'.
  • denyMintAuthority — boolean — Firewall: DENY if the mint authority is still set.
  • denyTxMintMismatch — boolean — Firewall (needs ?tx=): DENY on a CONFIRMED mismatch — the bound transaction provably does not reference the guarded mint. A tx that uses address-lookup-tables, or no tx at all, is not evaluable, so the rule passes (never a fabricated mismatch).
  • denyFreezeAuthority — boolean — Firewall: DENY if the freeze authority is still set.
  • maxConcentrationPct — number — Firewall: DENY if top-10 holder concentration exceeds this %.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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>.

  Parameters:

  • mint (required) — string — Base58 SPL token mint address, e.g. DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 (BONK). Major stablecoins like USDC have too many accounts to snapshot.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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).

  Parameters:

  • inputMint (required) — string — Base58 mint you are selling, e.g. So11111111111111111111111111111111111111112 (SOL).
  • outputMint (required) — string — Base58 mint you are buying, e.g. EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v (USDC).
  • amount (required) — string — Base units of inputMint for the 1x reference size (lamports for SOL, 1e6 per USDC).
  • mults — string — Optional comma-separated size multipliers of the base amount (default 0.1,1,10,100; up to 8).
  • slippageBps — integer — Slippage tolerance in basis points for min-received, 0-5000 (default 50).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• solmachina_tipfloor

  Jito bundle tip-floor snapshot + rolling history (p50/p95/p99/EMA). Optional ?fresh=true bypasses the ~60s cache for a live snapshot.

  Parameters:

  • fresh — boolean — If 'true', bypass the ~60s cache and fetch a live tip-floor snapshot (otherwise a cached snapshot is served).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• solmachina_epoch

  Live epoch info + ETA to epoch end (dual measured slot-rates labeled). Optional ?rate= selects which measured rate drives the ETA.

  Parameters:

  • rate — string — Which measured slot-rate to use for the ETA: 'primary', 'alt', or 'both' (default).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• solmachina_kamino_markets

  Kamino mainnet market list (trimmed JSON). Optional ?limit caps how many markets are returned.

  Parameters:

  • limit — integer — Max markets to return, 1-100 (default 100).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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.

  Parameters:

  • n — integer — How many most-recent series points to include in `series.recent`, 1-200 (default 20).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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>.

  Parameters:

  • mint (required) — string — Base58 SPL token mint address to scan, e.g. EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v (USDC).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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>.

  Parameters:

  • address (required) — string — Base58 Solana wallet address to profile.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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>.

  Parameters:

  • mint (required) — string — Base58 SPL token mint address to profile, e.g. DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 (BONK).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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>.

  Parameters:

  • mints (required) — string — Comma-separated base58 SPL mint addresses, up to 10 (duplicates removed), e.g. mintA,mintB,mintC.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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.

  Parameters:

  • accounts — string — Optional comma-separated base58 addresses to narrow the fee sample to transactions that write-locked them (e.g. a hot AMM pool).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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).

  Parameters:

  • inputMint (required) — string — Base58 mint you are selling, e.g. So11111111111111111111111111111111111111112 (SOL).
  • outputMint (required) — string — Base58 mint you are buying, e.g. EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v (USDC).
  • amount (required) — string — Amount of inputMint in its base units (lamports for SOL, 1e6 per USDC).
  • slippageBps — integer — Slippage tolerance in basis points for min-received, 0-5000 (default 50 = 0.5%).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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).

  Parameters:

  • limit — integer — How many trending pools to return, 1-20 (default 15).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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).

  Parameters:

  • limit — integer — How many new pools to return, 1-20 (default 15).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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>.

  Parameters:

  • symbol (required) — string — Magic Eden collection symbol, e.g. mad_lads or okay_bears.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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>.

  Parameters:

  • sig (required) — string — Base58 Solana transaction signature to decode.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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>.

  Parameters:

  • mint (required) — string — Base58 SPL token mint address to sweep, e.g. DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 (BONK).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.