# mcp-x402 — MCP server for agents with autonomous USDC/RLUSD payments (remote · mcp-x402.onrender.com)

85+ pay-per-call MCP tools: trading, federal grants/contracts, SEC, FTD. x402 USDC/RLUSD. No keys.

- Trust score: 54/100 (low)
- Change this week: +8
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `mcp-x402.onrender.com`: 54/100 (this document), [markdown](https://verifymcp.io/servers/timwal78-mcp-x402/mcp-x402.md), [page](https://verifymcp.io/servers/timwal78-mcp-x402/mcp-x402)
- remote · `mcp-x402.onrender.com`: 32/100, [markdown](https://verifymcp.io/servers/timwal78-mcp-x402/mcp-x402-2.md), [page](https://verifymcp.io/servers/timwal78-mcp-x402/mcp-x402-2)

## Channel facts

- Endpoint: `https://mcp-x402.onrender.com/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `2.3.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 57/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to call this server, and 94 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - HTTPS is enforced; there's no plaintext access path.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 42/100
  - AI-judged instruction clarity (poor).
  - Context-footprint check failed: tool/resource definitions use about 9844 tokens (~104/item across 94 items; 94 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 26/100
  - Stability check failed: schema churn in the 8 days we've observed: 0 tool removals, 1 breaking changes, 0 auth/transport breaks, 5 additions.
- **Tool Coverage**: 35/100
  - 4% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 96% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http timwal78-mcp-x402 https://mcp-x402.onrender.com/mcp
```

### Codex

```toml
[mcp_servers.timwal78-mcp-x402]
url = "https://mcp-x402.onrender.com/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "timwal78-mcp-x402": {
      "type": "remote",
      "url": "https://mcp-x402.onrender.com/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add timwal78-mcp-x402 --url https://mcp-x402.onrender.com/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  timwal78-mcp-x402:
    url: "https://mcp-x402.onrender.com/mcp"
```

### Other

```json
{
  "mcpServers": {
    "timwal78-mcp-x402": {
      "type": "http",
      "url": "https://mcp-x402.onrender.com/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 54, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 26.

### 2026-08-02 (score 53, 0)

- [security regression] Stability: 0.20 → fail
- [security regression] A breaking change shipped without a version bump: still 1.0.0
- [functional regression] “nexus_agent_hire” added a required parameter “xrpl_wallet”, so existing callers break
- [cosmetic] “nexus_agent_hire” added an optional parameter “symbol”
- [cosmetic] “nexus_agent_hire” reworded the description of “action”
- [cosmetic] “nexus_agent_hire” reworded the description of “agent_id”
- [cosmetic] “nexus_agent_hire” reworded the description of “chain_preference”
- [cosmetic] “nexus_agent_hire” reworded the description of “wallet_address”
- [cosmetic] “ftd_threshold_scan” reworded the description of “scan_type”
- [cosmetic] “ftd_threshold_scan” reworded the description of “ticker”
- [cosmetic] “nexus_agent_hire” reworded the description of “max_budget”
- [cosmetic] “leviathan_signal” reworded the description of “signal_type”

### 2026-08-01 (score 53, +1)

No change was recorded against any check on this day. Stability & Change Management went from 17 to 20. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 6 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-31 (score 52, +4)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 48, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-28 (score 47, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-27 (score 46, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 45)

First indexed and scored.

## MCP tools (94)

### `sml_discover` (~35 tokens)

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

### `sml_status` (~34 tokens)

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

### `apm_negotiate` (~293 tokens)

Agent Preference Manifest (APM) — tell SML what you NEED and get back the exact LIVE tool(s) that match, instead of guessing across the catalog and burning tokens. mode='preview' (FREE) returns match count + best category. mode='contract' (PAID $0.02) returns the full ranked plan with prices, live-status on every match, brokerage terms, and a price-locked signed quote.

Input parameters:

- `agent_id` (string): Optional agent wallet/DID to bind the quote to.
- `constraints` (object): Optional constraints that filter and rank the matches.
- `mode` (string): 'preview' (FREE, default) or 'contract' (PAID $0.02, full plan + signed quote).
- `need` (string, required): What you need, in plain language. e.g. "real-time squeeze signal for GME" or "parse a 13F filing".
- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `wallet_address` (string): Wallet to pay the $0.02 x402 fee from. Required for mode=contract.

### `apm_execute` (~278 tokens)

Execute a tool recommended by apm_negotiate under its price-locked signed quote, collecting the agreed brokerage. Pass the quote's `canonical` + `signature` (from the Service Capability Contract), the tool name, and any args (e.g. `symbol`). Charges the locked price + brokerage, runs the tool, returns the result. Requires APM_QUOTE_SECRET on the gateway.

Input parameters:

- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `quote_canonical` (string, required): The `quote.canonical` string from apm_negotiate (mode=contract).
- `quote_signature` (string, required): The `quote.signature` from apm_negotiate — proves the SML price-lock.
- `symbol` (string): Ticker symbol, when the tool needs one (e.g. squeezeos_council).
- `tool` (string, required): Tool to execute. Must match the quote and be brokerable (e.g. squeezeos_council).
- `wallet_address` (string, required): Wallet that pays the brokered total.

### `agentcard_lookup` (~21 tokens)

Input parameters:

- `identifier` (string, required): Agent wallet address or DID to look up.

### `agentcard_verify` (~49 tokens)

Input parameters:

- `message` (string, required): Original message that was signed.
- `signature` (string, required): Ed25519 signature (hex or base64).
- `wallet_address` (string, required): Agent wallet address that signed the message.

### `agentcard_mint` (~164 tokens)

Input parameters:

- `did` (string, required): Optional DID (decentralized identifier) for the agent.
- `metadata` (object, required): Optional metadata object (capabilities, version, etc.).
- `name` (string, required): Human-readable agent name (max 64 chars).
- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `payment_wallet` (string, required): Wallet to pay x402 fee from (defaults to wallet_address).
- `wallet_address` (string, required): XRPL wallet address for the new agent identity.

### `backtest_run` (~142 tokens)

Input parameters:

- `fees` (number, required): Round-trip commission rate (default 0.001 = 0.1%)
- `lookback_days` (number, required): Days of history to backtest (30–1260, default 252)
- `momentum_threshold` (number, required): Minimum momentum to enter long (default 0.001)
- `momentum_window` (number, required): Momentum rolling window in days (default 10)
- `slippage` (number, required): Slippage per side (default 0.0005)
- `ticker` (string, required): Ticker symbol (e.g. NVDA, SPY, GME)
- `wallet_address` (string, required): Agent wallet address (optional)

### `backtest_validate` (~191 tokens)

Input parameters:

- `fees` (number, required): Round-trip commission rate (default 0.001)
- `lookback_days` (number, required): Total history window (60–1260, default 504 = 2 years)
- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `slippage` (number, required): Slippage per side (default 0.0005)
- `ticker` (string, required): Ticker symbol to validate
- `train_ratio` (number, required): Train/test split ratio (default 0.7 = 70% in-sample)
- `wallet_address` (string, required): Agent wallet for x402 payment (AP2 required)

### `tradier_quote` (~30 tokens)

Input parameters:

- `symbols` (string, required): Comma-separated ticker symbols (e.g. "NVDA,SPY,AAPL")

### `tradier_order` (~225 tokens)

Input parameters:

- `account_id` (string, required): Tradier brokerage account ID
- `duration` (string, required): "day" | "gtc" | "pre" | "post"
- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `price` (number, required): Limit price (required for limit/stop_limit orders)
- `quantity` (number, required): Number of shares (integer)
- `side` (string, required): "buy" or "sell"
- `stop` (number, required): Stop price (required for stop/stop_limit orders)
- `symbol` (string, required): Ticker symbol (e.g. NVDA)
- `type` (string, required): "market" | "limit" | "stop" | "stop_limit"
- `wallet_address` (string, required): Agent wallet for x402 payment (AP2 required)

### `tradier_positions` (~19 tokens)

Input parameters:

- `account_id` (string, required): Tradier brokerage account ID

### `robinhood_quote` (~22 tokens)

Input parameters:

- `symbol` (string, required): Ticker symbol (e.g. NVDA)

### `robinhood_order` (~192 tokens)

Input parameters:

- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `price` (number, required): Limit price (required for limit orders)
- `quantity` (number, required): Number of shares (integer)
- `side` (string, required): "buy" or "sell"
- `symbol` (string, required): Ticker symbol (e.g. NVDA)
- `time_in_force` (string, required): "gfd" (good for day) | "gtc" | "ioc" | "opg"
- `type` (string, required): "market" or "limit"
- `wallet_address` (string, required): Agent wallet for x402 payment (AP2 required)

### `robinhood_portfolio` (~7 tokens)

### `copytrader_status` (~7 tokens)

### `copytrader_whales` (~8 tokens)

### `copytrader_subscribe` (~141 tokens)

Input parameters:

- `max_copy_amount_xrp` (number, required): Maximum XRP to allocate per copied trade.
- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `subscriber_address` (string, required): Your XRPL address that will mirror trades.
- `wallet_address` (string, required): Agent wallet for x402 payment.
- `whale_address` (string, required): XRPL address of the whale to copy.

### `crawl_paid_fetch` (~135 tokens)

Input parameters:

- `extract` (string, required): What to extract. Default: text.
- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `url` (string, required): URL to fetch and parse. Must be http or https.
- `user_agent` (string, required): Custom user-agent string.
- `wallet_address` (string, required): Agent wallet for payment. Humans bypass automatically.

### `crypto_token_price` (~215 tokens)

Input parameters:

- `ids` (string, required): Comma-separated CoinGecko coin IDs, e.g. "bitcoin,ethereum,ripple" (not ticker symbols -- use CoinGecko's own IDs).
- `include_24hr_change` (boolean, required): Include 24h price change percent. Default false.
- `include_24hr_vol` (boolean, required): Include 24h trading volume. Default false.
- `include_market_cap` (boolean, required): Include market cap in the response. Default false.
- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `vs_currencies` (string, required): Comma-separated target currencies, e.g. "usd,eur". Default usd.
- `wallet_address` (string, required): Agent wallet for x402 payment. Humans bypass automatically.

### `crypto_trending` (~93 tokens)

Input parameters:

- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `wallet_address` (string, required): Agent wallet for x402 payment. Humans bypass automatically.

### `equities_heatmap_preview` (~114 tokens)

Input parameters:

- `alpaca_api_key` (string): Your own Alpaca API key ID (BYOK) — takes priority over the server default.
- `alpaca_api_secret` (string): Your own Alpaca API secret (BYOK), paired with alpaca_api_key.
- `polygon_api_key` (string): Your own Polygon.io API key (BYOK) — takes priority over the server default.
- `tradier_api_key` (string): Your own Tradier API key (BYOK) — takes priority over the server default.

### `equities_heatmap_full` (~256 tokens)

Input parameters:

- `alpaca_api_key` (string): Your own Alpaca API key ID (BYOK) — takes priority over the server default.
- `alpaca_api_secret` (string): Your own Alpaca API secret (BYOK), paired with alpaca_api_key.
- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `polygon_api_key` (string): Your own Polygon.io API key (BYOK) — takes priority over the server default.
- `tickers` (array): Up to 20 ticker symbols. Defaults to AMC/GME/IWM plus real dynamically-discovered top movers (day gainers/losers) filling the rest.
- `timeframe` (string): Bar timeframe for RSI computation. Defaults to 1h.
- `tradier_api_key` (string): Your own Tradier API key (BYOK) — takes priority over the server default.
- `wallet_address` (string): Agent wallet address for x402 payment.

### `options_delta_heatmap_preview` (~130 tokens)

Input parameters:

- `alpaca_api_key` (string): Your own Alpaca API key ID (BYOK) — takes priority over the server default.
- `alpaca_api_secret` (string): Your own Alpaca API secret (BYOK), paired with alpaca_api_key.
- `polygon_api_key` (string): Your own Polygon.io API key (BYOK) — takes priority over the server default.
- `tradier_api_key` (string): Your own Tradier API key (BYOK) — takes priority over the server default.
- `underlying` (string): Underlying ticker symbol. Defaults to AMC.

### `options_delta_heatmap_full` (~245 tokens)

Input parameters:

- `alpaca_api_key` (string): Your own Alpaca API key ID (BYOK) — takes priority over the server default.
- `alpaca_api_secret` (string): Your own Alpaca API secret (BYOK), paired with alpaca_api_key.
- `expiration_date` (string): Options expiration date (YYYY-MM-DD). Defaults to nearest available.
- `option_type` (string): Defaults to call.
- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `polygon_api_key` (string): Your own Polygon.io API key (BYOK) — takes priority over the server default.
- `tradier_api_key` (string): Your own Tradier API key (BYOK) — takes priority over the server default.
- `underlying` (string): Underlying ticker symbol. Defaults to AMC.
- `wallet_address` (string): Agent wallet address for x402 payment.

### `federal_grants` (~111 tokens)

Input parameters:

- `agency` (string): Awarding agency name (e.g. "Department of Defense")
- `keyword` (string): Keyword to search grants for (e.g. "AI", "veteran")
- `limit` (string): Number of results (max 50). Default: 10
- `operator_key` (string): Operator bypass key (internal use only) — skips payment when it matches the deployment's SML_API_KEY
- `wallet_address` (string): Agent wallet address for USDC payment

### `federal_npi_lookup` (~126 tokens)

Input parameters:

- `first_name` (string): Provider first name
- `last_name` (string): Provider last name
- `limit` (string): Number of results. Default: 10
- `number` (string): NPI number (10-digit)
- `operator_key` (string): Operator bypass key (internal use only) — skips payment when it matches the deployment's SML_API_KEY
- `organization_name` (string): Organization name
- `state` (string): State abbreviation (e.g. "TX")
- `wallet_address` (string): Agent wallet address for USDC payment

### `federal_sbir_grants` (~113 tokens)

Input parameters:

- `agency` (string): Agency (e.g. "DOD", "NIH")
- `firm` (string): Company name
- `keyword` (string): Keyword search
- `operator_key` (string): Operator bypass key (internal use only) — skips payment when it matches the deployment's SML_API_KEY
- `rows` (string): Number of results. Default: 25
- `wallet_address` (string): Agent wallet address for USDC payment
- `year` (string): Award year

### `federal_osha` (~97 tokens)

Input parameters:

- `establishment_name` (string): Business name
- `limit` (string): Number of results. Default: 25
- `naics_code` (string): NAICS industry code
- `operator_key` (string): Operator bypass key (internal use only) — skips payment when it matches the deployment's SML_API_KEY
- `state` (string): State abbreviation
- `wallet_address` (string): Agent wallet address for USDC payment

### `federal_epa_violations` (~87 tokens)

Input parameters:

- `facility_name` (string): Facility name
- `limit` (string): Number of results. Default: 25
- `operator_key` (string): Operator bypass key (internal use only) — skips payment when it matches the deployment's SML_API_KEY
- `state` (string): State abbreviation
- `wallet_address` (string): Agent wallet address for USDC payment

### `federal_drug_label` (~83 tokens)

Input parameters:

- `drug` (string, required): Drug brand name (e.g. "Lipitor")
- `limit` (string): Number of results. Default: 5
- `operator_key` (string): Operator bypass key (internal use only) — skips payment when it matches the deployment's SML_API_KEY
- `wallet_address` (string): Agent wallet address for USDC payment

### `federal_drug_recall` (~80 tokens)

Input parameters:

- `drug` (string): Drug product name to filter by
- `limit` (string): Number of results. Default: 10
- `operator_key` (string): Operator bypass key (internal use only) — skips payment when it matches the deployment's SML_API_KEY
- `wallet_address` (string): Agent wallet address for USDC payment

### `federal_drug_adverse_events` (~85 tokens)

Input parameters:

- `drug` (string, required): Drug medicinal name (e.g. "aspirin")
- `limit` (string): Number of results. Default: 10
- `operator_key` (string): Operator bypass key (internal use only) — skips payment when it matches the deployment's SML_API_KEY
- `wallet_address` (string): Agent wallet address for USDC payment

### `federal_clinical_trials` (~112 tokens)

Input parameters:

- `condition` (string): Medical condition (e.g. "diabetes")
- `intervention` (string): Drug or intervention name
- `limit` (string): Number of results. Default: 10
- `operator_key` (string): Operator bypass key (internal use only) — skips payment when it matches the deployment's SML_API_KEY
- `status` (string): Trial status (e.g. "RECRUITING")
- `wallet_address` (string): Agent wallet address for USDC payment

### `federal_sec_filings` (~74 tokens)

Input parameters:

- `cik` (string, required): SEC CIK number (e.g. "0000320193" for Apple)
- `operator_key` (string): Operator bypass key (internal use only) — skips payment when it matches the deployment's SML_API_KEY
- `wallet_address` (string): Agent wallet address for USDC payment

### `federal_insider_trades` (~84 tokens)

Input parameters:

- `limit` (string): Number of results. Default: 20
- `operator_key` (string): Operator bypass key (internal use only) — skips payment when it matches the deployment's SML_API_KEY
- `ticker` (string, required): Stock ticker symbol (e.g. "AAPL")
- `wallet_address` (string): Agent wallet address for USDC payment

### `federal_lobbying` (~102 tokens)

Input parameters:

- `client` (string): Lobbying client/company name
- `issue` (string): Specific lobbying issue
- `limit` (string): Number of results. Default: 20
- `operator_key` (string): Operator bypass key (internal use only) — skips payment when it matches the deployment's SML_API_KEY
- `wallet_address` (string): Agent wallet address for USDC payment
- `year` (string): Filing year. Default: current year

### `federal_patents` (~99 tokens)

Input parameters:

- `assignee` (string): Assignee/company name
- `inventor` (string): Inventor last name
- `keyword` (string): Keyword in patent abstract
- `limit` (string): Number of results. Default: 25
- `operator_key` (string): Operator bypass key (internal use only) — skips payment when it matches the deployment's SML_API_KEY
- `wallet_address` (string): Agent wallet address for USDC payment

### `federal_finra_broker` (~74 tokens)

Input parameters:

- `crd` (string): CRD number
- `name` (string): Broker or firm name
- `operator_key` (string): Operator bypass key (internal use only) — skips payment when it matches the deployment's SML_API_KEY
- `wallet_address` (string): Agent wallet address for USDC payment

### `federal_fec_finance` (~137 tokens)

Input parameters:

- `cycle` (string): Election cycle year. Default: 2024
- `limit` (string): Number of results. Default: 20
- `name` (string): Candidate name
- `office` (string): Office sought (H=House, S=Senate, P=President)
- `operator_key` (string): Operator bypass key (internal use only) — skips payment when it matches the deployment's SML_API_KEY
- `party` (string): Party (REP, DEM, etc.)
- `state` (string): State abbreviation
- `wallet_address` (string): Agent wallet address for USDC payment

### `federal_congress_bills` (~99 tokens)

Input parameters:

- `congress` (string): Congress number (e.g. "119"). Default: 119
- `keyword` (string): Keyword to search bills for
- `limit` (string): Number of results. Default: 20
- `operator_key` (string): Operator bypass key (internal use only) — skips payment when it matches the deployment's SML_API_KEY
- `wallet_address` (string): Agent wallet address for USDC payment

### `federal_treasury_yields` (~53 tokens)

Input parameters:

- `operator_key` (string): Operator bypass key (internal use only) — skips payment when it matches the deployment's SML_API_KEY
- `wallet_address` (string): Agent wallet address for USDC payment

### `federal_entity_compliance` (~84 tokens)

Input parameters:

- `cage` (string): CAGE code
- `name` (string): Legal business name
- `operator_key` (string): Operator bypass key (internal use only) — skips payment when it matches the deployment's SML_API_KEY
- `uei` (string): SAM.gov UEI number
- `wallet_address` (string): Agent wallet address for USDC payment

### `federal_usaspending_awards` (~149 tokens)

Input parameters:

- `agency` (string): Awarding agency name
- `keyword` (string): Keyword (e.g. "cybersecurity", "AI")
- `limit` (string): Number of results (max 100). Default: 25
- `naics` (string): NAICS code
- `operator_key` (string): Operator bypass key (internal use only) — skips payment when it matches the deployment's SML_API_KEY
- `recipient` (string): Recipient/company name
- `set_aside` (string): Set-aside type (e.g. "SDVOSBC" for veteran-owned)
- `wallet_address` (string): Agent wallet address for USDC payment

### `federal_grants_gov` (~121 tokens)

Input parameters:

- `agency` (string): Agency code
- `cfda` (string): CFDA number
- `eligibility` (string): Eligibility category
- `keyword` (string): Keyword search (e.g. "veteran", "small business")
- `limit` (string): Number of results (max 100). Default: 25
- `operator_key` (string): Operator bypass key (internal use only) — skips payment when it matches the deployment's SML_API_KEY
- `wallet_address` (string): Agent wallet address for USDC payment

### `federal_sba_awards` (~132 tokens)

Input parameters:

- `fiscal_year` (string): Fiscal year. Default: 2024
- `keyword` (string): Keyword search
- `limit` (string): Number of results (max 100). Default: 25
- `naics` (string): NAICS code
- `operator_key` (string): Operator bypass key (internal use only) — skips payment when it matches the deployment's SML_API_KEY
- `set_aside` (string): Set-aside type. Default: SDVOSBC (veteran-owned)
- `wallet_address` (string): Agent wallet address for USDC payment

### `federal_options_flow` (~87 tokens)

Input parameters:

- `limit` (string): Number of trades. Default: 50
- `operator_key` (string): Operator bypass key (internal use only) — skips payment when it matches the deployment's SML_API_KEY
- `symbol` (string): Ticker symbol (e.g. "SPY"). Default: SPY
- `wallet_address` (string): Agent wallet address for USDC payment

### `federal_sam_opportunities` (~165 tokens)

Input parameters:

- `agency` (string): Organization / agency name
- `days` (string): Lookback days. Default 30
- `keyword` (string): Title keyword
- `limit` (string): Max results (max 25). Default 10
- `naics` (string): NAICS code
- `operator_key` (string): Operator bypass key (internal use only) — skips payment when it matches the deployment's SML_API_KEY
- `ptype` (string): SAM ptype: o=solicitation (default), k=combined, p=presolicitation
- `set_aside` (string): SAM typeOfSetAside code e.g. SDVOSBC
- `wallet_address` (string): Agent wallet address for USDC payment

### `federal_sam_entity` (~83 tokens)

Input parameters:

- `cage` (string): CAGE code
- `entity_name` (string): Legal business name
- `operator_key` (string): Operator bypass key (internal use only) — skips payment when it matches the deployment's SML_API_KEY
- `uei` (string): SAM UEI
- `wallet_address` (string): Agent wallet address for USDC payment

### `forge_status` (~5 tokens)

### `forge_llm` (~170 tokens)

Input parameters:

- `max_tokens` (number, required): Maximum tokens in the response (default: model max). Max: 8192.
- `model` (string, required): Model identifier (e.g. "claude-3-5-haiku-20241022", "gpt-4o-mini").
- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `prompt` (string, required): Prompt to send to the LLM (max 32768 chars).
- `wallet_address` (string, required): Agent wallet for x402 pay-per-token billing.

### `ftd_threshold_scan` (~170 tokens)

Input parameters:

- `min_spike_multiplier` (number, required): Minimum FTD spike multiplier vs baseline. Default: 2x.
- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `scan_type` (string, required): "alerts" is free. "full" and "spike_history" require 0.05 USDC and a ticker.
- `ticker` (string, required): Filter by ticker. Optional for "alerts"; required for "full"/"spike_history".
- `wallet_address` (string, required): Agent wallet for paid scans.

### `fx_exchange_rate` (~172 tokens)

Input parameters:

- `base` (string, required): 3-letter base currency code, e.g. "USD". Default USD.
- `date` (string): Historical rate date (YYYY-MM-DD). Omit for the latest available rate.
- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `quotes` (string): Comma-separated 3-letter target currency codes to filter, e.g. "EUR,GBP,JPY". Omit for all available currencies.
- `wallet_address` (string, required): Agent wallet for x402 payment. Humans bypass automatically.

### `ghost_status` (~5 tokens)

### `ghost_route` (~159 tokens)

Input parameters:

- `amount` (string, required): Amount to route (as string to preserve precision).
- `currency` (string, required): Token/currency symbol (e.g. RLUSD, XRP, ETH).
- `destination_address` (string, required): Recipient address on the destination chain.
- `from_chain` (string, required): Source chain.
- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `to_chain` (string, required): Destination chain.
- `wallet_address` (string, required): Agent wallet for x402 payment.

### `pha_lookup` (~100 tokens)

Input parameters:

- `city` (string): City name, e.g. Kinston
- `county` (string): County name, e.g. Lenoir
- `payment_header` (string)
- `payment_tx_hash` (string)
- `state` (string): 2-letter state, e.g. NC
- `wallet_address` (string, required): Agent wallet for x402 payment
- `zip` (string): US ZIP code, e.g. 28504

### `hcv_fmr` (~75 tokens)

Input parameters:

- `bedrooms` (number): 0-4, default 4
- `county` (string)
- `payment_header` (string)
- `payment_tx_hash` (string)
- `state` (string)
- `wallet_address` (string, required)
- `year` (number)
- `zip` (string)

### `housing_landlord_checklist` (~47 tokens)

Input parameters:

- `bedrooms` (number)
- `payment_header` (string)
- `payment_tx_hash` (string)
- `wallet_address` (string, required)
- `zip` (string)

### `hud_vash_contacts` (~46 tokens)

Input parameters:

- `county` (string)
- `payment_header` (string)
- `payment_tx_hash` (string)
- `state` (string)
- `wallet_address` (string, required)

### `section8_geo_lookup` (~100 tokens)

Input parameters:

- `operator_key` (string): Operator bypass key (internal use only) — skips payment when it matches the deployment's SML_API_KEY
- `scope` (string, required): states: list all states. counties: list counties for a state (requires state_code). metros: list metro areas.
- `state_code` (string): 2-letter state code, required when scope=counties
- `wallet_address` (string): Agent wallet address for USDC payment

### `section8_fmr` (~116 tokens)

Input parameters:

- `entity_id` (string): HUD FMR entity ID for a county/metro area (get one via section8_geo_lookup)
- `operator_key` (string): Operator bypass key (internal use only) — skips payment when it matches the deployment's SML_API_KEY
- `state_code` (string): Alternative to entity_id: 2-letter state code for statewide data
- `wallet_address` (string): Agent wallet address for USDC payment
- `year` (number): Fiscal year, defaults to the current HUD dataset year

### `section8_income_limits` (~115 tokens)

Input parameters:

- `entity_id` (string): HUD IL entity ID for a county/metro area (get one via section8_geo_lookup)
- `operator_key` (string): Operator bypass key (internal use only) — skips payment when it matches the deployment's SML_API_KEY
- `state_code` (string): Alternative to entity_id: 2-letter state code for statewide data
- `wallet_address` (string): Agent wallet address for USDC payment
- `year` (number): Fiscal year, defaults to the current HUD dataset year

### `pha_opportunities` (~136 tokens)

Input parameters:

- `days` (number): Lookback days. Default 30
- `keyword` (string): Override the default housing-keyword search with a single custom title keyword
- `limit` (number): Max results (max 25). Default 10
- `naics` (string): NAICS code filter
- `operator_key` (string): Operator bypass key (internal use only) — skips payment when it matches the deployment's SML_API_KEY
- `set_aside` (string): SAM typeOfSetAside code, e.g. SDVOSBC
- `wallet_address` (string): Agent wallet address for USDC payment

### `pha_search` (~115 tokens)

Input parameters:

- `city` (string): City name
- `limit` (number): Max results (max 50). Default 15
- `name` (string): PHA/agency name fragment
- `operator_key` (string): Operator bypass key (internal use only) — skips payment when it matches the deployment's SML_API_KEY
- `state` (string): 2-letter state code, e.g. NC
- `wallet_address` (string): Agent wallet address for USDC payment
- `zip` (string): US ZIP code

### `launchpad_status` (~6 tokens)

### `launchpad_list` (~6 tokens)

### `launchpad_create` (~191 tokens)

Input parameters:

- `creator_address` (string, required): XRPL address of the token creator.
- `description` (string, required): Token description (max 512 chars).
- `initial_supply` (number, required): Total token supply (integer).
- `name` (string, required): Token name (e.g. "Moon Rocket").
- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `symbol` (string, required): Ticker symbol (e.g. MNRKT, max 10 chars).
- `target_liquidity_xrp` (number, required): XRP target to graduate from bonding curve to DEX.
- `wallet_address` (string, required): Agent wallet for x402 payment.

### `launchpad_buy` (~135 tokens)

Input parameters:

- `buyer_address` (string, required): XRPL address of the buyer.
- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `token_address` (string, required): Token contract/address on XRPL.
- `wallet_address` (string, required): Agent wallet for x402 payment.
- `xrp_amount` (number, required): Amount of XRP to spend on the bonding curve.

### `leviathan_signal` (~168 tokens)

Input parameters:

- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `signal_type` (string, required): squeeze — 190-EMA stack alignment + squeeze_alert flag. momentum — 365-day EMA trend (ABOVE/BELOW). all — full multi-engine composite (190 + 365 + TripleLock).
- `ticker` (string, required): Ticker symbol (e.g. TSLA, MSTR, SPY). Required.
- `wallet_address` (string, required): Agent wallet address for payment. Auto-provisioned if omitted.

### `nexus_agent_hire` (~381 tokens)

Input parameters:

- `action` (string, required): "query" is free (browses SqueezeOS's real live job board). "hire" posts a real job there and charges 5% commission on the bounty.
- `agent_id` (string, required): Optional free-text note on who you want to do the work — the real board is an open marketplace (any qualified executor can accept), not a directed hire of one specific agent, so this is folded into t…
- `capability` (string, required): Capability or skill to search for (e.g. "options flow analysis").
- `chain_preference` (string, required): Payment chain for the mcp-x402 commission fee. The job bounty itself always settles wallet-to-wallet on XRPL — SqueezeOS's real Agent Hiring Protocol board is zero-custody and XRPL-native.
- `max_budget` (string, required): Max budget in RLUSD for the job bounty (e.g. "1.00"). Also used to compute the 5% USDC commission on hire.
- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `symbol` (string): Optional ticker to filter/tag the job by.
- `wallet_address` (string, required): Agent wallet for the mcp-x402 commission payment (Base/USDC).
- `xrpl_wallet` (string, required): Your XRPL wallet (starts with "r"). Required for action=hire — SqueezeOS's job board is zero-custody and pays the bounty to/from real XRPL wallets, not this gateway's USDC wallet.

### `proof_invoice` (~24 tokens)

Input parameters:

- `endpoint_id` (string, required): UUID of the premium endpoint to get a payment invoice for.

### `proof_verify` (~35 tokens)

Input parameters:

- `endpoint_id` (string, required): UUID of the endpoint the payment was for.
- `tx_hash` (string, required): XRPL transaction hash to verify.

### `proof_credit_score` (~28 tokens)

Input parameters:

- `wallet_address` (string, required): Agent wallet address to look up credit score for (300-850 scale).

### `rails_status` (~5 tokens)

### `rails_transfer` (~157 tokens)

Input parameters:

- `amount` (string, required): Amount to transfer (as string to preserve precision).
- `currency` (string, required): Token to transfer.
- `from_address` (string, required): Sender XRPL address.
- `memo` (string, required): Optional transfer memo (max 256 chars).
- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `to_address` (string, required): Recipient XRPL or Xahau address.
- `wallet_address` (string, required): Agent wallet for x402 payment.

### `screen_restricted_party` (~281 tokens)

Input parameters:

- `countries` (string): Comma-separated ISO alpha-2 country codes to filter by.
- `fuzzy_name` (boolean, required): Enable fuzzy name matching for misspellings/variants. Default false.
- `name` (string, required): Individual or entity name to screen, e.g. "Acme Exports LLC".
- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `size` (number, required): Max results to return (1-50, default 20).
- `sources` (string): Comma-separated source list abbreviations to restrict the search to: DPL (BIS Denied Persons), EL (BIS Entity List), MEU (BIS Military End User), UVL (BIS Unverified List), ISN (State Nonproliferatio…
- `wallet_address` (string, required): Agent wallet for x402 payment. Humans bypass automatically.

### `shadow_query` (~126 tokens)

Input parameters:

- `context` (string, required): Optional context to refine the query (max 1024 chars).
- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `query` (string, required): Natural language query for signal intelligence (max 2048 chars).
- `wallet_address` (string, required): Agent wallet for x402 payment.

### `shadow_ingest` (~131 tokens)

Input parameters:

- `payload` (object, required): Signal data payload as a JSON object.
- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `source` (string, required): Source identifier for the data being ingested (e.g. "discord", "twitter", "on-chain").
- `wallet_address` (string, required): Agent wallet for x402 payment.

### `squeezeos_preview` (~28 tokens)

Input parameters:

- `symbol` (string, required): Ticker symbol (e.g. TSLA, IWM, MSTR).

### `squeezeos_history` (~24 tokens)

Input parameters:

- `symbol` (string, required): Ticker symbol. Omit to get all recent signals.

### `squeezeos_oracle` (~24 tokens)

Input parameters:

- `symbol` (string, required): Ticker symbol. Omit for full oracle batch.

### `squeezeos_ftd` (~7 tokens)

### `squeezeos_status` (~6 tokens)

### `squeezeos_demo` (~6 tokens)

### `squeezeos_marketplace_browse` (~9 tokens)

### `squeezeos_futures_leaderboard` (~10 tokens)

### `squeezeos_council` (~116 tokens)

Input parameters:

- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `symbol` (string, required): Ticker symbol to analyze (e.g. TSLA, GME, IWM).
- `wallet_address` (string, required): Agent wallet address for x402 payment.

### `squeezeos_scan` (~90 tokens)

Input parameters:

- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `wallet_address` (string, required): Agent wallet address for x402 payment.

### `squeezeos_options` (~90 tokens)

Input parameters:

- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `wallet_address` (string, required): Agent wallet address for x402 payment.

### `squeezeos_iwm` (~91 tokens)

Input parameters:

- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `wallet_address` (string, required): Agent wallet address for x402 payment.

### `squeezeos_marketplace_read` (~109 tokens)

Input parameters:

- `listing_id` (string, required): Listing ID from squeezeos_marketplace_browse.
- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `wallet_address` (string, required): Agent wallet address for x402 payment.

### `search_trade_leads` (~265 tokens)

Input parameters:

- `contract_start_from` (string): Only leads with a contract start date on/after this date (YYYY-MM-DD).
- `contract_start_to` (string): Only leads with a contract start date on/before this date (YYYY-MM-DD).
- `country_codes` (string): Comma-separated ISO alpha-2 country codes to filter by (buyer/tender country).
- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `q` (string): Keyword search across trade lead titles/descriptions, e.g. "solar panels" or "water treatment".
- `size` (number, required): Max results to return (1-50, default 20).
- `tender_start_from` (string): Only leads with a tender start date on/after this date (YYYY-MM-DD).
- `tender_start_to` (string): Only leads with a tender start date on/before this date (YYYY-MM-DD).
- `wallet_address` (string, required): Agent wallet for x402 payment. Humans bypass automatically.

### `xdeo_earnings_estimate` (~141 tokens)

Input parameters:

- `estimate_type` (string, required): What estimate to fetch.
- `fiscal_quarter` (string, required): Quarter in format Q1YYYY (e.g. Q12025).
- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `ticker` (string, required): Ticker symbol (e.g. NVDA).
- `wallet_address` (string, required): Agent wallet for payment.

### `xmit_edgar_decode` (~140 tokens)

Input parameters:

- `filing_url` (string, required): SEC EDGAR filing URL (DEF 14A, 13F, or 13D).
- `format` (string, required): Output format. Default: json.
- `parse_target` (string, required): What to extract.
- `payment_header` (string): Base64 X-PAYMENT EIP-3009 payload, facilitator-settled (standard rail). Omit if using payment_tx_hash.
- `payment_tx_hash` (string): On-chain Base tx hash proving USDC payment to the operator (sovereign rail). Omit if using payment_header.
- `wallet_address` (string, required): Agent wallet for payment.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/timwal78-mcp-x402/mcp-x402#diagnostics

## Score history

- 2026-08-03: 54
- 2026-08-02: 53
- 2026-08-01: 53
- 2026-07-31: 52
- 2026-07-30: 48
- 2026-07-29: 47
- 2026-07-28: 47
- 2026-07-27: 46
- 2026-07-26: 45

## Links

- Remote endpoint: https://mcp-x402.onrender.com/mcp
- Repository: https://github.com/timwal78/SML_Portfolio
- Changelog RSS feed: https://verifymcp.io/servers/timwal78-mcp-x402/mcp-x402/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/timwal78-mcp-x402/mcp-x402/changelog.json
- HTML version of this page: https://verifymcp.io/servers/timwal78-mcp-x402/mcp-x402