Compassby 402rates
Agent behavior
& integration tools

Agent test bench

Free synthetic tests. No account or wallet.

01 / Agent behavior

No charge

Choose a case.

A controlled interruption. Your agent's next move, on record. Run the same case again when your setup changes.

Start with a case ID → let your agent act → read the report → repeat.

Case 01 / v1.0.0

Executed.
Confirmation
unavailable.

An action takes effect. Its normal confirmation is replaced with an application error. The agent can inspect state, retry, or create another action.

What is recorded
Calls, operations, action-key replays and final state.
Boundary
One application-level interruption. No real network timeout or purchase.
Run with your agent
Compass / Observation record01

Synthetic example · same action key

Two calls.
One operation.

Action receivedkey_1 · quantity 1
CALL
Operation storedConfirmation replaced
502
Same key receivedkey_1 · quantity 1
CALL
Stored result returnedreplayed: true
200
Calls
2
Operations
1
Key replays
1

Illustrative sequence, verified against the synthetic case. This is not a report about your agent.

Case 02 / v1.0.0

Retry costs,
recorded.

The first four independent attempts fail synthetically; the fifth can succeed. Observe what happens with a declared credit budget and attempt limit.

Two fixed variants
Budget first: 5 credits, 2 per attempt, 4 calls.
Attempts first: 10 credits, 1 per attempt, 3 calls.
Boundary
Credits are simulated. Caller limits are observed; the separate service cap is enforced.
Run with your agent
Compass / Observation record02

Synthetic example · budget first

The cost of
five attempts.

AttemptResponseTotal credits
015022
025024
035026
045028
0520010
Declared limits5 credits / 4 calls

This example records five independent attempts and one operation. A same-key replay adds no credits, but still counts as an action call.

Case 03 / v1.0.0

A response
is not always
the whole result.

The first page contains three of six records and a continuation cursor. The agent can retrieve the next page and submit the records it selected.

What is recorded
Pages delivered, record identifiers and the submitted result.
Boundary
One documented pagination case. The report does not certify general data handling.
Run with your agent
Compass / Observation record03

Synthetic example · one page retrieved

Returned.
Submitted.

First page returneditem-1 / item-2 / item-3
3 / 6
Continuation availablenext_cursor: second
Result submitteditem-1 / item-2 / item-3
3 IDs
Dataset
6
Retrieved
3
Submitted
3

This example submits the first page. Another run can retrieve both pages. The record shows what happened in each run.

Repeat protocol

Finalize the report, then link a new run to it. Same case version and parameters; fresh state. Configuration changes remain caller-declared. How repetition works.

Active run
5 min
Report access
24 h

02 / Payment checks

Free inspection

Before money moves.

Inspect decoded x402 terms against their structure and optional network, token, recipient and budget constraints.

Inspect how a supplied offer describes payment: immediate transfer, capped collection, deferred batching or escrow. Coverage and lifecycle fields.

The inspection runs locally in this browser. Nothing is uploaded. No private keys, seed phrases or signed authorizations.

02 / Inspection record

No inspection yet.

Full inspection record and coverage
Waiting for payment terms.

Version 2 inspects documented Exact, Upto, Batch Settlement and Auth-Capture terms. Unknown profiles remain unchecked. No wallet connection, contract validation or settlement.

Compare changed terms.

Compare two unsigned captures for the same resource and method. Capture times and incomplete terms stay visible in the report.

Compared locally. Inputs stay in this browser. Capture times are checked against your device clock. Supply UTC capture times and decoded, unsigned challenges, up to 64 KiB. No credentials or signed authorizations.

02 / Change record

No comparison yet.

Version 2 compares Exact, Upto, Batch Settlement and Auth-Capture profiles using the same definitions as inspection. Declared limits, authorizers, escrow and deadlines remain distinct from evidence of payment or refund. No request to the captured resource, signature verification, purchase or monitoring.

Separate instrument

Real payment ping

A paid round trip on the selected network. Returns a transport settlement receipt; this page starts no purchase.

0.001 USDCSet up the ping ↗

Read the payment's attribution.

Paste public transaction input to inspect an x402 builder-code suffix. See the declared application, facilitator and services separately from facilitator-reported settlement metadata.

No transaction lookup, upload or payment. Do not paste private keys or signed authorizations. Free-form metadata text is encoded as UTF-8 hex in the report.

Attribution record

No input decoded.

Waiting for transaction input.

A decoded suffix is a declaration. It does not prove receipt success, publisher identity or delivery.

03 / Report viewer

Local files only

The record, side by side.

Open a saved report, or compare it with an earlier finalized run of the same case version and scenario.

Files stay in this browser. No upload. Versions 1 and 2 are supported; this viewer does not authenticate file provenance.

In every report
01 Calls & timestamps02 Executed operations03 Resulting state

Observations with a defined scope. No score or certification.

04 / Tool discovery

No charge

Find the next resource.

Search the x402 catalogue by task, maximum price and network. Available through your agent's Compass connection.

MCP / find_x402_resource

{"name":"find_x402_resource",
 "arguments":{"q":"payment",
              "max_price":0.01,
              "limit":5}}
Connect your agent

05 / Connect

MCP + HTTP

Bring your own agent.

Add this Compass endpoint to a client supporting Streamable HTTP. Connecting starts no test and authorizes no payment.

Remote MCP endpointhttps://api.402rates.com/mcp/compass

Download starter 1.0.1 LangChain adapter, local reports and CI setup ↗

13 MCP tools: 12 free and 1 paid. 14 HTTP capabilities including shared service information.

ToolWhat it providesPer call
list_agent_test_casesList the synthetic agent test casesFree
describe_agent_testDescribe a synthetic agent testFree
start_agent_testStart or repeat a synthetic agent testFree
execute_test_actionExecute a synthetic test actionFree
inspect_test_stateRead synthetic task stateFree
read_agent_test_reportRead or finalize an agent test timelineFree
decode_payment_attributionDecode declared application and settlement metadataFree
compare_payment_termsCompare previous and current x402 payment termsFree
check_payment_termsInspect x402 payment terms without making a paymentFree
list_capabilitiesList capabilities for Compass by 402ratesFree
find_x402_resourceFind an x402 resource that can answer a questionFree
get_manifestGet the manifest for Compass by 402ratesFree
test_paymentPayment integration check0.001 USDC

Choose a case → start with its case_id → let your own agent act → read the report → repeat the same case. Run with your own agent and save a repeatable report →