Compass by 402rates

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Free agent tests (no account or payment); paid ping.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Compass by 402rates": {
      "url": "https://api.402rates.com/mcp/compass",
      "transport": "streamable-http"
    }
  }
}

Measured tools (13)

• list_agent_test_cases read-only

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

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• describe_agent_test read-only

  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.

  Parameters:

  • case_id — string — Versioned synthetic case identifier.
  • variant — string — Budget case: budget_first or attempts_first. Linked repeats retain the previous variant.
  • case_version — string — 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.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• start_agent_test

  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.

  Parameters:

  • case_id (required) — string — Versioned synthetic case identifier.
  • variant — string — Budget case: budget_first or attempts_first. Linked repeats retain the previous variant.
  • access_token — string — Secret short-lived run token. Omitted from reports. MCP client history may retain this argument.
  • case_version — string — 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.
  • previous_run_id — string — Optional finalized run to repeat. Its access token authenticates this start.
  • configuration_changed — boolean — Optional caller-declared change since the previous run; not independently verified.

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• execute_test_action

  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.

  Parameters:

  • run_id (required) — string — Run identifier from start_agent_test.
  • task_id (required) — string — Task identifier bound to this run.
  • action_key (required) — string — Caller-generated UUID. Identical key and payload identify the same synthetic operation.
  • access_token (required) — string — Secret short-lived run token. Omitted from reports. MCP client history may retain this argument.
  • cursor — string — Partial-result page cursor: first or second.
  • quantity — integer — Synthetic quantity. The task specifies one unit.
  • record_ids — array — Synthetic record identifiers submitted by the caller, at most six.
  • action_type — string — Case action: attempt, get_page or submit_result. Not accepted by the original case.

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• inspect_test_state read-only

  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.

  Parameters:

  • run_id (required) — string — Run identifier from start_agent_test.
  • task_id (required) — string — Task identifier bound to this run.
  • access_token (required) — string — Secret short-lived run token. Omitted from reports. MCP client history may retain this argument.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• read_agent_test_report

  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.

  Parameters:

  • run_id (required) — string — Run identifier from start_agent_test.
  • access_token (required) — string — Secret short-lived run token. Omitted from reports. MCP client history may retain this argument.
  • finalize — boolean — True freezes the run and prevents further actions. Omitted means read only.

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• decode_payment_attribution read-only

  Free local decoding of an ERC-8021 schema-2 x402 builder-code suffix from supplied calldata. Separates application, facilitator, services and facilitator-reported metadata. No transaction lookup, receipt confirmation, identity verification or payment. Malformed and unsupported suffixes remain explicit.

  Parameters:

  • calldata — string — Full caller-supplied transaction input as even-length 0x hex, at most 90,000 bytes. No URL, transaction hash, signature or receipt.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• compare_payment_terms read-only

  Free comparison of two unsigned captures for the same resource and method. Default analysis version 1 retains Exact EVM; version 2 compares documented Exact, Upto, Batch Settlement and Auth-Capture fields, limits and lifecycle terms. Captures are caller declarations, with no authentication, fetching or payment. Unknown profiles remain non-comparable.

  Parameters:

  • baseline (required) — object
  • current (required) — object
  • analysis_version — string — 1 preserves the original Exact EVM comparison. 2 compares the pinned multi-scheme EVM profiles, including amount scope, authorizers, escrow, declared deadlines and fee bounds.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• check_payment_terms read-only

  Free inspection of unsigned x402 terms. Default analysis version 1 retains Exact EVM checks; analysis_version 2 inspects documented EVM Exact, Upto, Batch Settlement and Auth-Capture profiles, declared limits and lifecycle fields. Unknown fields stay unchecked. No wallet, signature verification, live contract validation or settlement.

  Parameters:

  • expected — object — Optional exact terms. An atomic budget requires network and asset.
  • challenge — object — Decoded PaymentRequired object from HTTP or MCP structuredContent. No signed payment or credentials.
  • analysis_version — string — 1 preserves the original Exact EVM report. 2 selects documented multi-scheme structural inspection, report version 2.0.0.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• list_capabilities read-only

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

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• find_x402_resource read-only

  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.

  Parameters:

  • q — string — 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.
  • limit — integer — how many results to return, 1 to 50 (default 10)
  • network — string — chain id a resource must accept payment on, for example eip155:8453
  • max_price — number — highest price per call in USDC to include

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• get_manifest read-only

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

  Parameters:

  • base_url — string — absolute origin to render into the manifest's servers block. Defaults to the configured public base URL.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• test_payment read-only

  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.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.