Relying-party endpoint format

Ship endpoints agents can trust.

ToolRouter lists endpoints that behave predictably through AgentKit first, x402 fallback, typed input validation, capped health probes, and traceable payment metadata.

Listing checklist

Providers stay manually onboarded for launch. A listing needs a stable HTTPS POST endpoint, an AgentKit/x402 challenge path, deterministic test input, and a safe live smoke config.

TransportHTTPS POST with JSON request and JSON or text response.

AuthAgentKit and x402 only. Provider API keys must not be required on router execution.

CostExpose a predictable estimated USD cost and accept caller maxUsd caps.

ReliabilityProvide fixture input, an AgentKit-first health probe, and a paid x402 smoke gate.

Value typeClassify the AgentKit value as Free Trial, Discount, or Access.

Endpoint module shape

New endpoints follow the category/provider/endpoint module pattern under router-core. The builder owns input validation and produces the provider request.

export const providerEndpointDefinition = Object.freeze({
  id: "provider.endpoint",
  provider: "provider",
  category: "search",
  name: "Provider Endpoint",
  description: "AgentKit-first x402 endpoint.",
  url: "https://api.provider.com/endpoint",
  method: "POST",
  agentkit: true,
  x402: true,
  estimated_cost_usd: 0.01,
  agentkit_value_type: "free_trial",
  agentkit_value_label: "AgentKit-Free Trial",
  default_payment_mode: "agentkit_first",
  fixture_input: { query: "ToolRouter health check" },
  health_probe: {
    mode: "challenge",
    payment_mode: "agentkit_first",
    max_usd: "0.02",
    input: { query: "ToolRouter health check" }
  },
  live_smoke: {
    default_path: { payment_mode: "agentkit_first", max_usd: "0.02", input: {} },
    paid_path: { payment_mode: "x402_only", max_usd: "0.02", input: {} }
  },
  builder: buildProviderRequest
});

Review path

Send the endpoint URL, input schema, fixture input, price, AgentKit mode, and a short failure-mode note. ToolRouter adds the module, deterministic tests, live smoke gates, and dashboard metadata before listing.

Public launchExa Search and Browserbase verified endpoints

Normal trafficagentkit_first

Paid smokex402_only with explicit opt-in