Solmachina X402

io.github.imnotamobPublished by GitHub account imnotamobv1.4.0Updated Oct 27, 2026

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

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Solana and Base DeFi intelligence for AI agents: token risk, pre-trade checks, quotes and signed receipts, paid per call over x402.

What you can do
  • Discover and preview the x402 catalog: list endpoints, USDC prices and networks, sample responses, and learn the pay flow
  • Check token and wallet risk: SMRI index, token risk scans, batch scans, holder distribution, wallet activity and one-call token intel
  • Run pre-trade checks: decision gate, pre-trade sweep, transaction simulation, transaction decoding and slippage curves
  • Get market data: Jupiter swap quotes, trending tokens, new pools, NFT collection snapshots, Kamino markets
  • Read Solana network state: priority-fee bands, Jito tip floor, epoch and slot-rate checkpoints, service status
  • Verify paid answers offline with Ed25519 receipts
When to use it
Useful when an agent needs Solana token or wallet risk signals, pre-trade checks, swap quotes or network fee data, and is set up to pay per call in USDC over x402. The free catalog, sample, status and receipt-verification tools are handy for inspecting the service before spending anything.
Requirements
Runs as a remote endpoint or as a local npm package over stdio. No authentication, environment variables or headers are declared. Paid endpoints require an x402-capable wallet holding USDC on the supported network; some tools need a token mint, wallet address, transaction signature or collection symbol.
Before you install
Most tools are paid per call in USDC, so an agent with a funded wallet can spend money autonomously; use the free catalog and sample tools first. Outputs are explicitly not financial advice or guarantees, and simulation or quotes may differ from real on-chain results. Requests go to a third-party API, and the service asks for wallet addresses, token mints and transaction signatures.

Installation

In SourceWeft

  1. Open Solmachina X402 in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.imnotamob%2Fsolmachina-x402/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

This repository has no README.

Tools

25

solmachina_catalog

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

Takes no parameters.

solmachina_sample

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

Parametersendpointrequired

solmachina_how_to_pay

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

Parametersendpoint

solmachina_verify_receipt

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

Parametersreceipt

solmachina_status

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

Takes no parameters.

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

Parametersmintrequired

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

Parameterstxrequired

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

ParameterstxmintrequiredactionpolicyminSmriamountUsdminConfidencedenyHighRiskBanddenyMintAuthoritydenyTxMintMismatchdenyFreezeAuthoritymaxConcentrationPct

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

Parametersmintrequired

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

ParametersmultsamountrequiredinputMintrequiredoutputMintrequiredslippageBps

solmachina_tipfloor

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

Parametersfresh

solmachina_epoch

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

Parametersrate

solmachina_kamino_markets

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

Parameterslimit

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.

Parametersn

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

Parametersmintrequired

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

Parametersaddressrequired

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

Parametersmintrequired

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

Parametersmintsrequired

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.

Parametersaccounts

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

ParametersamountrequiredinputMintrequiredoutputMintrequiredslippageBps

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

Parameterslimit

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

Parameterssymbolrequired

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

Parameterssigrequired

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

Parametersmintrequired

Version history

1
  1. v1.4.0LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.