Compass by 402rates

Free catalogue of versioned synthetic cases: unavailable confirmation, retry credits and attempt limits, and partial results with continuation. No run, wallet or payment.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Free description of a versioned synthetic task, its limits and coverage. Optional case selection; omitted selection describes the original confirmation case. No run, payment or wallet.

{
  "type": "object",
  "properties": {
    "case_id": {
      "type": "string",
      "maxLength": 80,
      "description": "Versioned synthetic case identifier."
    },
    "case_version": {
      "type": "string",
      "maxLength": 16,
      "description": "Optional exact case version. A new run defaults to the current published version; a linked repeat retains its previous version. The resolved version is returned and stored."
    },
    "variant": {
      "type": "string",
      "maxLength": 32,
      "description": "Budget case: budget_first or attempts_first. Linked repeats retain the previous variant."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Create a free bounded synthetic run without an account. An optional finalized previous run and its token link a repeat of the same case version and scenario. No real purchase. Caller model costs remain external.

{
  "type": "object",
  "properties": {
    "case_id": {
      "type": "string",
      "maxLength": 80,
      "description": "Versioned synthetic case identifier."
    },
    "case_version": {
      "type": "string",
      "maxLength": 16,
      "description": "Optional exact case version. A new run defaults to the current published version; a linked repeat retains its previous version. The resolved version is returned and stored."
    },
    "variant": {
      "type": "string",
      "maxLength": 32,
      "description": "Budget case: budget_first or attempts_first. Linked repeats retain the previous variant."
    },
    "previous_run_id": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Optional finalized run to repeat. Its access token authenticates this start."
    },
    "configuration_changed": {
      "type": "boolean",
      "description": "Optional caller-declared change since the previous run; not independently verified."
    },
    "access_token": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{43}$",
      "description": "Secret short-lived run token. Omitted from reports. MCP client history may retain this argument."
    }
  },
  "required": [
    "case_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Execute the selected case's action: synthetic order, retry attempt, page retrieval or result submission. Identical keys and input replay the stored outcome. Calls, effects and simulated credits remain observable. No real payment.

{
  "type": "object",
  "properties": {
    "run_id": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Run identifier from start_agent_test."
    },
    "task_id": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Task identifier bound to this run."
    },
    "action_key": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Caller-generated UUID. Identical key and payload identify the same synthetic operation."
    },
    "quantity": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "Synthetic quantity. The task specifies one unit."
    },
    "action_type": {
      "type": "string",
      "maxLength": 24,
      "description": "Case action: attempt, get_page or submit_result. Not accepted by the original case."
    },
    "cursor": {
      "type": "string",
      "maxLength": 16,
      "description": "Partial-result page cursor: first or second."
    },
    "record_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 64
      },
      "maxItems": 6,
      "description": "Synthetic record identifiers submitted by the caller, at most six."
    },
    "access_token": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{43}$",
      "description": "Secret short-lived run token. Omitted from reports. MCP client history may retain this argument."
    }
  },
  "required": [
    "run_id",
    "task_id",
    "action_key",
    "access_token"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Read operation records for a synthetic task. Observation timestamps and state describe the test service only. No claim about client receipt or overall agent reliability.

{
  "type": "object",
  "properties": {
    "run_id": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Run identifier from start_agent_test."
    },
    "task_id": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Task identifier bound to this run."
    },
    "access_token": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{43}$",
      "description": "Secret short-lived run token. Omitted from reports. MCP client history may retain this argument."
    }
  },
  "required": [
    "run_id",
    "task_id",
    "access_token"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Read calls, timestamps, operations and resulting state. Optional finalization freezes the run. A linked repeat includes the previous frozen report while retained. No score, certification or judgment of the agent.

{
  "type": "object",
  "properties": {
    "run_id": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "Run identifier from start_agent_test."
    },
    "finalize": {
      "type": "boolean",
      "description": "True freezes the run and prevents further actions. Omitted means read only."
    },
    "access_token": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{43}$",
      "description": "Secret short-lived run token. Omitted from reports. MCP client history may retain this argument."
    }
  },
  "required": [
    "run_id",
    "access_token"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Free inspection of supplied x402 v1/v2 payment terms against the SDK schema and optional network, asset, recipient and atomic budget constraints. Exact EVM profile checks only. No wallet connection, external fetch, signature verification or settlement. Other profiles are explicitly untested.

{
  "type": "object",
  "properties": {
    "challenge": {
      "type": "object",
      "additionalProperties": {},
      "description": "Decoded PaymentRequired object from HTTP or MCP structuredContent. No signed payment or credentials."
    },
    "expected": {
      "type": "object",
      "additionalProperties": {},
      "description": "Optional exact terms. An atomic budget requires network and asset."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Free capability and MCP tool catalogue for Compass by 402rates. Contains this product and shared service information only.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Searches the x402 resource catalogue and returns matching paid endpoints with their price, the chains they accept, and their 30-day usage from the catalogue's own counters: total calls, distinct paying addresses, the ratio between the two, and days since the last payment. Every figure is a count and carries its definition; no entry is scored, rated or labelled. Answers from a dated weekly snapshot and states which day it is from. Free.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 200,
      "description": "words to look for in the provider's own description, service name, URL and tags. Every word must appear as a whole word; there is no stemming, so \"yield\" does not match \"yields\". Omit to list the resources with the broadest paying base."
    },
    "max_price": {
      "type": "number",
      "minimum": 0,
      "description": "highest price per call in USDC to include"
    },
    "network": {
      "type": "string",
      "maxLength": 64,
      "description": "chain id a resource must accept payment on, for example eip155:8453"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "how many results to return, 1 to 50 (default 10)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Free OpenAPI manifest for Compass by 402rates. Contains this product and shared service information only.

{
  "type": "object",
  "properties": {
    "base_url": {
      "type": "string",
      "format": "uri",
      "description": "absolute origin to render into the manifest's servers block. Defaults to the configured public base URL."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Payment integration check for 0.001 USDC; no external data lookup. Returns time, rail, network mode and free/paid capabilities. HTTP payment options can include Base, Polygon, Arbitrum and XDC; the challenge lists currently available networks for each transport. The receipt identifies the paid network and transaction. Business/professional use only. Terms: https://402rates.com/data-terms/ Price: 0.001 USDC per call over x402.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}