# Straelo Relay

Straelo Relay is STRAELO's paid, machine-discoverable API product for agents.

Discovery:
- OpenAPI: /openapi.json
- x402 resources: /discovery/resources
- x402 manifest: /.well-known/x402
- MCP Streamable HTTP: /mcp/

Products:
- Clean Content: POST /url-clean-content — Extract clean, boilerplate-free readable text from one known public HTTP(S) URL for LLM research or RAG ingestion; private, local, authenticated, paywalled, or blocked resources are not supported.
USE WHEN: agent already knows the URL and needs clean page text.
DO NOT USE WHEN: agent needs web search, multi-page research, comparison, structured web workflow, or change detection.
USE web-intelligence FOR: those broader live-web operations.
- Email Validator BASIC: POST /email-validator/basic — Validate email syntax, domain, and MX records for basic automated checks without SMTP mailbox verification; cannot prove a mailbox exists or can receive mail.
USE WHEN: agent needs inexpensive structural and mail-domain validation before using an email address.
DO NOT USE WHEN: agent requires proof that a mailbox exists or can receive mail.
- Search + Read: POST /search-read — Search the live web and retrieve clean readable content from relevant pages in one paid request.
- Research Answer: POST /research-answer — Answer a question using current web research by synthesizing evidence from multiple sources with cited URLs.
- STRAELO Web Intelligence: POST /web-intelligence — Execute one live-web operation — search, read, extract, evidence, research, compare, or changes — in a single paid request without orchestrating multiple web APIs.
USE WHEN: agent needs a live web search, multi-page read, structured extraction, comparative research, evidence gathering, or web change detection.
DO NOT USE WHEN: agent already has a single known URL and only needs its clean readable text; use url-clean-content instead.
Parameter semantics: supply `intent` plus only that intent's fields; without `intent`, supply legacy `topic` and `objective` together.
- Chain Contract Call: POST /chain-contract-call — Execute one read-only EVM smart contract call on Ethereum or Base and return the normalized result without managing an RPC provider.
USE WHEN: agent needs one read-only smart-contract call on a supported chain.
DO NOT USE WHEN: agent needs broader transaction, address, or contract investigation with evidence and context.
USE blockchain-intelligence FOR: broader deterministic inspection of a transaction, address, or contract.
- Transaction Intelligence: POST /transaction-intelligence — Retrieve a Base or Ethereum transaction and receipt in one paid request, with deterministic execution status, transaction classification, method selector, gas cost, logs count and raw RPC evidence.
- STRAELO Blockchain Intelligence: POST /blockchain-intelligence — Inspect exactly one Base or Ethereum transaction, address, or contract with bounded read-only RPC calls and return deterministic context, observed signals, evidence, coverage, and recommended follow-up.
USE WHEN: agent needs broader deterministic investigation of a transaction hash, EVM address, or contract address.
DO NOT USE WHEN: agent only needs a single read-only smart-contract call; use chain-contract-call instead.
Parameter semantics: `chain` is required; exactly one of `transaction_hash`, `address`, or `contract_address` must be provided.
- Pay Decision Snapshot: POST /pay-decision-snapshot — Compare one supplied x402 v2 exact Base USDC payment requirement against declared intent and return deterministic consistency, mismatch, change, fingerprint, and coverage evidence without executing a payment.
USE WHEN: agent needs deterministic verification of a payment requirement before deciding whether to pay.
DO NOT USE WHEN: agent expects this tool to execute the payment.
Parameter semantics: supply `intent` (seller, service, resource, plus optional expected fields) and `payment_required` (decoded x402 challenge); optional `previous_snapshot` enables stateless material-change detection against a prior result.
- STRAELO DeFi Execution Snapshot: POST /defi-execution-snapshot — Compare read-only Base swap quotes from 1inch and KyberSwap, returning normalized comparable output, consensus, dispersion, quote evidence, and provider limitations without executing a swap.
USE WHEN: agent needs comparative swap-quote intelligence before executing a trade.
DO NOT USE WHEN: agent wants actual swap or transaction execution.
Parameter semantics: `chain` is Base-only; `token_in`/`token_out` are symbols from USDC, USDT, ETH, WETH; `amount_in` is a positive decimal; `slippage_bps` is required (0-10000); optional `baseline_provider` selects oneinch or kyberswap for direct economic comparison.
- Search + Extract: POST /search-extract — Search the live web and extract requested structured fields from relevant pages in one request.
- Search + Evidence: POST /search-evidence — Search multiple live web sources and return structured factual claims with supporting evidence and source URLs.
- STRAELO Domain Intelligence: POST /domain-intelligence — Inspect consolidated domain health — DNS, HTTP, HTTPS, TLS, redirects, MX, SPF, DMARC, email posture, security posture, and agent readiness — returning structured issues, evidence, actions, and stateless changes.
USE WHEN: agent needs a comprehensive single-call domain inspection across DNS, web, email, security, and agent-readiness signals.
DO NOT USE WHEN: agent only needs DNS records; narrower domain/DNS products are not exposed through MCP.
Parameter semantics: `domain` is required; optional `previous_state` enables stateless change detection against a prior `new_state`.
- DNS Intelligence: POST /dns-intelligence — Inspect DNS records, mail configuration, SPF and DMARC for a public domain in one request.
- Domain Health: POST /domain-health — Check public domain DNS, HTTP, HTTPS, redirects, TLS certificate health and response latency in one request.
- Competitor Switch Intelligence: POST /competitor-switch-intelligence — Return existing STRAELO competitor-switch/replacement signals and prioritized leads for supported competitors (yotpo, judge.me); unsupported competitors return UNSUPPORTED_COMPETITOR with charged=false.
USE WHEN: agent needs competitor replacement/switch signals and prioritized leads for yotpo or judge.me.
DO NOT USE WHEN: agent needs confirmed customer domains, vendor ADDED/REMOVED history, or technology detection on one domain.
USE installed-base-intelligence FOR: confirmed customer domains currently known for a technology/vendor.
USE change-intelligence FOR: durable ADDED/REMOVED changes for a vendor within a UTC time window.
USE technology-intelligence FOR: technologies detected on a public domain.
- STRAELO Installed Base Intelligence: POST /installed-base-intelligence — Return confirmed customer domains currently known for a specified technology/vendor; STRAELO-confirmed coverage, not a complete global installed base.
USE WHEN: agent needs confirmed customer domains currently known for a specified technology/vendor.
DO NOT USE WHEN: domain -> technologies; vendor + time -> ADDED/REMOVED; competitor switch/replacement signals.
USE technology-intelligence FOR: technologies detected on a public domain.
USE change-intelligence FOR: durable ADDED/REMOVED changes for a vendor within a UTC time window.
USE competitor-switch-intelligence FOR: competitor switch/replacement signals.
- STRAELO Technology Intelligence: POST /technology-intelligence — Return technologies deterministically detected on one specified public domain; deterministic observations, not an exhaustive proof that no other technology exists.
USE WHEN: agent needs technologies currently detected on one specific public domain.
DO NOT USE WHEN: vendor -> current confirmed customers; vendor + time -> ADDED/REMOVED; competitor replacement/switch signals.
USE installed-base-intelligence FOR: confirmed customer domains using a technology/vendor.
USE change-intelligence FOR: durable ADDED/REMOVED changes for a vendor within a UTC time window.
USE competitor-switch-intelligence FOR: competitor replacement/switch signals.
- STRAELO Change Intelligence: POST /change-intelligence — Return durable historical ADDED (ABSENT -> PRESENT) and REMOVED (PRESENT -> ABSENT) customer-domain changes for a vendor in a UTC time window; REMOVED does not prove contract cancellation and ADDED does not prove commercial purchase.
USE WHEN: agent needs durable historical ADDED/REMOVED customer-domain changes for a vendor in a UTC time window.
DO NOT USE WHEN: current confirmed customer base; technologies on one domain; competitor replacement/switch inference.
USE installed-base-intelligence FOR: confirmed customer domains currently known for a technology/vendor.
USE technology-intelligence FOR: technologies detected on a public domain.
USE competitor-switch-intelligence FOR: competitor replacement/switch signals.