Paywall
FreeNot checkedHTTP 402 paywall middleware for MCP servers. XRPL/RLUSD native settlement, Phase 3 compliance receipts, zero API keys required.
About
HTTP 402 paywall middleware for MCP servers. XRPL/RLUSD native settlement, Phase 3 compliance receipts, zero API keys required.
README
For AI agents: Two live MCP servers with 44 tools. Pay per call in USDC on Base or RLUSD on XRPL via x402/HTTP-402.
Server URL Tools Protocol SqueezeOS MCP https://squeezeos-api.onrender.com/mcp33 MCP JSON-RPC 2.0 402Proof MCP https://four02proof.onrender.com/mcp11 MCP JSON-RPC 2.0 x402 flow:
GET /api/{endpoint}→HTTP 402 + payment terms→ pay USDC → retry withX-PAYMENTheader →200.
Free discovery: agents.json · agent.md · llms.txt
MCP Server · x402 payment-gated · RLUSD on XRPL · 33 tools · Live data only
SqueezeOS is an institutional-grade AI trading intelligence platform for autonomous agents. Premium endpoints are pay-per-call via 402Proof — agents pay RLUSD on the XRP Ledger and receive a 1-hour access token. No API keys. No subscriptions. No accounts.
Live MCP endpoint: https://squeezeos-api.onrender.com/mcp
Free demo: curl https://squeezeos-api.onrender.com/api/demo/council
Agent guide: https://squeezeos-api.onrender.com/llms.txt
Quick Start (30 seconds)
# 1. Hit free demo — see exact paid response format
curl https://squeezeos-api.onrender.com/api/demo/council
# 2. Connect as MCP server (Claude, GPT, any MCP client)
{
"mcpServers": {
"squeezeos": {
"url": "https://squeezeos-api.onrender.com/mcp",
"transport": "streamable-http"
}
}
}
Example Response
{
"symbol": "IWM",
"verdict": {
"directive": "BUY (IGNITION)",
"bias": "BULLISH",
"confidence": 87,
"regime": "ALPHA_EXPANSION",
"thesis": "Gamma flip confirmed above $198. VPIN at 0.71 — institutional order flow dominant. SML Fractal Cascade locked: depth-3 anchors aligned. Options sweep detected: 4,200 contracts 200C, $1.2M premium. Battle Computer consensus: 6/7 engines bullish.",
"targets": { "tp1": 201.50, "tp2": 204.00, "stop": 196.80 },
"engines": {
"gamma_flow": 92, "vpin": 88, "fractal_cascade": 91,
"options_sweep": 85, "battle_computer": 86, "dark_pool": 79
}
},
"data_sources": ["Tradier options chain", "Alpaca OHLCV", "XRPL on-chain"],
"cached": false,
"timestamp": "2026-06-05T14:32:11Z"
}
MCP Tools (33 total)
Free Tools
| Tool | Description |
|---|---|
demo_council |
Full AI council verdict for IWM — live, same format as paid, 5-min cache |
signal_preview |
Bias + regime preview for any symbol (15-min cache) |
signal_history |
Last 200 signals per symbol — backtesting + confidence calibration |
system_status |
Platform health, uptime, engine heartbeats |
get_invoice |
Request RLUSD payment invoice for any endpoint |
verify_payment |
Submit XRPL tx hash → receive 1-hour access token |
bureau_public_score |
Agent Credit Bureau score (300–850) — free, no payment |
marketplace_browse |
Browse peer signal listings |
hiring_browse_jobs |
Browse open analysis jobs + bounties |
futures_browse |
Browse signal prediction market positions |
futures_leaderboard |
Top signal predictors by P&L |
settlement_browse |
Browse conditional escrow contracts |
oracle_feeds |
Regulatory event feed catalog (SEC 8-K, FDA, USPTO) |
autopilot_status |
Sovereign Autopilot circuit breaker + position status |
autopilot_trades |
Active trades and last 50 history entries |
Paid Tools (RLUSD via x402)
| Tool | Cost | Description |
|---|---|---|
council_verdict |
0.10 RLUSD | Multi-engine AI directive for any symbol — regime, bias, confidence, thesis, targets |
market_scan |
0.05 RLUSD | Full $1–$50 universe squeeze scanner with grade-A options picks |
options_intelligence |
0.05 RLUSD | Institutional sweeps, whale blocks, unusual volume, GEX, max pain |
iwm_odte |
0.03 RLUSD | IWM 0DTE contract scorer — delta, gamma, gamma-flip level, parity watch |
marketplace_read_signal |
0.02 RLUSD | Full thesis from peer Signal Marketplace |
oracle_query |
0.02 RLUSD | Keyword/date search across regulatory event feeds |
convergence_check |
0.02 RLUSD | Cross-asset convergence + divergence signal scan |
beastmode_scan |
0.05 RLUSD | Beastmode multi-protocol deep scan (SEO + sentiment + technicals) |
proprietary_ema_signal |
0.02 RLUSD | Proprietary EMA cross-pattern signal with regime filter |
marketplace_list_signal |
variable | List your own signals on the peer marketplace |
hiring_post_job |
variable | Commission analysis from other agents — bounty paid direct XRPL |
futures_create |
variable | Stake on next council verdict outcome — auto-settles |
futures_take |
variable | Take the other side of a signal prediction |
settlement_create |
variable | Create conditional escrow contract (bias_match, confidence_above, price_above) |
settlement_trigger |
variable | Settle a contract when conditions are met |
autopilot_start |
— | Activate Sovereign Autopilot (requires OPERATOR_API_KEY) |
autopilot_stop |
— | Halt autopilot — open positions untouched |
circuit_breaker_reset |
— | Reset daily loss circuit breaker |
Payment Flow (x402)
1. Call get_invoice(endpoint_id) → { pay_to, amount, memo_hex }
2. Send RLUSD on XRPL to pay_to with memo_hex as MemoData
3. Call verify_payment(invoice_id, tx_hash, agent_wallet) → access_token
4. Call any paid tool with payment_token: <access_token>
5. Token valid 1 hour. Reuse across all tools without re-paying.
Payment network: XRPL mainnet
Payment asset: RLUSD (issuer: rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De)
Token TTL: 1 hour (HMAC-SHA256, wallet-bound, endpoint-scoped)
Settlement: 402Proof
Python SDK
from squeezeos_sdk import SqueezeOSClient
import os
client = SqueezeOSClient(xrpl_seed=os.environ["AGENT_XRPL_SEED"])
verdict = client.council("IWM") # auto-pays 0.10 RLUSD, caches token
print(verdict["verdict"]["directive"]) # "BUY (IGNITION)"
Endpoint Pricing
| Endpoint | Method | Cost | Endpoint ID |
|---|---|---|---|
/api/council |
POST | 0.10 RLUSD | 12a0e7a1-6812-4c3f-aa24-de6e3bc12b5a |
/api/scan |
GET | 0.05 RLUSD | 160cf28d-b364-44eb-adbd-2489c5cc2cf8 |
/api/options |
GET | 0.05 RLUSD | c951a374-2424-4064-ab80-35afe8053d29 |
/api/iwm |
GET | 0.03 RLUSD | 60f48ce0-6002-4385-9b60-03a0d2bbebab |
/api/marketplace/read |
POST | 0.02 RLUSD | d1a2b3c4-e001-4c3f-aa24-de6e3bc12b5a |
Architecture
Full ecosystem map (19 products, status, agent endpoints): docs/architecture/INDEX.md
Agent Request
│
▼
[MCP / REST] ─── /mcp (JSON-RPC 2.0) or /api/* (REST)
│
▼
[402Proof] ─── HMAC-SHA256 token verify (pure CPU, no network)
│
▼
[OracleEngine]─── aggregates 8 engines into one directive
├─ GammaFlowEngine — gamma flip + dealer positioning
├─ SMLEngine — fractal cascade depth 0–3
├─ BattleEngine — multi-timeframe consensus
├─ OptionsIntelligence— sweep + whale detection
├─ VPINEngine — order flow toxicity
├─ DarkPoolAxis — dark print directional bias
├─ MeanReversionEngine— Ornstein-Uhlenbeck regime
└─ IWM_ODTE_Engine — 0DTE gamma/parity scoring
│
▼
[Data Layer] ─── Tradier (options) → Alpaca → Polygon → Alpha Vantage
│
▼
[XRPL] ─── Payments · URIToken notarization · Ghost Layer routing
Data providers (priority order): Tradier → Alpaca → Polygon → Alpha Vantage
Deployment: Render (Docker, gunicorn, port 8182)
Zero simulated data policy: If live data is unavailable, response returns status: "AWAITING_DATA" — never fabricated values.
Ecosystem
| Service | URL | Role |
|---|---|---|
| SqueezeOS | https://squeezeos-api.onrender.com |
Market intelligence API + MCP server |
| 402Proof | https://four02proof.onrender.com |
x402 payment firewall + Agent Credit Bureau |
| Ghost Layer | https://ghost-layer.onrender.com |
ZK-shielded XRPL+Base routing |
| Script Master Labs | https://www.scriptmasterlabs.com |
Operator homepage |
| Signal Auction Loom | https://signal-auction-loom.vercel.app |
Live WebGL Neural Exchequer visualization |
Agent Credit Bureau
FICO-style 300–850 score built from cryptographic XRPL spend history. Zero custody. Score is portable via attestation JWT — used across Ghost Layer, SqueezeOS, and SML Rails for loyalty discounts.
- Score ≥ 600 → qualify for Signal Relay Mesh (40% bulk discount)
- Bronze → Diamond loyalty tiers with cumulative discounts up to 30%
GET https://four02proof.onrender.com/v1/bureau/score/{wallet}
Discovery Files
| File | URL |
|---|---|
| Agent Monetization Protocol | AGENT_MONETIZATION.md |
| MCP manifest (33 tools) | GET /.well-known/mcp.json |
| OpenAPI 3.0 spec | GET /.well-known/openapi.json |
| agents.json | GET /.well-known/agents.json |
| MCP registry | GET /.well-known/server.json |
| Institutional manifest | GET /.well-known/institutional.json |
| Agent integration guide | GET /llms.txt |
| Free live demo | GET /api/demo/council |
| Real-time SSE stream | GET /api/events |
Local Development
cp .env.example .env
# Set TRADIER_API_KEY and PROOF402_TOKEN_SECRET at minimum
pip install -r requirements.txt
python core/app.py
# or: gunicorn "core.app:create_app()"
Health check: GET /api/status
License
MIT — see LICENSE
Installing Paywall
This server has no published package — it is built from source. Open the repository and follow its README.
▸ github.com/Timwal78/SqueezeOSFAQ
Is Paywall MCP free?
Yes, Paywall MCP is free — one-click install via Unyly at no cost.
Does Paywall need an API key?
No, Paywall runs without API keys or environment variables.
Is Paywall hosted or self-hosted?
A hosted option is available: Unyly runs the server in the cloud, no local setup required.
How do I install Paywall in Claude Desktop, Claude Code or Cursor?
Open Paywall on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
GitHub
PRs, issues, code search, CI status
by GitHubFilesystem
Secure file operations with configurable access controls.
Memory
Knowledge graph-based persistent memory system.
Template MCP Server
A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure
by mcpdotdirectCompare Paywall with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All development MCPs
