Skip to main content
Glama
README.md
# @withsilex/x402-mcp

Official **Model Context Protocol (MCP)** server connecting **Claude Desktop, Cursor, Windsurf, Cline, and autonomous AI agents** to the **With Silex HTTP 402 Permanent Data Encyclopedia** (`https://withsilex.com/directory`).

- **48 Live Autonomous Subdomains + 5 Cross-Domain Alpha Syntheses** updated every 15 minutes (SEC EDGAR, DHS CISA Zero-Day CVEs, USAspending Federal Contracts, NOAA Aviation METARs, ERCOT Grid, NIH ClinicalTrials.gov, FDA Recalls, USGS Seismic, arXiv, Kraken L1/L2 Orderbooks).
- **Hyper-Specific Keyword & Schema Field Search (`<15ms`):** Query exact phrases, tickers, CVE IDs, airport ICAOs, or `key:field` filters and unlock single snapshots (`$0.001+`) or 25%-discounted Whole-Keyword JSONL Bundles.
- **Zero-Fee ~350ms Settlement:** Powered natively by **Nano (`XNO`)** on-chain block proofs (`X-Payment: <64_HEX_HASH>`), with built-in Nanswap cross-chain instructions for agents starting with USDC, SOL, ETH, or BTC.

## Quick Install (Claude Desktop / Cursor / Windsurf)

```json
{
  "mcpServers": {
    "withsilex-x402": {
      "command": "npx",
      "args": ["-y", "@withsilex/x402-mcp"],
      "env": {
        "NANO_PRIVATE_KEY": "OPTIONAL_64_HEX_LOCAL_BURNER_KEY",
        "SILEX_MAX_AUTO_USD": "0.10"
      }
    }
  }
}
```

## Included MCP Tools
1. `silex_hyper_search` - Search all permanent paywalls by keyword, exact phrase, or `key:field` operator.
2. `silex_suggest_entities` - Instant autocomplete of indexed CVEs, tickers, ICAOs, NCTs, and JSON schema keys.
3. `silex_live_pulse` - Fetch all 48 live subdomain feeds, 5 Cross-Domain Synthesis drops, and the 15m mint countdown.
4. `silex_inspect_402_challenge` - Inspect any HTTP 402 URL, Free Sample Record #1, Nano `payTo` address, `amountRaw`, and Nanswap USDC/SOL -> XNO burner top-up endpoints.
5. `silex_unlock_with_tx_hash` - Submit a 64-hex Nano send block hash via `X-Payment` to unlock any single drop, synthesis, 24h stream, or Whole-Keyword JSONL bundle.
6. `silex_auto_pay_and_unlock` - Sign, broadcast, and unlock an HTTP 402 resource in one call using your local `NANO_PRIVATE_KEY` (strictly non-custodial; capped by `SILEX_MAX_AUTO_USD`).

TDQS

A3.7/5.0

Scored across 6 tools

Disambiguation4/5

Tools mostly target distinct stages: entity autocomplete, challenge inspection, manual unlock, auto-pay unlock, search, and live telemetry. The only potential confusion is between unlock_with_tx_hash and auto_pay_and_unlock, but descriptions clearly distinguish manual vs autonomous payment.

Naming Consistency4/5

All tools share the consistent silex_ prefix and snake_case style. Most follow a verb_noun pattern, though hyper_search and live_pulse deviate slightly into adjective/noun phrasing.

Tool Count5/5

Six tools is well-scoped for a focused 402-paywall data access server. Each tool covers a distinct capability without bloat.

Completeness4/5

The surface covers discovery (suggest, search, pulse), inspection, and both manual and automated payment/unlock workflows. Minor gaps like a direct listing of all available drops or a balance/spend history tool prevent a perfect score.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues