TWZRD Agent Intelligence
Pre-spend trust for AI agents that buy: check x402 services and product listings before paying.
| Endpoint | https://intel.twzrd.xyz/mcp (streamable-http) |
|---|---|
| Registry version | 1.0.14 |
| Now | 28 tools · grade F (24) · pin ts_5dc64e4c99aacf979d7ab60f8fb543ca · protocol 2025-06-18 |
| First / last listed | 2026-11-05 00:08 UTC / 2026-11-05 00:08 UTC |
| Grade over time | 2026-11-05: F (24), 28 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: get_readiness_card_tool evaluate_x402_resource low_level_preflight verify_root_inputs get_solana_market_status score_wallet_for_intel get_top_intel_agents get_provider_reputation verify_x402_settled_claim submit_contribution_claims get_poec_score get_merchant_card is_wash_fleet verify_receipt get_facilitator_footprint get_counterparties score_wallets_batch compare_wallets get_x402_directory twzrd_watch_add twzrd_watch_list twzrd_watch_remove twzrd_demo_gate get_claim get_shopping_check get_evidence get_publication check_listing
get_readiness_card_tool |
PRIMARY free pre-spend gate (advisory). Pass seller_wallet OR resource_name.
wash_flagged=true never soft-allows. Unlabeled leftover 0.05 / leftover=0 is not a unit price.
When to use: before any x402 payment to a seller/resource.
When not to use: after you already decided to refuse; use verify_receipt for signed receipts only.
Pricing: free. Result is advisory (buyer policy params: resource_name, seller_wallet, resource_url, price_usdc, buyer_wallet, agent_intent, marketplace_score, queried_pubkey |
evaluate_x402_resource |
One-shot x402 guard. Fetches resource_url, extracts the seller wallet from the 402 accepts
array (prefers Solana network entries), runs TWZRD preflight, and returns a spending decision.
Side effect: a live 402 observation (resource_url, payTo, price) is upserted into the
service catalog when the catalog database is configured; this tool is not read-only.
wash_flagged=true neve params: resource_url*, method, agent_intent, price_usdc |
low_level_preflight |
Low-level preflight check. Returns a richer result object including
paid_quick_endpoint ($0.001 first hop) and optional paid_trust_endpoint ($0.05 V7).
wash_flagged=true never soft-allows. Unlabeled leftover 0.05 / leftover=0 is not a unit price.
Prefer get_readiness_card_tool for most callers. Use this when you need
max_spend_recommendation_usdc, full_report_hint, or the sug params: resource_name, seller_wallet, price_usdc, agent_intent, marketplace_score, buyer_wallet, resource_url |
verify_root_inputs | Independent root verification: recomputes the leaves, dataset hash and root from the public root data. params: root_seq, resource_name, seller_wallet |
get_solana_market_status |
Health probe for the Solana Market API data backend.
Call this to gate or degrade gracefully BEFORE the other get_solana_market_*
tools: it does a short-timeout hit on the data service and reports whether it
is reachable, so an agent can tell "market has no data" from "service is down"
without failing a real query.
Free discovery tool. When the market data service expose params: none |
score_wallet_for_intel |
Free discovery: PAYER-side 0-100 intel score for a wallet from the x402
payments it SENT (paid calls, distinct counterparties, volume, recency).
Not a seller check: to vet a seller/payTo before paying, use
get_readiness_card_tool (gate) or get_provider_reputation / get_merchant_card
(seller reputation). A pure seller scores 0 here by construction and the
response says so i params: wallet* |
get_top_intel_agents |
Leaderboard of observed payer wallets in the x402 settlement graph, each
with its intel score. This is behavioral corpus research, not identity
proof or evidence that the wallet is a TWZRD customer.
Ranks by the wash-discounted effective_score (single-counterparty fleets are
demoted, not hidden) with a deterministic tiebreaker. Set min_paid_calls to
suppress one-shot wall params: limit, min_paid_calls, max_days_since_last |
get_provider_reputation |
Free discovery: corpus-backed SELLER reputation for a merchant/provider wallet.
Answers "is this provider organic, narrow, or a wash fleet?" from the merchant's
inbound payment graph over the last 90 days: unique payers, repeat-payer %,
heavy-fleet revenue concentration, captive-payer % (onboarding-sink proxy), and
a scripted-fleet uniformity signal, and top_payer_tx_pct (cap params: merchant* |
verify_x402_settled_claim | Verify a receipts-ledger settlement; this is evidence, not a spend decision. params: settlement_tx* |
submit_contribution_claims |
PoECX bridge: report settlements from your OWN rails (not TWZRD's paid
routes) for cross-check against TWZRD's independently-ingested x402
corpus, by on-chain signature.
A claim whose tx_signature, payer/merchant, and amount all match what
TWZRD's own ingest independently observed is materially stronger evidence
than either a bare self-report or the anonymous corpus alone params: wallet*, claims* |
get_poec_score |
Free preview: PoEC v0 (Proof of Economic Contribution) for a payer wallet,
computed from the same observed x402 snapshot score_wallet_for_intel returns.
poec_score = log10(1 + observed USDC sent) x success_quality x diversity
x wash_cleanliness, behind hard floors (>=5 paid calls, >=3 distinct
counterparties, wash_factor >= 0.5, not single-counterparty, wash_flag
clean). params: wallet* |
get_merchant_card |
Free merchant card: observed inbound payment-graph quality around a Solana
or Base receive wallet.
Dual input (PR-3): pass ``wallet`` and/or ``resource_id``. Resource resolves via
the first-party registry (TWZRD seed) to a pay_to, then the same graph card.
Does NOT claim service quality (resource_listing_only / catalog_listing_only).
HTTP twin: GET /v1/intel/merchant_car params: wallet, resource_id, full |
is_wash_fleet |
Free discovery: cheap circular-flow (wash) check for a payer wallet.
Returns the CATEGORICAL classification (clean / self_pay / reciprocal /
self+reciprocal), an is_circular bool, and the observed event counts +
distinct_merchants from the wallet's corpus edges. Use as a fast Sybil/wash
gate before trusting a counterparty.
Accepts a Solana public key or a Base/EVM addres params: wallet* |
verify_receipt |
Free utility: offline-verify a portable V7 trust receipt (earlier V5/V6 receipts
still verify), the "after you pay" half of the loop.
Recomputes the Keccak256 leaf from the receipt's preimage (tamper-evidence) AND
verifies the Ed25519 signature against the published TWZRD receipt-signing key
(authenticity). Returns valid/leaf_valid/signature_valid plus the recomputed
leaf params: receipt*, require_signature, expected_pubkey, max_age_seconds |
get_facilitator_footprint |
Free discovery: which x402 facilitators a payer has settled through, and how many.
unique_facilitators = 1 is a thin/captive agent (locked to one rail); breadth
across facilitators indicates a more established cross-rail agent. Returns the
facilitator_ids list plus tx/merchant context. Fail-open: a DB gap returns
data_available=false rather than erroring.
params: wallet* |
get_counterparties |
Free discovery (capped teaser): the top-N merchants a wallet actually pays, by
event count, with per-edge tx_count / total_usdc / first+last timestamps.
See WHO a counterparty transacts with before trusting it. The list is capped
(default 10, max 25) and `capped`/`total_distinct_merchants` disclose how much
is withheld; the FULL deduped payment graph and numeric edge weights params: wallet*, limit |
score_wallets_batch |
Free discovery: score up to 25 wallets in a single call (each via the same
transparent model as score_wallet_for_intel). Convenience for triaging a set of
candidate counterparties at once; `requested`/`capped` disclose any truncation.
params: wallets* |
compare_wallets |
Free discovery: side-by-side intel for two wallets (e.g. choosing between two
candidate providers). Returns both full score objects and which ranks higher by
the wash-discounted effective_score ("tie" on equal, null if a side is unavailable).
params: wallet_a*, wallet_b* |
get_x402_directory | Wash overlay on ingested PayAI/CDP/Agentic listings (PayAI not_indexed).
Prefer HTTP GET /v1/intel/resources for the resource join SOT (callable URL +
discovery claim listed|live_402 + settlement reputation on pay_to). That
surface is HTTP-only. Use this tool when you need
the ingested listing overlay indexed by payTo. Not GET /v1/intel/bazaar/offers
(TWZRD Bazaar catalog) and params: flagged_only, limit, source |
twzrd_watch_add | Register a re-call watch on a seller wallet.
After registration, TWZRD will proactively re-check the seller's trust intel
when `recheck_after_unix` elapses and POST a notification to your webhook_url
if the score/decision materially changes.
The watch routes are control-proof authenticated (fail closed): signature
and timestamp prove the caller holds the payer wallet's key. R params: payer_wallet*, seller_wallet*, signature*, timestamp*, webhook_url |
twzrd_watch_list | List active re-call watches for your agent wallet.
Each watch shows the seller, current score/decision, and recheck_after_unix
timestamp (untrusted V5/V6 hint). evaluateRecall / shouldRecheckTrusted is
the consumer gate; do not treat due / shouldRecheck as a trusted allow.
Control-proof authenticated (fail closed) via signature + timestamp.
params: payer_wallet*, signature*, timestamp* |
twzrd_watch_remove | Deactivate a re-call watch by ID. payer_wallet must match the owner.
Control-proof authenticated (fail closed): signature + timestamp prove the
caller holds the payer wallet's key before the row is touched.
params: watch_id*, payer_wallet*, signature*, timestamp* |
twzrd_demo_gate |
No-spend transcript of the TWZRD buyer-side x402 trust gate, a recorded example,
not a live run - discoverable at runtime with no install and no human.
Returns a deterministic transcript showing the gate's behaviour on a fixture
counterparty: the block path ABORTS and a wallet/signer is never contacted, the
allow path would proceed, and ok=true. Spends no USDC, contacts no wa params: integration, run_id |
get_claim | Read the Vuori Kore Short listing-claim artifact (com.twzrd.shopping.listing_claims/1.1).
Tool twin of the twzrd://claims/vuori-kore resource: what is claimed about this
checkout, by whom, in what state, on what evidence. Verified on every read
(publication signature, artifact digest, schema, evidence binding); a read that
fails any check is refused, never served. `unknown` claims params: none |
get_shopping_check | Read the free Agent Shopping Check for Vuori Kore Short, Ink, US.
Same report as https://twzrd.xyz/shopping-check/vuori-kore/: product
context, advertised claims with exact sources and observation times,
unverified purchase completion and other gaps, and editorial merchant
fixes for the reviewed gaps still open. Built from the verified signed
publication on every read.
Exp params: none |
get_evidence | Read the evidence bundle behind the Vuori Kore Short listing claims.
Tool twin of the twzrd://claims/vuori-kore/evidence resource: canonical_evidence/1
envelopes and capture records. A claim's evidence digest is the RFC 8785 SHA-256 of
its envelope; recompute it to check. Verified with the artifact on every read and
refused on any mismatch. Raw page bytes are not served. Read-only params: none |
get_publication | Read the signed publication record behind the current Vuori Kore Short claims.
Tool twin of the twzrd://claims/vuori-kore/publication resource. Returns the
Ed25519 publication record, the verify key and its sha256 fingerprint. Verify the
signature over the signed message, then compare sha256 of each get_claim /
get_evidence text with artifact_digest / evidence_digest. With the key params: none |
check_listing | Pre-spend check of one product against the published listing cards. Free, read-only.
Returns unknown_seller when no published card covers the product (not a clean seller),
expired when the card is past expires_at, check_failed when the card cannot be verified
or the declared price is above the advertised one, and advertised when a current card
matches. It never authorizes a paymen params: product_url, merchant, product, market, variant, declared_unit_price |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.