Agent-readable documentation draft

Docs

This public draft gives agents, LLMs, and developers the stable URLs and integration shape. The live API and MCP tools are the next build phase.

Quickstart

The MCP server will expose service discovery, routing, and audit tools. Until the server is live, clients should read this as the public contract draft.

{
  "mcpServers": {
    "stackbroker": {
      "url": "https://mcp.stackbroker.xyz",
      "transport": "streamable-http"
    }
  }
}

HTTP API draft

Fast lookup and routing only. No long compute. No custody of buyer funds in the MVP.

/discover

Find candidate services by capability, payment rail, price ceiling, latency target, and attestation requirement.

/route

Return the recommended seller endpoint, routing reason, price metadata, provenance, and audit token.

/audit

Query route decisions and verification events by request id, service id, or seller id.

curl "https://api.stackbroker.xyz/discover?capability=web.extract&max_price_usdc=0.01&latency_ms=200"

MCP tools draft

Stackbroker will start with a small tool surface designed for agent procurement.

Draft MCP tool names and purposes
discover_service	Return ranked candidate services for a requested capability.
route_request	Return the recommended seller endpoint and payment/provenance metadata.
get_service	Fetch a service record, verification history, and attestation tier.
submit_verification_result	Record a test result, latency sample, or failure signal.
audit_route	Return route rationale and log references for a prior decision.

x402 posture

Stackbroker is being designed around x402-style agent payments while staying routing-only at launch.

Sellers expose payable endpoints. Stackbroker returns routing metadata, price claims, verification evidence, and payment instructions. Buyers pay sellers directly unless and until a later compliant transaction architecture is approved.

Status

Public uptime and latency reporting will live at https://status.stackbroker.xyz. For now, this page is the canonical public status placeholder.

Current public readiness status
Apex site	Live
Docs	Public draft
Directory	Seed catalog draft
API/MCP	Planned next build phase

Reserved surfaces

app.stackbroker.xyz and admin.stackbroker.xyz are reserved. Admin is intentionally not public.