{"server":"io.github.Timwal78/squeezeos","count":22,"tools":[{"name":"aftersearch_accept","title":"Aftersearch Accept","description":"Get accepted delivery for one immutable job with caller-supplied x402 authorization. Use this when an agent holds fresh PAYMENT-REQUIRED terms and the caller approves the spend; the caller payment_response is forwarded as the PAYMENT-SIGNATURE and SML never signs or spends. Returns the Evidence Pack plus the PAYMENT-RESPONSE receipt; on missing authorization returns a fresh 402 challenge, on a bad job_id a structured error. With valid caller authorization, settles an irreversible USDC payment and persists a receipt; the stored job remains immutable. For example, accepting a quoted job delivers the full Evidence Pack with settlement proof.","input_schema":{"type":"object","required":["job_id","payment_response"],"properties":{"job_id":{"type":"string","pattern":"^[a-f0-9]{24}$","description":"The 24-char hex job_id being settled."},"payment_response":{"type":"string","maxLength":65536,"minLength":1,"description":"The caller x402 payment authorization payload for this exact job, forwarded as PAYMENT-SIGNATURE. API keys are never accepted as a substitute."}},"additionalProperties":false},"output_schema":{"type":"object","anyOf":[{"required":["ok","status_code"]},{"required":["error"]}],"properties":{"ok":{"type":"boolean","description":"Whether the upstream HTTP status is 2xx; not settlement proof."},"body":{"description":"Unmodified upstream JSON, or bounded response text. Consult that capability's live schema."},"error":{"type":"string"},"charged":{"const":false,"description":"Present on local/transport failures; these do not establish an upstream charge."},"message":{"type":"string"},"auto_spent":{"const":false},"status_code":{"type":["integer","null"],"maximum":599,"minimum":100,"description":"Observed upstream HTTP status, or null when no response was obtained."},"substituted":{"const":false},"content_type":{"type":"string"},"payment_required":{"type":"string","description":"Observed PAYMENT-REQUIRED header; a challenge does not prove payment."},"payment_response":{"type":"string","description":"Observed PAYMENT-RESPONSE header. Assess it together with accepted delivery."},"caller_supplied_authorization":{"type":"boolean"}},"description":"Canonical REST response envelope, or a local/transport rejection. Upstream data remains in body and is defined by the live capability schema.","additionalProperties":true},"annotations":{"title":"Aftersearch Accept","readOnlyHint":false,"openWorldHint":true,"idempotentHint":false,"destructiveHint":false},"source":"probe","observed_at":"2026-10-20T01:21:56.006Z"},{"name":"aftersearch_quote","title":"Aftersearch Quote","description":"Return fresh x402 PAYMENT-REQUIRED terms for one immutable job. Call this when an agent holds a job_id and needs the current USDC price and payment instructions before deciding to pay; a 402 challenge is a quote, never payment. Returns the price in USDC, the pay_to address, network, and asset for that exact job; on an unknown job_id returns a structured job_not_found error. Read-only and idempotent; no side effects. For example, quoting a job_id returned by aftersearch_resolve yields its exact USDC terms for this job only.","input_schema":{"type":"object","required":["job_id"],"properties":{"job_id":{"type":"string","pattern":"^[a-f0-9]{24}$","description":"The 24-char hex job_id returned by aftersearch_resolve or aftersearch_verify_serp."}},"additionalProperties":false},"output_schema":{"type":"object","anyOf":[{"required":["ok","status_code"]},{"required":["error"]}],"properties":{"ok":{"type":"boolean","description":"Whether the upstream HTTP status is 2xx; not settlement proof."},"body":{"description":"Unmodified upstream JSON, or bounded response text. Consult that capability's live schema."},"error":{"type":"string"},"charged":{"const":false,"description":"Present on local/transport failures; these do not establish an upstream charge."},"message":{"type":"string"},"auto_spent":{"const":false},"status_code":{"type":["integer","null"],"maximum":599,"minimum":100,"description":"Observed upstream HTTP status, or null when no response was obtained."},"substituted":{"const":false},"content_type":{"type":"string"},"payment_required":{"type":"string","description":"Observed PAYMENT-REQUIRED header; a challenge does not prove payment."},"payment_response":{"type":"string","description":"Observed PAYMENT-RESPONSE header. Assess it together with accepted delivery."},"caller_supplied_authorization":{"type":"boolean"}},"description":"Canonical REST response envelope, or a local/transport rejection. Upstream data remains in body and is defined by the live capability schema.","additionalProperties":true},"annotations":{"title":"Aftersearch Quote","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-20T01:21:56.006Z"},{"name":"aftersearch_resolve","title":"Aftersearch Resolve","description":"Convert a natural-language query into machine intent, a bounded Evidence Pack, and one immutable x402 job with a fresh quote pointer. Use this when an agent needs to turn a what-would-I-Google question into a priced, quotable evidence job before any payment. Returns the immutable job_id plus the public job summary; on invalid input returns a structured input_rejected error instead of a job. Creates one server-side job record per call (a side effect) but never spends or moves funds. For example, asking whether a token contract is safe becomes an intent-scored Evidence Pack with fresh PAYMENT-REQUIRED terms.","input_schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","maxLength":60000,"minLength":1,"description":"The natural-language question to compile into intent and an Evidence Pack (1-60000 chars)."}},"additionalProperties":false},"output_schema":{"type":"object","anyOf":[{"required":["ok","status_code"]},{"required":["error"]}],"properties":{"ok":{"type":"boolean","description":"Whether the upstream HTTP status is 2xx; not settlement proof."},"body":{"description":"Unmodified upstream JSON, or bounded response text. Consult that capability's live schema."},"error":{"type":"string"},"charged":{"const":false,"description":"Present on local/transport failures; these do not establish an upstream charge."},"message":{"type":"string"},"auto_spent":{"const":false},"status_code":{"type":["integer","null"],"maximum":599,"minimum":100,"description":"Observed upstream HTTP status, or null when no response was obtained."},"substituted":{"const":false},"content_type":{"type":"string"},"payment_required":{"type":"string","description":"Observed PAYMENT-REQUIRED header; a challenge does not prove payment."},"payment_response":{"type":"string","description":"Observed PAYMENT-RESPONSE header. Assess it together with accepted delivery."},"caller_supplied_authorization":{"type":"boolean"}},"description":"Canonical REST response envelope, or a local/transport rejection. Upstream data remains in body and is defined by the live capability schema.","additionalProperties":true},"annotations":{"title":"Aftersearch Resolve","readOnlyHint":false,"openWorldHint":true,"idempotentHint":false,"destructiveHint":false},"source":"probe","observed_at":"2026-10-20T01:21:56.006Z"},{"name":"aftersearch_verify_serp","title":"Aftersearch Verify Serp","description":"Verify pasted SERP or AI-answer text, or one caller-provided public URL, against retrieved sources. Use this when an agent needs a confirm, contradict, or missing verdict with cited sources before quoting or paying for evidence. Returns the verdict plus sources with URLs, retrieval timestamps, and content hashes; on unreachable sources returns a structured error (source_unavailable) instead of a verdict. Creates one immutable job record per call (a side effect); may fetch the single caller-provided URL and never spends. For example, paste an AI answer claiming a token launch date to check it against live sources.","input_schema":{"type":"object","required":["serp_text_or_url"],"properties":{"serp_text_or_url":{"type":"string","maxLength":60000,"minLength":1,"description":"Pasted SERP/AI text or one public URL to verify (1-60000 chars). No Google scraping is performed; only caller-supplied text or the single provided URL is used."}},"additionalProperties":false},"output_schema":{"type":"object","anyOf":[{"required":["ok","status_code"]},{"required":["error"]}],"properties":{"ok":{"type":"boolean","description":"Whether the upstream HTTP status is 2xx; not settlement proof."},"body":{"description":"Unmodified upstream JSON, or bounded response text. Consult that capability's live schema."},"error":{"type":"string"},"charged":{"const":false,"description":"Present on local/transport failures; these do not establish an upstream charge."},"message":{"type":"string"},"auto_spent":{"const":false},"status_code":{"type":["integer","null"],"maximum":599,"minimum":100,"description":"Observed upstream HTTP status, or null when no response was obtained."},"substituted":{"const":false},"content_type":{"type":"string"},"payment_required":{"type":"string","description":"Observed PAYMENT-REQUIRED header; a challenge does not prove payment."},"payment_response":{"type":"string","description":"Observed PAYMENT-RESPONSE header. Assess it together with accepted delivery."},"caller_supplied_authorization":{"type":"boolean"}},"description":"Canonical REST response envelope, or a local/transport rejection. Upstream data remains in body and is defined by the live capability schema.","additionalProperties":true},"annotations":{"title":"Aftersearch Verify Serp","readOnlyHint":false,"openWorldHint":true,"idempotentHint":false,"destructiveHint":false},"source":"probe","observed_at":"2026-10-20T01:21:56.006Z"},{"name":"agent_web_access","title":"Agent Web Access","description":"Fetch LLM-ready Markdown from any public HTTPS URL through the SML Clean Web Reader. Use this when an agent needs a web page's content as compact Markdown, for example to ground a research answer, without a separate SML account or API key. Returns the converted Markdown up to max_chars. An unsigned call returns the live x402 PAYMENT-REQUIRED challenge and never auto-spends; retry only with a challenge-specific payment_signature. Unsigned calls are read-only and idempotent with no side effects; a supplied signature authorizes one paid, irreversible x402 settlement in USDC on Base. On error, returns a structured error. For example, fetch a documentation page before summarizing it.","input_schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","maxLength":4096,"minLength":8,"description":"Public HTTPS URL to read."},"max_chars":{"type":"integer","default":12000,"maximum":50000,"minimum":1000,"description":"Maximum Markdown characters to return, 1000-50000. Default 12000."},"payment_signature":{"type":"string","maxLength":65536,"minLength":1,"description":"Canonical x402 v2 PAYMENT-SIGNATURE bound to this exact Agent Web Access challenge."}},"additionalProperties":false},"output_schema":{"type":"object","anyOf":[{"required":["ok","status_code"]},{"required":["error"]}],"properties":{"ok":{"type":"boolean","description":"Whether the upstream HTTP status is 2xx; not settlement proof."},"body":{"description":"Unmodified upstream JSON, or bounded response text. Consult that capability's live schema."},"error":{"type":"string"},"charged":{"const":false,"description":"Present on local/transport failures; these do not establish an upstream charge."},"message":{"type":"string"},"auto_spent":{"const":false},"status_code":{"type":["integer","null"],"maximum":599,"minimum":100,"description":"Observed upstream HTTP status, or null when no response was obtained."},"substituted":{"const":false},"content_type":{"type":"string"},"payment_required":{"type":"string","description":"Observed PAYMENT-REQUIRED header; a challenge does not prove payment."},"payment_response":{"type":"string","description":"Observed PAYMENT-RESPONSE header. Assess it together with accepted delivery."},"caller_supplied_authorization":{"type":"boolean"}},"description":"Canonical REST response envelope, or a local/transport rejection. Upstream data remains in body and is defined by the live capability schema.","additionalProperties":true},"annotations":{"title":"Agent Web Access","readOnlyHint":false,"openWorldHint":true,"idempotentHint":false,"destructiveHint":false},"source":"probe","observed_at":"2026-10-20T01:21:56.006Z"},{"name":"capability_manifest","title":"Capability Manifest","description":"Read the canonical machine capability manifest generated from the live Flask route table. Use this when an agent needs the authoritative full inventory of SqueezeOS products, schemas, and payment metadata in one document instead of querying tools one by one. Returns the manifest JSON; this is the canonical product-inventory authority for MCP discovery. Read-only and idempotent; no side effects. On error, returns a structured error. For example, fetch it once at session start to cache the product catalog.","input_schema":{"type":"object","properties":{},"additionalProperties":false},"output_schema":{"type":"object","anyOf":[{"required":["ok","status_code"]},{"required":["error"]}],"properties":{"ok":{"type":"boolean","description":"Whether the upstream HTTP status is 2xx; not settlement proof."},"body":{"description":"Unmodified upstream JSON, or bounded response text. Consult that capability's live schema."},"error":{"type":"string"},"charged":{"const":false,"description":"Present on local/transport failures; these do not establish an upstream charge."},"message":{"type":"string"},"auto_spent":{"const":false},"status_code":{"type":["integer","null"],"maximum":599,"minimum":100,"description":"Observed upstream HTTP status, or null when no response was obtained."},"substituted":{"const":false},"content_type":{"type":"string"},"payment_required":{"type":"string","description":"Observed PAYMENT-REQUIRED header; a challenge does not prove payment."},"payment_response":{"type":"string","description":"Observed PAYMENT-RESPONSE header. Assess it together with accepted delivery."},"caller_supplied_authorization":{"type":"boolean"}},"description":"Canonical REST response envelope, or a local/transport rejection. Upstream data remains in body and is defined by the live capability schema.","additionalProperties":true},"annotations":{"title":"Capability Manifest","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-20T01:21:56.006Z"},{"name":"commit_discover_effects","title":"Commit Discover Effects","description":"List the SML Commit effect atlas: every registered action, target system, owner, and cap a commit check can authorize. Use this when an agent needs to quote or validate a commit check and must cite the exact registered effect terms. Returns the live atlas. Read-only and idempotent; no side effects. This tool never calls the paid check itself (POST /v1/commit, $0.001 USDC). On error, returns a structured error. For example, list effects before asking whether a cron change is committable.","input_schema":{"type":"object","properties":{},"additionalProperties":false},"output_schema":{"type":"object","anyOf":[{"required":["ok","status_code"]},{"required":["error"]}],"properties":{"ok":{"type":"boolean","description":"Whether the upstream HTTP status is 2xx; not settlement proof."},"body":{"description":"Unmodified upstream JSON, or bounded response text. Consult that capability's live schema."},"error":{"type":"string"},"charged":{"const":false,"description":"Present on local/transport failures; these do not establish an upstream charge."},"message":{"type":"string"},"auto_spent":{"const":false},"status_code":{"type":["integer","null"],"maximum":599,"minimum":100,"description":"Observed upstream HTTP status, or null when no response was obtained."},"substituted":{"const":false},"content_type":{"type":"string"},"payment_required":{"type":"string","description":"Observed PAYMENT-REQUIRED header; a challenge does not prove payment."},"payment_response":{"type":"string","description":"Observed PAYMENT-RESPONSE header. Assess it together with accepted delivery."},"caller_supplied_authorization":{"type":"boolean"}},"description":"Canonical REST response envelope, or a local/transport rejection. Upstream data remains in body and is defined by the live capability schema.","additionalProperties":true},"annotations":{"title":"Commit Discover Effects","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-20T01:21:56.006Z"},{"name":"commit_read_terms","title":"Commit Read Terms","description":"Read the live SML Commit terms: price, decision outcomes, and rules. Use this when an agent needs the exact commit-check terms to quote to a caller before any payment. Returns the terms document. Read-only and idempotent; no side effects. On error, returns a structured error. For example, read terms to confirm the $0.001 USDC price before quoting a commit check.","input_schema":{"type":"object","properties":{},"additionalProperties":false},"output_schema":{"type":"object","anyOf":[{"required":["ok","status_code"]},{"required":["error"]}],"properties":{"ok":{"type":"boolean","description":"Whether the upstream HTTP status is 2xx; not settlement proof."},"body":{"description":"Unmodified upstream JSON, or bounded response text. Consult that capability's live schema."},"error":{"type":"string"},"charged":{"const":false,"description":"Present on local/transport failures; these do not establish an upstream charge."},"message":{"type":"string"},"auto_spent":{"const":false},"status_code":{"type":["integer","null"],"maximum":599,"minimum":100,"description":"Observed upstream HTTP status, or null when no response was obtained."},"substituted":{"const":false},"content_type":{"type":"string"},"payment_required":{"type":"string","description":"Observed PAYMENT-REQUIRED header; a challenge does not prove payment."},"payment_response":{"type":"string","description":"Observed PAYMENT-RESPONSE header. Assess it together with accepted delivery."},"caller_supplied_authorization":{"type":"boolean"}},"description":"Canonical REST response envelope, or a local/transport rejection. Upstream data remains in body and is defined by the live capability schema.","additionalProperties":true},"annotations":{"title":"Commit Read Terms","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-20T01:21:56.006Z"},{"name":"compare_capabilities","title":"Compare Capabilities","description":"Compare 2-5 live SqueezeOS capabilities side by side using real metadata. Use this when an agent must choose between similar APIs, for example weighing price against coverage. Returns the same real endpoint and payment fields inspect_capability returns for each candidate; no fabricated composite score is produced. Read-only and idempotent; no side effects. On error, returns a structured error. For example, compare two web-reader capabilities before routing a research task.","input_schema":{"type":"object","required":["sml_ids"],"properties":{"probe":{"type":"boolean","default":true,"description":"When true, performs a real liveness probe of each capability. Default true."},"sml_ids":{"type":"array","items":{"type":"string","maxLength":500,"minLength":1},"maxItems":5,"minItems":2,"description":"Array of 2-5 sml_id values to compare."}},"additionalProperties":false},"output_schema":{"type":"object","anyOf":[{"required":["ok","status_code"]},{"required":["error"]}],"properties":{"ok":{"type":"boolean","description":"Whether the upstream HTTP status is 2xx; not settlement proof."},"body":{"description":"Unmodified upstream JSON, or bounded response text. Consult that capability's live schema."},"error":{"type":"string"},"charged":{"const":false,"description":"Present on local/transport failures; these do not establish an upstream charge."},"message":{"type":"string"},"auto_spent":{"const":false},"status_code":{"type":["integer","null"],"maximum":599,"minimum":100,"description":"Observed upstream HTTP status, or null when no response was obtained."},"substituted":{"const":false},"content_type":{"type":"string"},"payment_required":{"type":"string","description":"Observed PAYMENT-REQUIRED header; a challenge does not prove payment."},"payment_response":{"type":"string","description":"Observed PAYMENT-RESPONSE header. Assess it together with accepted delivery."},"caller_supplied_authorization":{"type":"boolean"}},"description":"Canonical REST response envelope, or a local/transport rejection. Upstream data remains in body and is defined by the live capability schema.","additionalProperties":true},"annotations":{"title":"Compare Capabilities","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-20T01:21:56.006Z"},{"name":"discover_capabilities","title":"Discover Capabilities","description":"Search the live SqueezeOS capability inventory by keyword. Use this when an agent needs to find which SML APIs exist for a task before calling anything. Returns a ranked list of matching capabilities with endpoint and payment metadata; lexical mode is always available and unified mode may add evidence-backed semantic context without fabricating scores. Read-only and idempotent; no side effects. On error, returns a structured error instead of results. For example, query 'stock quotes' to discover the quote endpoints and their x402 prices.","input_schema":{"type":"object","required":["query"],"properties":{"mode":{"enum":["lexical","unified"],"type":"string","default":"lexical","description":"'lexical' for keyword search (always available) or 'unified' to add evidence-backed semantic context. Default 'lexical'."},"limit":{"type":"integer","default":10,"maximum":50,"minimum":1,"description":"Max results to return, 1-50. Default 10."},"query":{"type":"string","maxLength":500,"minLength":1,"description":"Natural-language search text, 1-500 characters."}},"additionalProperties":false},"output_schema":{"type":"object","anyOf":[{"required":["ok","status_code"]},{"required":["error"]}],"properties":{"ok":{"type":"boolean","description":"Whether the upstream HTTP status is 2xx; not settlement proof."},"body":{"description":"Unmodified upstream JSON, or bounded response text. Consult that capability's live schema."},"error":{"type":"string"},"charged":{"const":false,"description":"Present on local/transport failures; these do not establish an upstream charge."},"message":{"type":"string"},"auto_spent":{"const":false},"status_code":{"type":["integer","null"],"maximum":599,"minimum":100,"description":"Observed upstream HTTP status, or null when no response was obtained."},"substituted":{"const":false},"content_type":{"type":"string"},"payment_required":{"type":"string","description":"Observed PAYMENT-REQUIRED header; a challenge does not prove payment."},"payment_response":{"type":"string","description":"Observed PAYMENT-RESPONSE header. Assess it together with accepted delivery."},"caller_supplied_authorization":{"type":"boolean"}},"description":"Canonical REST response envelope, or a local/transport rejection. Upstream data remains in body and is defined by the live capability schema.","additionalProperties":true},"annotations":{"title":"Discover Capabilities","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-20T01:21:56.006Z"},{"name":"execute_capability","title":"Execute Capability","description":"Execute one public SqueezeOS REST path with POST after confirm_write=true. Returns the target result or its x402 challenge. A caller-signed payment_signature may authorize the published SML service fee; the server does not sign wallets. May create records or settle an authorized fee. Operator routes and off-host URLs are denied. API schemas: https://squeezeos-api.onrender.com/.well-known/openapi.json.","input_schema":{"type":"object","required":["path","confirm_write"],"properties":{"body":{"type":["object","array","string","number","boolean","null"],"description":"Optional request body for POST: object, array, string, number, boolean, or null."},"path":{"type":"string","maxLength":1000,"minLength":1,"description":"Concrete SqueezeOS path beginning with /; do not pass a full URL."},"query":{"type":"object","description":"Optional object of URL query parameters.","additionalProperties":true},"confirm_write":{"type":"boolean","const":true,"description":"Explicitly authorize this POST operation."},"payment_signature":{"type":"string","maxLength":65536,"minLength":1,"description":"Canonical x402 v2 PAYMENT-SIGNATURE value bound to this exact target-resource challenge."},"alternative_intent":{"type":"string","maxLength":500,"minLength":1,"description":"Optional natural-language intent used to rank the closest SML alternative after an unsigned HTTP 402."}},"additionalProperties":false},"output_schema":{"type":"object","anyOf":[{"required":["ok","status_code"]},{"required":["error"]}],"properties":{"ok":{"type":"boolean","description":"Whether the upstream HTTP status is 2xx; not settlement proof."},"body":{"description":"Unmodified upstream JSON, or bounded response text. Consult that capability's live schema."},"error":{"type":"string"},"charged":{"const":false,"description":"Present on local/transport failures; these do not establish an upstream charge."},"message":{"type":"string"},"auto_spent":{"const":false},"status_code":{"type":["integer","null"],"maximum":599,"minimum":100,"description":"Observed upstream HTTP status, or null when no response was obtained."},"substituted":{"const":false},"content_type":{"type":"string"},"payment_required":{"type":"string","description":"Observed PAYMENT-REQUIRED header; a challenge does not prove payment."},"payment_response":{"type":"string","description":"Observed PAYMENT-RESPONSE header. Assess it together with accepted delivery."},"caller_supplied_authorization":{"type":"boolean"}},"description":"Canonical REST response envelope, or a local/transport rejection. Upstream data remains in body and is defined by the live capability schema.","additionalProperties":true},"annotations":{"title":"Execute Capability","readOnlyHint":false,"openWorldHint":true,"idempotentHint":false,"destructiveHint":true},"source":"probe","observed_at":"2026-10-20T01:21:56.006Z"},{"name":"gamma_sonar","title":"Gamma Sonar","description":"Get the dealer gamma-exposure (GEX) and pin-risk map for one US ticker from live Tradier option chains: long/short gamma regime, zero-gamma flip line, call and put walls, max open-interest pin strike, and the full per-strike GEX ladder. Use this when an agent needs to know where options dealers are forced to hedge, for example before judging whether a move is likely to be dampened or amplified. An unsigned call returns the live x402 PAYMENT-REQUIRED challenge (USDC on Base; the challenge states the exact price) and never auto-spends; retry only with a challenge-specific payment_signature. If no chain, spot price, or open interest exists, it returns an honest not-available result and nothing is charged. A supplied signature authorizes one paid, irreversible x402 settlement. Informational market structure, not investment advice. For example, check SPY's zero-gamma line before the open.","input_schema":{"type":"object","required":["symbol"],"properties":{"symbol":{"type":"string","pattern":"^[A-Za-z0-9.]{1,10}$","description":"US equity or ETF ticker, e.g. SPY, GME, NVDA."},"payment_signature":{"type":"string","maxLength":65536,"minLength":1,"description":"Canonical x402 v2 PAYMENT-SIGNATURE bound to this exact challenge."}},"additionalProperties":false},"output_schema":{"type":"object","anyOf":[{"required":["ok","status_code"]},{"required":["error"]}],"properties":{"ok":{"type":"boolean","description":"Whether the upstream HTTP status is 2xx; not settlement proof."},"body":{"description":"Unmodified upstream JSON, or bounded response text. Consult that capability's live schema."},"error":{"type":"string"},"charged":{"const":false,"description":"Present on local/transport failures; these do not establish an upstream charge."},"message":{"type":"string"},"auto_spent":{"const":false},"status_code":{"type":["integer","null"],"maximum":599,"minimum":100,"description":"Observed upstream HTTP status, or null when no response was obtained."},"substituted":{"const":false},"content_type":{"type":"string"},"payment_required":{"type":"string","description":"Observed PAYMENT-REQUIRED header; a challenge does not prove payment."},"payment_response":{"type":"string","description":"Observed PAYMENT-RESPONSE header. Assess it together with accepted delivery."},"caller_supplied_authorization":{"type":"boolean"}},"description":"Canonical REST response envelope, or a local/transport rejection. Upstream data remains in body and is defined by the live capability schema.","additionalProperties":true},"annotations":{"title":"Gamma Sonar","readOnlyHint":false,"openWorldHint":true,"idempotentHint":false,"destructiveHint":false},"source":"probe","observed_at":"2026-10-20T01:21:56.006Z"},{"name":"inspect_capability","title":"Inspect Capability","description":"Inspect one live SqueezeOS capability by its sml_id. Use this when an agent has a candidate capability and needs its exact endpoint, parameters, and x402 payment terms before calling. Returns real endpoint and payment metadata plus, when safe, a real liveness probe rather than an invented reliability score. Read-only and idempotent; no side effects. On error, returns a structured error. For example, inspect 'url-to-markdown' to confirm its price and required payment-signature header.","input_schema":{"type":"object","required":["sml_id"],"properties":{"probe":{"type":"boolean","default":true,"description":"When true, performs a real liveness probe of the capability. Default true."},"sml_id":{"type":"string","maxLength":500,"minLength":1,"description":"The capability's sml_id from discovery, 1-500 characters."}},"additionalProperties":false},"output_schema":{"type":"object","anyOf":[{"required":["ok","status_code"]},{"required":["error"]}],"properties":{"ok":{"type":"boolean","description":"Whether the upstream HTTP status is 2xx; not settlement proof."},"body":{"description":"Unmodified upstream JSON, or bounded response text. Consult that capability's live schema."},"error":{"type":"string"},"charged":{"const":false,"description":"Present on local/transport failures; these do not establish an upstream charge."},"message":{"type":"string"},"auto_spent":{"const":false},"status_code":{"type":["integer","null"],"maximum":599,"minimum":100,"description":"Observed upstream HTTP status, or null when no response was obtained."},"substituted":{"const":false},"content_type":{"type":"string"},"payment_required":{"type":"string","description":"Observed PAYMENT-REQUIRED header; a challenge does not prove payment."},"payment_response":{"type":"string","description":"Observed PAYMENT-RESPONSE header. Assess it together with accepted delivery."},"caller_supplied_authorization":{"type":"boolean"}},"description":"Canonical REST response envelope, or a local/transport rejection. Upstream data remains in body and is defined by the live capability schema.","additionalProperties":true},"annotations":{"title":"Inspect Capability","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-20T01:21:56.006Z"},{"name":"list_playbooks","title":"List Playbooks","description":"Filter the public ScriptMasterLabs Google Play book catalog for the job a reader is working on, for example 'x402 payments' or 'options trading'. Returns up to 10 matching titles with each book's GGKEY, Google Play URL, and Google Play list price. Free, read-only and idempotent; no side effects. Prices are Google's list prices from the 2026-10-09 catalog export - not a quote you can pay here. This tool does not sell the book, does not return the PDF, and will not accept USDC for it. If the human wants the file, give them the google_play_url. For example, list playbooks for 'MCP server security' and hand the human the Play URLs.","input_schema":{"type":"object","required":["job"],"properties":{"job":{"type":"string","maxLength":500,"minLength":1,"description":"What the reader is working on, 1-500 characters, e.g. 'x402 payments'."},"limit":{"type":"integer","default":10,"maximum":10,"minimum":1,"description":"Max titles to return, 1-10. Default 10."}},"additionalProperties":false},"output_schema":{"type":"object","anyOf":[{"required":["ok","status_code"]},{"required":["error"]}],"properties":{"ok":{"type":"boolean","description":"Whether the upstream HTTP status is 2xx; not settlement proof."},"body":{"description":"Unmodified upstream JSON, or bounded response text. Consult that capability's live schema."},"error":{"type":"string"},"charged":{"const":false,"description":"Present on local/transport failures; these do not establish an upstream charge."},"message":{"type":"string"},"auto_spent":{"const":false},"status_code":{"type":["integer","null"],"maximum":599,"minimum":100,"description":"Observed upstream HTTP status, or null when no response was obtained."},"substituted":{"const":false},"content_type":{"type":"string"},"payment_required":{"type":"string","description":"Observed PAYMENT-REQUIRED header; a challenge does not prove payment."},"payment_response":{"type":"string","description":"Observed PAYMENT-RESPONSE header. Assess it together with accepted delivery."},"caller_supplied_authorization":{"type":"boolean"}},"description":"Canonical REST response envelope, or a local/transport rejection. Upstream data remains in body and is defined by the live capability schema.","additionalProperties":true},"annotations":{"title":"List Playbooks","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-20T01:21:56.006Z"},{"name":"purchase_capability_read","title":"Purchase Capability Read","description":"Retrieve one paid SqueezeOS REST path with GET using caller-signed authorization for that exact resource's fresh x402 challenge. May settle an irreversible published SML service fee; returns delivery and payment-response evidence. Cannot change the HTTP method or send a request body. The server never creates wallet signatures. Operator routes and off-host URLs are denied. API schemas: https://squeezeos-api.onrender.com/.well-known/openapi.json.","input_schema":{"type":"object","required":["path","payment_signature"],"properties":{"path":{"type":"string","maxLength":1000,"minLength":1,"description":"Concrete SqueezeOS path beginning with /; do not pass a full URL."},"query":{"type":"object","description":"Optional object of URL query parameters.","additionalProperties":true},"payment_signature":{"type":"string","maxLength":65536,"minLength":1,"description":"Canonical x402 v2 PAYMENT-SIGNATURE value bound to this exact target-resource challenge."},"alternative_intent":{"type":"string","maxLength":500,"minLength":1,"description":"Optional natural-language intent used to rank the closest SML alternative after an unsigned HTTP 402."}},"additionalProperties":false},"output_schema":{"type":"object","anyOf":[{"required":["ok","status_code"]},{"required":["error"]}],"properties":{"ok":{"type":"boolean","description":"Whether the upstream HTTP status is 2xx; not settlement proof."},"body":{"description":"Unmodified upstream JSON, or bounded response text. Consult that capability's live schema."},"error":{"type":"string"},"charged":{"const":false,"description":"Present on local/transport failures; these do not establish an upstream charge."},"message":{"type":"string"},"auto_spent":{"const":false},"status_code":{"type":["integer","null"],"maximum":599,"minimum":100,"description":"Observed upstream HTTP status, or null when no response was obtained."},"substituted":{"const":false},"content_type":{"type":"string"},"payment_required":{"type":"string","description":"Observed PAYMENT-REQUIRED header; a challenge does not prove payment."},"payment_response":{"type":"string","description":"Observed PAYMENT-RESPONSE header. Assess it together with accepted delivery."},"caller_supplied_authorization":{"type":"boolean"}},"description":"Canonical REST response envelope, or a local/transport rejection. Upstream data remains in body and is defined by the live capability schema.","additionalProperties":true},"annotations":{"title":"Purchase Capability Read","readOnlyHint":false,"openWorldHint":true,"idempotentHint":false,"destructiveHint":true},"source":"probe","observed_at":"2026-10-20T01:21:56.006Z"},{"name":"read_capability","title":"Read Capability","description":"Read one public SqueezeOS REST path with GET. Cannot accept payment authorization, a request body, or another HTTP method. Returns data or the unchanged unpaid x402 challenge with no-spend alternatives. Never signs or settles a payment. Operator routes and off-host URLs are denied. API schemas: https://squeezeos-api.onrender.com/.well-known/openapi.json.","input_schema":{"type":"object","required":["path"],"properties":{"path":{"type":"string","maxLength":1000,"minLength":1,"description":"Concrete SqueezeOS path beginning with /; do not pass a full URL."},"query":{"type":"object","description":"Optional object of URL query parameters.","additionalProperties":true},"alternative_intent":{"type":"string","maxLength":500,"minLength":1,"description":"Optional natural-language intent used to rank the closest SML alternative after an unsigned HTTP 402."}},"additionalProperties":false},"output_schema":{"type":"object","anyOf":[{"required":["ok","status_code"]},{"required":["error"]}],"properties":{"ok":{"type":"boolean","description":"Whether the upstream HTTP status is 2xx; not settlement proof."},"body":{"description":"Unmodified upstream JSON, or bounded response text. Consult that capability's live schema."},"error":{"type":"string"},"charged":{"const":false,"description":"Present on local/transport failures; these do not establish an upstream charge."},"message":{"type":"string"},"auto_spent":{"const":false},"status_code":{"type":["integer","null"],"maximum":599,"minimum":100,"description":"Observed upstream HTTP status, or null when no response was obtained."},"substituted":{"const":false},"content_type":{"type":"string"},"payment_required":{"type":"string","description":"Observed PAYMENT-REQUIRED header; a challenge does not prove payment."},"payment_response":{"type":"string","description":"Observed PAYMENT-RESPONSE header. Assess it together with accepted delivery."},"caller_supplied_authorization":{"type":"boolean"}},"description":"Canonical REST response envelope, or a local/transport rejection. Upstream data remains in body and is defined by the live capability schema.","additionalProperties":true},"annotations":{"title":"Read Capability","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-20T01:21:56.006Z"},{"name":"recommend_capability","title":"Recommend Capability","description":"Return the best-matching SqueezeOS capabilities for a natural-language need. Call this when an agent knows the goal, for example 'convert a URL to Markdown', but not which SML API serves it. Returns ranked capabilities with live endpoint and x402 payment metadata plus suggested next actions. Read-only and idempotent; no side effects. On error, returns a structured error. For example, ask 'which API verifies a fact' to get the fact-verification endpoint and its price.","input_schema":{"type":"object","required":["query"],"properties":{"limit":{"type":"integer","default":5,"maximum":20,"minimum":1,"description":"Max recommendations to return, 1-20. Default 5."},"query":{"type":"string","maxLength":500,"minLength":1,"description":"Natural-language description of what the agent needs, 1-500 characters."}},"additionalProperties":false},"output_schema":{"type":"object","anyOf":[{"required":["ok","status_code"]},{"required":["error"]}],"properties":{"ok":{"type":"boolean","description":"Whether the upstream HTTP status is 2xx; not settlement proof."},"body":{"description":"Unmodified upstream JSON, or bounded response text. Consult that capability's live schema."},"error":{"type":"string"},"charged":{"const":false,"description":"Present on local/transport failures; these do not establish an upstream charge."},"message":{"type":"string"},"auto_spent":{"const":false},"status_code":{"type":["integer","null"],"maximum":599,"minimum":100,"description":"Observed upstream HTTP status, or null when no response was obtained."},"substituted":{"const":false},"content_type":{"type":"string"},"payment_required":{"type":"string","description":"Observed PAYMENT-REQUIRED header; a challenge does not prove payment."},"payment_response":{"type":"string","description":"Observed PAYMENT-RESPONSE header. Assess it together with accepted delivery."},"caller_supplied_authorization":{"type":"boolean"}},"description":"Canonical REST response envelope, or a local/transport rejection. Upstream data remains in body and is defined by the live capability schema.","additionalProperties":true},"annotations":{"title":"Recommend Capability","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-20T01:21:56.006Z"},{"name":"system_status","title":"System Status","description":"Read the live SqueezeOS status endpoint. Use this when an agent needs a quick health check of the API host before starting paid work. Returns the live status payload; the MCP server never synthesizes cluster-health or synchronization claims. Read-only and idempotent; no side effects. On error, returns a structured error. For example, check status first if paid calls start timing out.","input_schema":{"type":"object","properties":{},"additionalProperties":false},"output_schema":{"type":"object","anyOf":[{"required":["ok","status_code"]},{"required":["error"]}],"properties":{"ok":{"type":"boolean","description":"Whether the upstream HTTP status is 2xx; not settlement proof."},"body":{"description":"Unmodified upstream JSON, or bounded response text. Consult that capability's live schema."},"error":{"type":"string"},"charged":{"const":false,"description":"Present on local/transport failures; these do not establish an upstream charge."},"message":{"type":"string"},"auto_spent":{"const":false},"status_code":{"type":["integer","null"],"maximum":599,"minimum":100,"description":"Observed upstream HTTP status, or null when no response was obtained."},"substituted":{"const":false},"content_type":{"type":"string"},"payment_required":{"type":"string","description":"Observed PAYMENT-REQUIRED header; a challenge does not prove payment."},"payment_response":{"type":"string","description":"Observed PAYMENT-RESPONSE header. Assess it together with accepted delivery."},"caller_supplied_authorization":{"type":"boolean"}},"description":"Canonical REST response envelope, or a local/transport rejection. Upstream data remains in body and is defined by the live capability schema.","additionalProperties":true},"annotations":{"title":"System Status","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-20T01:21:56.006Z"},{"name":"ticker_dossier","title":"Ticker Dossier","description":"Get a one-call intelligence profile for one US ticker: live quote, dealer gamma regime/walls/pin, unusual options flow, squeeze score, SEC fails-to-deliver plus Reg SHO threshold-list status, and the Oracle directive. Use this when an agent needs a full picture of a stock in a single paid call instead of stitching several sources together. Sections that are unavailable are labeled with a reason, never filled in, and a coverage field lists which are live. An unsigned call returns the live x402 PAYMENT-REQUIRED challenge (USDC on Base; the challenge states the exact price) and never auto-spends; retry only with a challenge-specific payment_signature. Without a live price it returns an honest not-available result and nothing is charged. A supplied signature authorizes one paid, irreversible x402 settlement. Not investment advice. For example, profile GME before writing a research note.","input_schema":{"type":"object","required":["symbol"],"properties":{"symbol":{"type":"string","pattern":"^[A-Za-z0-9.]{1,10}$","description":"US equity or ETF ticker, e.g. SPY, GME, NVDA."},"payment_signature":{"type":"string","maxLength":65536,"minLength":1,"description":"Canonical x402 v2 PAYMENT-SIGNATURE bound to this exact challenge."}},"additionalProperties":false},"output_schema":{"type":"object","anyOf":[{"required":["ok","status_code"]},{"required":["error"]}],"properties":{"ok":{"type":"boolean","description":"Whether the upstream HTTP status is 2xx; not settlement proof."},"body":{"description":"Unmodified upstream JSON, or bounded response text. Consult that capability's live schema."},"error":{"type":"string"},"charged":{"const":false,"description":"Present on local/transport failures; these do not establish an upstream charge."},"message":{"type":"string"},"auto_spent":{"const":false},"status_code":{"type":["integer","null"],"maximum":599,"minimum":100,"description":"Observed upstream HTTP status, or null when no response was obtained."},"substituted":{"const":false},"content_type":{"type":"string"},"payment_required":{"type":"string","description":"Observed PAYMENT-REQUIRED header; a challenge does not prove payment."},"payment_response":{"type":"string","description":"Observed PAYMENT-RESPONSE header. Assess it together with accepted delivery."},"caller_supplied_authorization":{"type":"boolean"}},"description":"Canonical REST response envelope, or a local/transport rejection. Upstream data remains in body and is defined by the live capability schema.","additionalProperties":true},"annotations":{"title":"Ticker Dossier","readOnlyHint":false,"openWorldHint":true,"idempotentHint":false,"destructiveHint":false},"source":"probe","observed_at":"2026-10-20T01:21:56.006Z"},{"name":"x402_contract","title":"X402 Contract","description":"Read the canonical SqueezeOS x402 v2 discovery contract. Use this when an agent needs the payment protocol's rules, for example challenge and response header names, before attempting any paid call. Returns the contract document; exact spend terms remain authoritative only in the target resource's fresh PAYMENT-REQUIRED challenge. Read-only and idempotent; no side effects. On error, returns a structured error. For example, read it once per session to learn the PAYMENT-SIGNATURE header name.","input_schema":{"type":"object","properties":{},"additionalProperties":false},"output_schema":{"type":"object","anyOf":[{"required":["ok","status_code"]},{"required":["error"]}],"properties":{"ok":{"type":"boolean","description":"Whether the upstream HTTP status is 2xx; not settlement proof."},"body":{"description":"Unmodified upstream JSON, or bounded response text. Consult that capability's live schema."},"error":{"type":"string"},"charged":{"const":false,"description":"Present on local/transport failures; these do not establish an upstream charge."},"message":{"type":"string"},"auto_spent":{"const":false},"status_code":{"type":["integer","null"],"maximum":599,"minimum":100,"description":"Observed upstream HTTP status, or null when no response was obtained."},"substituted":{"const":false},"content_type":{"type":"string"},"payment_required":{"type":"string","description":"Observed PAYMENT-REQUIRED header; a challenge does not prove payment."},"payment_response":{"type":"string","description":"Observed PAYMENT-RESPONSE header. Assess it together with accepted delivery."},"caller_supplied_authorization":{"type":"boolean"}},"description":"Canonical REST response envelope, or a local/transport rejection. Upstream data remains in body and is defined by the live capability schema.","additionalProperties":true},"annotations":{"title":"X402 Contract","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-20T01:21:56.006Z"},{"name":"x402_evidence","title":"X402 Evidence","description":"Read real settlement evidence recorded by the canonical x402 rail. Use this when an agent or auditor needs proof that a past payment actually settled in USDC on Base; a challenge or signature alone is never treated as revenue or settlement proof. Returns recorded settlement receipts. Read-only and idempotent; no side effects. On error, returns a structured error. For example, pull evidence for a disputed charge before deciding a refund.","input_schema":{"type":"object","properties":{},"additionalProperties":false},"output_schema":{"type":"object","anyOf":[{"required":["ok","status_code"]},{"required":["error"]}],"properties":{"ok":{"type":"boolean","description":"Whether the upstream HTTP status is 2xx; not settlement proof."},"body":{"description":"Unmodified upstream JSON, or bounded response text. Consult that capability's live schema."},"error":{"type":"string"},"charged":{"const":false,"description":"Present on local/transport failures; these do not establish an upstream charge."},"message":{"type":"string"},"auto_spent":{"const":false},"status_code":{"type":["integer","null"],"maximum":599,"minimum":100,"description":"Observed upstream HTTP status, or null when no response was obtained."},"substituted":{"const":false},"content_type":{"type":"string"},"payment_required":{"type":"string","description":"Observed PAYMENT-REQUIRED header; a challenge does not prove payment."},"payment_response":{"type":"string","description":"Observed PAYMENT-RESPONSE header. Assess it together with accepted delivery."},"caller_supplied_authorization":{"type":"boolean"}},"description":"Canonical REST response envelope, or a local/transport rejection. Upstream data remains in body and is defined by the live capability schema.","additionalProperties":true},"annotations":{"title":"X402 Evidence","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-20T01:21:56.006Z"},{"name":"x402_readiness","title":"X402 Readiness","description":"Check the live x402 payment-rail readiness surface. Call this when an agent is about to attempt a paid call and wants to confirm the rail is up before building a payment signature. Returns the current readiness status of the canonical SqueezeOS payment rail. Read-only and idempotent; no side effects. On error, returns a structured error. For example, check readiness before a batch of paid URL-to-Markdown calls.","input_schema":{"type":"object","properties":{},"additionalProperties":false},"output_schema":{"type":"object","anyOf":[{"required":["ok","status_code"]},{"required":["error"]}],"properties":{"ok":{"type":"boolean","description":"Whether the upstream HTTP status is 2xx; not settlement proof."},"body":{"description":"Unmodified upstream JSON, or bounded response text. Consult that capability's live schema."},"error":{"type":"string"},"charged":{"const":false,"description":"Present on local/transport failures; these do not establish an upstream charge."},"message":{"type":"string"},"auto_spent":{"const":false},"status_code":{"type":["integer","null"],"maximum":599,"minimum":100,"description":"Observed upstream HTTP status, or null when no response was obtained."},"substituted":{"const":false},"content_type":{"type":"string"},"payment_required":{"type":"string","description":"Observed PAYMENT-REQUIRED header; a challenge does not prove payment."},"payment_response":{"type":"string","description":"Observed PAYMENT-RESPONSE header. Assess it together with accepted delivery."},"caller_supplied_authorization":{"type":"boolean"}},"description":"Canonical REST response envelope, or a local/transport rejection. Upstream data remains in body and is defined by the live capability schema.","additionalProperties":true},"annotations":{"title":"X402 Readiness","readOnlyHint":true,"openWorldHint":true,"idempotentHint":true,"destructiveHint":false},"source":"probe","observed_at":"2026-10-20T01:21:56.006Z"}],"next_cursor":null,"next_actions":[{"action":"get_connection","description":"Connection block to call these tools","href":"/v1/servers/io.github.Timwal78%2Fsqueezeos/connection?target=mcpServers","arguments":{"name":"io.github.Timwal78/squeezeos","target":"mcpServers"}},{"action":"get_server","description":"Full descriptor with trust and connectability","href":"/v1/servers/io.github.Timwal78%2Fsqueezeos","arguments":{"name":"io.github.Timwal78/squeezeos"}}]}