io.github.Timwal78/mcp-x402

Official51 tools

by Timwal78 · HTML

mcp-x402 — The x402 Amazon for AI Agents

56 pay-per-call MCP tools: federal grants/contracts, market intel, SEC, FTD. x402 USDC. No keys.

Pay-per-call tools for market intelligence, SEC data, XRPL payments, and copy-trading.

Topics

ai-agentsmcpx402xrplfintechtrading

Captured live from the server via tools/list.

sml_discover

Returns the complete ScriptMasterLabs product catalog — all 43 tools, prices, and payment instructions. Call this first. FREE.

No parameters.

sml_status

Real-time health check of all 8 SML backends simultaneously. Call before making paid requests to avoid wasted payments. FREE.

No parameters.

agentcard_lookup

Parameters (1)

identifierstringrequired
Agent wallet address or DID to look up.

agentcard_verify

Parameters (3)

wallet_addressstringrequired
Agent wallet address that signed the message.
messagestringrequired
Original message that was signed.
signaturestringrequired
Ed25519 signature (hex or base64).

agentcard_mint

Parameters (5)

wallet_addressstringrequired
XRPL wallet address for the new agent identity.
namestringrequired
Human-readable agent name (max 64 chars).
didstringrequired
Optional DID (decentralized identifier) for the agent.
metadataobjectrequired
Optional metadata object (capabilities, version, etc.).
payment_walletstringrequired
Wallet to pay x402 fee from (defaults to wallet_address).

backtest_run

Parameters (7)

tickerstringrequired
Ticker symbol (e.g. NVDA, SPY, GME)
lookback_daysnumberrequired
Days of history to backtest (30–1260, default 252)
feesnumberrequired
Round-trip commission rate (default 0.001 = 0.1%)
slippagenumberrequired
Slippage per side (default 0.0005)
momentum_windownumberrequired
Momentum rolling window in days (default 10)
momentum_thresholdnumberrequired
Minimum momentum to enter long (default 0.001)
wallet_addressstringrequired
Agent wallet address (optional)

backtest_validate

Parameters (6)

tickerstringrequired
Ticker symbol to validate
lookback_daysnumberrequired
Total history window (60–1260, default 504 = 2 years)
train_rationumberrequired
Train/test split ratio (default 0.7 = 70% in-sample)
feesnumberrequired
Round-trip commission rate (default 0.001)
slippagenumberrequired
Slippage per side (default 0.0005)
wallet_addressstringrequired
Agent wallet for x402 payment (AP2 required)

tradier_quote

Parameters (1)

symbolsstringrequired
Comma-separated ticker symbols (e.g. "NVDA,SPY,AAPL")

tradier_order

Parameters (9)

account_idstringrequired
Tradier brokerage account ID
symbolstringrequired
Ticker symbol (e.g. NVDA)
sidestringrequired
"buy" or "sell"
quantitynumberrequired
Number of shares (integer)
typestringrequired
"market" | "limit" | "stop" | "stop_limit"
durationstringrequired
"day" | "gtc" | "pre" | "post"
pricenumberrequired
Limit price (required for limit/stop_limit orders)
stopnumberrequired
Stop price (required for stop/stop_limit orders)
wallet_addressstringrequired
Agent wallet for x402 payment (AP2 required)

tradier_positions

Parameters (1)

account_idstringrequired
Tradier brokerage account ID

robinhood_quote

Parameters (1)

symbolstringrequired
Ticker symbol (e.g. NVDA)

robinhood_order

Parameters (7)

symbolstringrequired
Ticker symbol (e.g. NVDA)
sidestringrequired
"buy" or "sell"
quantitynumberrequired
Number of shares (integer)
typestringrequired
"market" or "limit"
time_in_forcestringrequired
"gfd" (good for day) | "gtc" | "ioc" | "opg"
pricenumberrequired
Limit price (required for limit orders)
wallet_addressstringrequired
Agent wallet for x402 payment (AP2 required)

robinhood_portfolio

No parameters.

copytrader_status

No parameters.

copytrader_whales

No parameters.

copytrader_subscribe

Parameters (4)

whale_addressstringrequired
XRPL address of the whale to copy.
subscriber_addressstringrequired
Your XRPL address that will mirror trades.
max_copy_amount_xrpnumberrequired
Maximum XRP to allocate per copied trade.
wallet_addressstringrequired
Agent wallet for x402 payment.

crawl_paid_fetch

Parameters (4)

urlstringrequired
URL to fetch and parse. Must be http or https.
extractstringrequired
What to extract. Default: text.
wallet_addressstringrequired
Agent wallet for payment. Humans bypass automatically.
user_agentstringrequired
Custom user-agent string.

echo_pattern_match

Parameters (4)

symbolstringrequired
Ticker symbol to find historical analogs for (e.g. TSLA, GME).
lookback_daysnumberrequired
Days of price history to encode as the query pattern (1-3650).
top_nnumberrequired
Number of closest historical matches to return (1-20, default 5).
wallet_addressstringrequired
Agent wallet for x402 payment.

forge_status

No parameters.

forge_llm

Parameters (4)

modelstringrequired
Model identifier (e.g. "claude-3-5-haiku-20241022", "gpt-4o-mini").
promptstringrequired
Prompt to send to the LLM (max 32768 chars).
max_tokensnumberrequired
Maximum tokens in the response (default: model max). Max: 8192.
wallet_addressstringrequired
Agent wallet for x402 pay-per-token billing.

ftd_threshold_scan

Parameters (4)

scan_typestringrequired
"alerts" is free. "full" and "spike_history" require 0.05 USDC.
tickerstringrequired
Filter by ticker. Optional.
min_spike_multipliernumberrequired
Minimum FTD spike multiplier vs baseline. Default: 2x.
wallet_addressstringrequired
Agent wallet for paid scans.

ghost_status

No parameters.

ghost_route

Parameters (6)

from_chainstringrequired
Source chain.
to_chainstringrequired
Destination chain.
amountstringrequired
Amount to route (as string to preserve precision).
currencystringrequired
Token/currency symbol (e.g. RLUSD, XRP, ETH).
destination_addressstringrequired
Recipient address on the destination chain.
wallet_addressstringrequired
Agent wallet for x402 payment.

launchpad_status

No parameters.

launchpad_list

No parameters.

launchpad_create

Parameters (7)

namestringrequired
Token name (e.g. "Moon Rocket").
symbolstringrequired
Ticker symbol (e.g. MNRKT, max 10 chars).
descriptionstringrequired
Token description (max 512 chars).
creator_addressstringrequired
XRPL address of the token creator.
initial_supplynumberrequired
Total token supply (integer).
target_liquidity_xrpnumberrequired
XRP target to graduate from bonding curve to DEX.
wallet_addressstringrequired
Agent wallet for x402 payment.

launchpad_buy

Parameters (4)

token_addressstringrequired
Token contract/address on XRPL.
buyer_addressstringrequired
XRPL address of the buyer.
xrp_amountnumberrequired
Amount of XRP to spend on the bonding curve.
wallet_addressstringrequired
Agent wallet for x402 payment.

leviathan_signal

Parameters (4)

tickerstringrequired
Ticker symbol (e.g. TSLA, MSTR). Optional — omit for top signals.
signal_typestringrequired
Signal category.
min_confidencenumberrequired
Minimum confidence score 0-100. Default: 60.
wallet_addressstringrequired
Agent wallet address for payment. Auto-provisioned if omitted.

nexus_agent_hire

Parameters (6)

capabilitystringrequired
Capability or skill to search for (e.g. "options flow analysis").
max_budgetstringrequired
Max budget in USDC for hire (e.g. "1.00").
chain_preferencestringrequired
Preferred payment chain.
actionstringrequired
"query" is free. "hire" charges 5% commission on agent fee.
agent_idstringrequired
Agent ID to hire (required for action=hire).
wallet_addressstringrequired
Agent wallet for payment.

proof_invoice

Parameters (1)

endpoint_idstringrequired
UUID of the premium endpoint to get a payment invoice for.

proof_verify

Parameters (2)

tx_hashstringrequired
XRPL transaction hash to verify.
endpoint_idstringrequired
UUID of the endpoint the payment was for.

proof_credit_score

Parameters (1)

wallet_addressstringrequired
Agent wallet address to look up credit score for (300-850 scale).

rails_status

No parameters.

rails_transfer

Parameters (6)

from_addressstringrequired
Sender XRPL address.
to_addressstringrequired
Recipient XRPL or Xahau address.
amountstringrequired
Amount to transfer (as string to preserve precision).
currencystringrequired
Token to transfer.
memostringrequired
Optional transfer memo (max 256 chars).
wallet_addressstringrequired
Agent wallet for x402 payment.

shadow_query

Parameters (3)

querystringrequired
Natural language query for signal intelligence (max 2048 chars).
contextstringrequired
Optional context to refine the query (max 1024 chars).
wallet_addressstringrequired
Agent wallet for x402 payment.

shadow_ingest

Parameters (3)

sourcestringrequired
Source identifier for the data being ingested (e.g. "discord", "twitter", "on-chain").
payloadobjectrequired
Signal data payload as a JSON object.
wallet_addressstringrequired
Agent wallet for x402 payment.

squeezeos_preview

Parameters (1)

symbolstringrequired
Ticker symbol (e.g. TSLA, IWM, MSTR).

squeezeos_history

Parameters (1)

symbolstringrequired
Ticker symbol. Omit to get all recent signals.

squeezeos_oracle

Parameters (1)

symbolstringrequired
Ticker symbol. Omit for full oracle batch.

squeezeos_ftd

No parameters.

squeezeos_status

No parameters.

squeezeos_demo

No parameters.

squeezeos_marketplace_browse

No parameters.

squeezeos_futures_leaderboard

No parameters.

squeezeos_council

Parameters (2)

symbolstringrequired
Ticker symbol to analyze (e.g. TSLA, GME, IWM).
wallet_addressstringrequired
Agent wallet address for x402 payment.

squeezeos_scan

Parameters (1)

wallet_addressstringrequired
Agent wallet address for x402 payment.

squeezeos_options

Parameters (1)

wallet_addressstringrequired
Agent wallet address for x402 payment.

squeezeos_iwm

Parameters (1)

wallet_addressstringrequired
Agent wallet address for x402 payment.

squeezeos_marketplace_read

Parameters (2)

listing_idstringrequired
Listing ID from squeezeos_marketplace_browse.
wallet_addressstringrequired
Agent wallet address for x402 payment.

xdeo_earnings_estimate

Parameters (4)

tickerstringrequired
Ticker symbol (e.g. NVDA).
fiscal_quarterstringrequired
Quarter in format Q1YYYY (e.g. Q12025).
estimate_typestringrequired
What estimate to fetch.
wallet_addressstringrequired
Agent wallet for payment.

xmit_edgar_decode

Parameters (4)

filing_urlstringrequired
SEC EDGAR filing URL (DEF 14A, 13F, or 13D).
parse_targetstringrequired
What to extract.
formatstringrequired
Output format. Default: json.
wallet_addressstringrequired
Agent wallet for payment.

README.md1 KBView on GitHub

SML Portfolio

ScriptMasterLabs' monorepo — product code, MCP servers, and the scriptmasterlabs.com marketing site.

MCP Server

mcp-x402/ — the first MCP server that pays for itself. AI agents pay for ScriptMasterLabs data autonomously via the x402 protocol: 40+ pay-per-call tools covering market intelligence, SEC filings, federal grants/contracts, FDA/OSHA/EPA records, and more, settled in USDC on Base or RLUSD on the XRP Ledger. No API keys, no subscriptions — see mcp-x402/README.md for setup and the full tool list.

License

MIT — see mcp-x402/LICENSE for the MCP server package.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "mcp-x402": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp-x402.onrender.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.