xyz.twzrd.intel/twzrd-agent-intel

Est-ce que xyz.twzrd.intel/twzrd-agent-intel est sûr ?

Au dernier audit MCP Hub, le serveur MCP « xyz.twzrd.intel/twzrd-agent-intel » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 28 outils

• check_listing≈ 1069 tokens

  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 payment: authorizes_spend is always false. needs_approval is true for every result except advertised, and also for an advertised card that advertises nothing, advertises no price, cannot check the declared price, or is declared below its advertised price (an unverified discount, including zero). It does not fetch the store page, open a checkout or move money.

  Paramètres, retour & exemple (6)

  Paramètres

  • market · string · optionnel
    Optional subject market (e.g. US); must agree with the card when given.
  • product · string · optionnel
    Optional subject product; must agree with the card when given.
  • variant · string · optionnel
    Optional subject variant (e.g. Ink); must agree with the card when given.
  • merchant · string · optionnel
    Optional subject merchant; must agree with the card when given.
  • product_url · string · optionnel
    The store product URL the agent is about to buy from. Matched against the published card's next_hop URL, ignoring scheme, host case, query, fragment and a trailing slash. Another host is unknown_seller; a miss on the card's own site also returns covered_product_url.
  • declared_unit_price · ? · optionnel
    Optional unit price the seller is asking, in USD, as a number or text, e.g. 78, 78.00, $78 or 78 USD; another currency is invalid. Above the card's advertised price is refused (phantom_markup_detected); below it is discount_unverified and needs approval.

  Exemple d'appel

  {"name": "check_listing", "arguments": {"market": "texte", "product": "texte", "variant": "texte", "merchant": "texte", "product_url": "texte", "declared_unit_price": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"claims": [], "digest": "texte", "reason": "texte", "result": "texte", "expires_at": "texte", "artifact_id": "texte", "price_check": "texte", "needs_approval": true, "authorizes_spend": true}}

• compare_wallets≈ 370 tokens

  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).

  Paramètres, retour & exemple (2)

  Paramètres

  • wallet_a · string · requis
    First wallet (Solana base58 or Base 0x) to compare.
  • wallet_b · string · requis
    Second wallet (Solana base58 or Base 0x) to compare.

  Exemple d'appel

  {"name": "compare_wallets", "arguments": {"wallet_a": "texte", "wallet_b": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"wallet_a": "texte", "wallet_b": "texte", "higher_effective_score": "texte"}}

• evaluate_x402_resource≈ 1432 tokens

  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 never soft-allows. Unlabeled leftover 0.05 / leftover=0 is not a unit price. Decision: "allow" -> proceed only under agent policy. Never when wash_flagged=true. "warn" -> proceed with caution up to the cap; first paid hop is teaser_url ($0.001 /quick). Optional V7 receipt_url is $0.05. "block" -> DO NOT PAY. Stop immediately. "unknown" -> is_x402 == False: no 402 challenge was issued at all, so nothing was evaluated -- this is NOT a trust verdict. A seller can trivially make this happen by returning a non-402 status to this probe while charging through a different path for a real caller. Never treat "unknown" as a green light; if the caller actually intends to pay this resource_url, that separate payment path needs its own evaluation. Hard-stops: wash_flagged=true never soft-allows (decision=block). price_usdc is a unit price only when price_kind=exact. Unlabeled leftover 0.05 / leftover=0 and scheme=upto leftover defaults are not a per-request price. Revenue path: when decision is "warn", fetch teaser_url first ($0.001 USDC to TWZRD, GET /v1/intel/quick/{seller}). Optional receipt_url is the $0.05 V7 signed credential.

  Paramètres, retour & exemple (4)

  Paramètres

  • method · string · optionnel
    HTTP method to use when probing the resource. Default: GET.
  • price_usdc · number · optionnel
    Caller-supplied exact unit price in USDC — overrides a 402 exact quote. Leave unset to use the 402-reported amount when price_kind=exact. Unlabeled leftover 0.05 / leftover=0 is not a unit price.
  • agent_intent · string · optionnel
    Natural-language description of what the agent intends to purchase.
  • resource_url · string · requis
    URL of the x402 resource to evaluate before paying. Will be fetched to extract 402 payment requirements.

  Exemple d'appel

  {"name": "evaluate_x402_resource", "arguments": {"resource_url": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"url": "texte", "error": "texte", "is_x402": "texte", "decision": "texte", "price_kind": "texte", "price_usdc": "texte", "teaser_url": "texte", "receipt_url": "texte", "trust_score": "texte", "upsell_usdc": "texte", "receipt_usdc": "texte", "seller_wallet": "texte"}}

• get_claim≈ 363 tokens

  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 stay unknown. Each claim carries expires_at; after it, treat the claim as historical. Read-only; this never starts a payment or checkout.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_claim", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"uri": "texte", "text": "texte", "digest": "texte", "artifact_id": "texte"}}

• get_counterparties≈ 710 tokens

  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 are part of the paid intel surface (GET /v1/intel/trust/{wallet}). Fail-open.

  Paramètres, retour & exemple (2)

  Paramètres

  • limit · integer · optionnel
    Max counterparties to return (default 10, hard cap 25 - this is a capped teaser).
  • wallet · string · requis
    Payer Solana wallet public key (32-44 base58 chars) whose counterparties (merchants paid) to list.

  Exemple d'appel

  {"name": "get_counterparties", "arguments": {"wallet": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"error": "texte", "capped": "texte", "wallet": "texte", "returned": "texte", "teaser_note": "texte", "total_events": "texte", "counterparties": "texte", "data_available": "texte", "total_distinct_merchants": "texte"}}

• get_evidence≈ 328 tokens

  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.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_evidence", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"uri": "texte", "text": "texte", "digest": "texte", "artifact_id": "texte"}}

• get_facilitator_footprint≈ 645 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • wallet · string · requis
    Solana wallet public key (32-44 base58 chars) to look up its x402 facilitator footprint.

  Exemple d'appel

  {"name": "get_facilitator_footprint", "arguments": {"wallet": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"error": "texte", "found": "texte", "wallet": "texte", "tx_count": "texte", "last_seen": "texte", "first_seen": "texte", "data_available": "texte", "facilitator_ids": "texte", "unique_merchants": "texte", "unique_facilitators": "texte"}}

• get_merchant_card≈ 588 tokens

  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_card/{wallet_or_resource_id}. Compact (default) includes observed_at, stale, corpus_complete_day, corpus_age_days. Catalog services stay behind full=true. wash_flagged is tri-state: true (flagged) | false (evaluated clean) | null (never evaluated - NOT clean). wash_flagged=true never soft-allows (next_action.decision=refuse; no warn/allow/quick). Unlabeled leftover 0.05 / leftover=0 is not a unit price; cheapest_listed_price_usdc omits leftover and upto_cap amounts. Route on next_action.decision (refuse | insufficient_evidence | no_negative_signal); the card is down-only and never returns allow. `reason` carries the specific finding (e.g. a soft wash risk collapsed into "refuse", or a corpus outage collapsed into "insufficient_evidence") when the 3-value decision alone is not enough context.

  Paramètres, retour & exemple (3)

  Paramètres

  • full · boolean · optionnel
    If true, include catalog services. Default is the compact decision surface.
  • wallet · ? · optionnel
    Receive wallet (x402 pay_to / merchant pubkey). Observed payment-graph card only — not a business, demand, or identity attestation.
  • resource_id · ? · optionnel
    Optional registry resource_id (HTTP path template or mcp:tool). Resolved to merchant_wallet via PR-3 seed; claim resource_listing_only.

  Exemple d'appel

  {"name": "get_merchant_card", "arguments": {"full": true, "wallet": "texte", "resource_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_poec_score≈ 1511 tokens

  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). Any failed floor, or an unobservable corpus, scores 0.0 with floors_passed=false - the floors fail closed, never open. wash_factor is a cleanliness multiplier (1.0 = clean) and is never inverted. Honesty contract: `claimable` is ALWAYS false. Volume here is corpus-observed, not a payout unlock. `success_quality` comes from the payer join onto signed `receipt_settlement_leaves` (0211); if that join is unobservable, `success_rate` stays in evidence_gaps and the score reads 0.0. What this surface already shows honestly is the floor filter (eligible_v0) and every component the score is built from. Self-reported settlements go through submit_contribution_claims. Base (EVM) 0x wallets are scored from the relayer-attributed x402_base_daily rollup (90d) with the same shape, but no wash/sybil graph exists for Base payers yet, so their wash_flag reads "unknown" (never "clean"), the wash floor stays closed, and poec_score stays 0.0 regardless of real volume. A wallet the corpus could not observe at all returns `error` set; on that path any real observed Base volume is attached under `base_observed`.

  Paramètres, retour & exemple (1)

  Paramètres

  • wallet · string · requis
    Payer wallet (Solana base58 or Base 0x) to score for Proof of Economic Contribution.

  Exemple d'appel

  {"name": "get_poec_score", "arguments": {"wallet": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"as_of": "texte", "error": "texte", "wallet": "texte", "claimable": "texte", "wash_flag": "texte", "components": "texte", "paid_calls": "texte", "poec_score": "texte", "eligible_v0": "texte", "success_rate": "texte", "base_observed": "texte", "evidence_gaps": "texte"}}

• get_provider_reputation≈ 1310 tokens

  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 (captive concentration). Returns wash_label + reputation tier + wash_flagged (tri-state: true | false | null; null = never evaluated, not clean). Complements score_wallet_for_intel (payer side) with the seller side. wash_flagged=true never soft-allows (buyer refuse; preflight block). Fail-open: a DB gap returns wash_label/tier "unknown" AND wash_flagged=null (plus wash_confidence) - an unevaluated verdict, never a clean one. This is the free seller signal. First paid hop is GET /v1/intel/quick/{wallet} (0.001 USDC). Optional V7 renorm + signed receipt is GET /v1/intel/trust/{wallet} (0.05 USDC).

  Paramètres, retour & exemple (1)

  Paramètres

  • merchant · string · requis
    Seller/merchant pay_to address to score on inbound corpus reputation: a Solana base58 wallet or a Base 0x address.

  Exemple d'appel

  {"name": "get_provider_reputation", "arguments": {"merchant": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"reason": "texte", "merchant": "texte", "total_tx": "texte", "wash_label": "texte", "wash_flagged": "texte", "score_version": "texte", "unique_payers": "texte", "wash_confidence": "texte", "avg_tx_per_payer": "texte", "repeat_payer_pct": "texte", "top_payer_tx_pct": "texte", "captive_payer_pct": "texte"}}

• get_publication≈ 412 tokens

  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 fingerprint pinned from a second source (the published fingerprint in the connector packet), that check does not trust this server; without it, it shows only that the record and the served bytes agree. The signature admits bytes to the resource; it is not a merchant attestation. Read-only.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_publication", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"uri": "texte", "text": "texte", "digest": "texte", "artifact_id": "texte"}}

• get_readiness_card_tool≈ 3542 tokens

  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 still applies). Hard-stops: wash_flagged=true never soft-allows (decision=block / do_not_pay; no warn/allow/quick). Unlabeled leftover 0.05 / leftover=0 is not a unit price; read price_kind. Caller-supplied or scheme/price_kind=exact 0.05 stays a unit price. Decision semantics (top-level, no nesting via MCP): decision=block / recommended_action=do_not_pay -> DO NOT PAY. decision=warn / recommended_action=proceed_with_cap -> pay only up to maximum_recommended_spend_usdc. decision=allow / recommended_action=proceed_for_small_spend -> proceed under agent policy (no free-tier cap). next_action (enrollment handoff — do not stop after free card): next_step_type / payment_required / executable / command describe an optional next step. A host may use command only under its own policy. Never paste path templates (:pubkey / {pubkey}) as seller_wallet. Also returns reason_codes[], confidence, model_version, decision_envelope. No counterparty named (seller_wallet missing / a template / not a wallet, and no resource_name or resource_url): decision=block, trust_score null, score null, null_reason=no_subject, reason_codes NO_COUNTERPARTY (+ PLACEHOLDER_SELLER_WALLET), seller_wallet_rejected echoes what you sent. That is an input bug, not a seller verdict: fix the input and re-run. trust_score is a free heuristic, NOT the full corpus. Next: on allow/warn for material spend, next_action.command is the optional AgentCash paid-trust or AutoGate install string, then verify_receipt on the signed V7 receipt. Optional: twzrd_watch_add for re-check after recheck_after_unix. Additive: top-level aop_bind program registry (evidence hierarchy) when enabled; never mutates decision / can_spend.

  Paramètres, retour & exemple (8)

  Paramètres

  • price_usdc · number · optionnel
    Caller-supplied exact unit price in USDC. Leave unset unless you have an exact quote. Unlabeled leftover 0.05 / leftover=0 is not a unit price.
  • agent_intent · string · optionnel
    Natural-language intent describing the planned paid action.
  • buyer_wallet · string · optionnel
    Buyer's Solana wallet public key used for spend-context checks.
  • resource_url · string · optionnel
    Canonical endpoint URL for the resource, if available.
  • resource_name · string · optionnel
    Provider or resource label in a marketplace (for example marketplace:agent-name). Provide this OR seller_wallet.
  • seller_wallet · string · optionnel
    Seller payTo for the listing or endpoint: a Solana base58 wallet (32-44 chars) or a Base 0x address. Provide this OR resource_name. CRITICAL: never pass OpenAPI templates (:pubkey, {pubkey}, {seller_wallet}, SELLER_WALLET, PAY_TO_WALLET) — use accepts[].payTo from a 402 challenge.
  • queried_pubkey · string · optionnel
    Consumer pubkey, echoed on output when provided (attribution only).
  • marketplace_score · integer · optionnel
    Optional upstream marketplace trust score (0-100) to blend into preflight context.

  Exemple d'appel

  {"name": "get_readiness_card_tool", "arguments": {"price_usdc": 1, "agent_intent": "texte", "buyer_wallet": "texte", "resource_url": "texte", "resource_name": "texte", "seller_wallet": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"as_of": "texte", "basis": "texte", "proof": "texte", "score": "texte", "stale": "texte", "caveats": "texte", "version": "texte", "category": "texte", "decision": "texte", "can_spend": "texte", "issued_at": "texte", "expires_at": "texte"}}

• get_shopping_check≈ 197 tokens

  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. Expired observations are historical. Never pays or starts checkout.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_shopping_check", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_solana_market_status≈ 564 tokens

  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 exposes /status, the response includes prod_key_configured, data_first_available, and an actionable note describing what to configure for full on-chain visibility.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_solana_market_status", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"score": "texte", "trend": "texte", "detail": "texte", "available": "texte", "velocity_rank": "texte", "market_velocity": "texte", "base_url_configured": "texte"}}

• get_top_intel_agents≈ 636 tokens

  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 wallets and max_days_since_last to suppress dormant ones.

  Paramètres, retour & exemple (3)

  Paramètres

  • limit · integer · optionnel
    Maximum number of ranked payer wallets to return (default 10).
  • min_paid_calls · integer · optionnel
    Filter out wallets with fewer than this many observed paid calls (default 0 = no filter). Use to get credible *active* counterparties, not a raw dump.
  • max_days_since_last · number · optionnel
    Only include wallets active within this many days (default null = no recency filter). Use e.g. 14 to exclude dormant or historical payers.

  Exemple d'appel

  {"name": "get_top_intel_agents", "arguments": {"limit": 1, "min_paid_calls": 1, "max_days_since_last": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"count": "texte", "error": "texte", "agents": "texte", "score_model": "texte", "score_version": "texte", "data_available": "texte"}}

• get_x402_directory≈ 400 tokens

  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 not 402 extensions.bazaar. Solana wash overlay is the only wash graph. Base listings additionally carry high-confidence EIP-3009 corpus membership from x402_base_daily; they remain wash_unknown. Polygon listings carry wash_unknown. Query params — flagged_only, limit, source — mirror GET /v1/intel/x402-directory.

  Paramètres, retour & exemple (3)

  Paramètres

  • limit · integer · optionnel
    Max directory rows to return (1-500).
  • source · ? · optionnel
    Source filter: payai_bazaar, cdp_bazaar, agentic_market, or None for all.
  • flagged_only · boolean · optionnel
    Return only wash-flagged listings.

  Exemple d'appel

  {"name": "get_x402_directory", "arguments": {"limit": 1, "source": "texte", "flagged_only": true}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• is_wash_fleet≈ 964 tokens

  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 address. On Base the signal reads the high-confidence x402 rollup only, and the 3-cycle ring runs as a live query instead of the Solana precomputed matview. Read ring_evaluated: when it is false, ring_events=0 means NOT EVALUATED, never "no rings observed". Fail-open: a DB gap returns classification "unknown". The numeric wash discount (wash_factor / wash_ratio) and the full renormalized model stay paid — they are NOT returned here.

  Paramètres, retour & exemple (1)

  Paramètres

  • wallet · string · requis
    Wallet to check for circular-flow / wash behavior: a Solana public key (32-44 base58 chars) or a Base/EVM address (0x + 40 hex).

  Exemple d'appel

  {"name": "is_wash_fleet", "arguments": {"wallet": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"chain": "texte", "error": "texte", "reason": "texte", "wallet": "texte", "is_circular": "texte", "ring_events": "texte", "self_events": "texte", "total_events": "texte", "classification": "texte", "ring_evaluated": "texte", "reciprocal_events": "texte", "distinct_merchants": "texte"}}

• low_level_preflight≈ 1068 tokens

  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 suggest_full_report flag. The embedded `readiness_card` carries the SAME full shape as get_readiness_card_tool (see the outputSchema). Hard-stops: wash_flagged=true never soft-allows (decision=block; no warn/allow/quick). Unlabeled leftover 0.05 / leftover=0 is not a unit price; read readiness_card.price_kind.

  Paramètres, retour & exemple (7)

  Paramètres

  • price_usdc · number · optionnel
    Caller-supplied exact unit price in USDC. Leave unset unless you have an exact quote. Unlabeled leftover 0.05 / leftover=0 is not a unit price.
  • agent_intent · string · optionnel
    What the agent intends to do with the purchased response or tool.
  • buyer_wallet · string · optionnel
    Buyer's Solana wallet public key; enables buyer-context evidence in scoring.
  • resource_url · string · optionnel
    Canonical endpoint URL for the resource, if available.
  • resource_name · string · optionnel
    Provider or listing identifier to evaluate before payment.
  • seller_wallet · string · optionnel
    Seller payTo (Solana base58 or Base 0x address) for reputation and spend checks.
  • marketplace_score · integer · optionnel
    Optional marketplace-provided score (0-100) for blend-in scoring context.

  Exemple d'appel

  {"name": "low_level_preflight", "arguments": {"price_usdc": 1, "agent_intent": "texte", "buyer_wallet": "texte", "resource_url": "texte", "resource_name": "texte", "seller_wallet": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"reason": "texte", "decision": "texte", "evidence": "texte", "trust_score": "texte", "readiness_card": "texte", "full_report_hint": "texte", "paid_quick_endpoint": "texte", "paid_trust_endpoint": "texte", "suggest_full_report": "texte", "max_spend_recommendation_usdc": "texte"}}

• score_wallet_for_intel≈ 1752 tokens

  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 in seller_side_hint. A Base 0x wallet is scored from the relayer-attributed x402_base_daily rollup (90d) with the same shape; no Base wash graph exists yet, so its wash_flag is "unknown" unless single-counterparty. Uses a simple transparent heuristic (volume log + breadth + spend log + recency decay) — the exact formula is returned inline as `score_model`. Returns intel_score, the wash-discounted effective_score + wash_flag/wash_factor (cheap Sybil signal), counts, component breakdown, and a data_available flag. Malformed pubkeys are rejected cleanly; the failure path returns the same shape as success. Sourced from the cross-facilitator corpus via the public Rust HTTP endpoint GET /v1/agents/{wallet}/x402 (backed by the x402_solana_payer_agg matview). First paid hop is the score-only teaser GET /v1/intel/quick/{wallet} (0.001 USDC). Optional V7 signed receipt (intel_renorm_v1_1: score_raw, confidence, breadth_factor, wash_factor) is GET /v1/intel/trust/{wallet} (0.05 USDC).

  Paramètres, retour & exemple (1)

  Paramètres

  • wallet · string · requis
    Wallet to score: a Solana base58 pubkey or a Base 0x address, using x402 payment-history intelligence.

  Exemple d'appel

  {"name": "score_wallet_for_intel", "arguments": {"wallet": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"role": "texte", "basis": "texte", "chain": "texte", "error": "texte", "wallet": "texte", "network": "texte", "last_seen": "texte", "wash_flag": "texte", "first_seen": "texte", "paid_calls": "texte", "total_usdc": "texte", "intel_score": "texte"}}

• score_wallets_batch≈ 446 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • wallets · array · requis
    List of wallets (Solana base58 or Base 0x) to score in one call (hard cap 25; extras are dropped).

  Exemple d'appel

  {"name": "score_wallets_batch", "arguments": {"wallets": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"count": "texte", "error": "texte", "capped": "texte", "results": "texte", "requested": "texte", "max_per_call": "texte"}}

• submit_contribution_claims≈ 1811 tokens

  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 — the signature is real and on-chain, and a mismatch can't be forged to pass. Unmatched claims are returned too, with a reason, never silently dropped. This is a preview, not an unlock: `claimable` is always false. It exists to let a real counterparty with its own settlement volume start feeding PoECX before any on-chain payout path exists — see the PoECX plan. Capped at 25 claims per call (discovery convenience, not bulk export); extras are dropped, never silently ignored — see `capped`/`claims_requested`. Within that cap, only the first claim per (chain, tx_signature, transfer_index) is checked. Omitted transfer_index is the first leg (dedup key 0). Later copies of the same leg appear in `unverified` with reason_code `duplicate_claim` and `duplicate_of` pointing to the zero-based first input index. Two legs of one tx count twice. This deduplicates one preview report, not claims across separate calls.

  Paramètres, retour & exemple (2)

  Paramètres

  • claims · array · requis
    Self-reported settlements to cross-check. Each item: {"tx_signature": str, "chain": "solana"|"base", "amount_usdc": float (optional), "transfer_index": int (optional, Solana transfer_index / Base log_index; omitted is first leg)}. Any other chain value is rejected before it ever reaches a query.
  • wallet · string · requis
    The wallet these settlement claims are being reported for.

  Exemple d'appel

  {"name": "submit_contribution_claims", "arguments": {"claims": [], "wallet": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"note": "texte", "as_of": "texte", "capped": "texte", "wallet": "texte", "verified": "texte", "claimable": "texte", "unverified": "texte", "max_per_call": "texte", "score_version": "texte", "verified_usdc": "texte", "claims_verified": "texte", "claims_requested": "texte"}}

• twzrd_demo_gate≈ 429 tokens

  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 wallet. This call surfaces an EXTERNAL_RUN *candidate* in TWZRD's honest attribution ledger (it carries a non-internal integration id + your run_id, tagged with your real inbound IP). A candidate is NOT an EXTERNAL_RUN: TWZRD's operator still has to match your run_id to a non-internal caller and confirm it. See the returned not_external_run_proof.

  Paramètres, retour & exemple (2)

  Paramètres

  • run_id · ? · optionnel
    Optional caller-supplied run id to correlate with your transcript. Omit to have one generated for this call.
  • integration · string · optionnel
    Stable label for your integration (e.g. your agent/app name). Echo it plus the returned run_id in your own transcript so a run can later be confirmed. Defaults to a generic MCP-discovery label.

  Exemple d'appel

  {"name": "twzrd_demo_gate", "arguments": {"run_id": "texte", "integration": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• twzrd_watch_add≈ 495 tokens

  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. Return the watch row with the computed recheck_after_unix timestamp so your agent knows exactly when to expect a re-call or proactively re-check itself.

  Paramètres, retour & exemple (5)

  Paramètres

  • signature · string · requis
    base58 ed25519 signature made with the payer wallet's key over the twzrd-watch/v1 message for action=register: the seven lines [twzrd-watch/v1, register, str(timestamp), payer_wallet, seller_wallet, webhook_url or '', ''] joined by newlines.
  • timestamp · ? · requis
    Unix seconds used in the signed message (freshness window: 300s).
  • webhook_url · ? · optionnel
    Optional HTTPS URL to POST when intel goes stale.
  • payer_wallet · string · requis
    Your agent wallet address (the watcher).
  • seller_wallet · string · requis
    The seller/merchant wallet to watch.

  Exemple d'appel

  {"name": "twzrd_watch_add", "arguments": {"signature": "texte", "timestamp": "texte", "payer_wallet": "texte", "seller_wallet": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• twzrd_watch_list≈ 348 tokens

  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.

  Paramètres, retour & exemple (3)

  Paramètres

  • signature · string · requis
    base58 ed25519 signature made with the payer wallet's key over the twzrd-watch/v1 message for action=list: the seven lines [twzrd-watch/v1, list, str(timestamp), payer_wallet, '', '', ''] joined by newlines.
  • timestamp · ? · requis
    Unix seconds used in the signed message (freshness window: 300s).
  • payer_wallet · string · requis
    Your agent wallet address.

  Exemple d'appel

  {"name": "twzrd_watch_list", "arguments": {"signature": "texte", "timestamp": "texte", "payer_wallet": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• twzrd_watch_remove≈ 359 tokens

  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.

  Paramètres, retour & exemple (4)

  Paramètres

  • watch_id · integer · requis
    Watch ID from twzrd_watch_list.
  • signature · string · requis
    base58 ed25519 signature made with the payer wallet's key over the twzrd-watch/v1 message for action=remove: the seven lines [twzrd-watch/v1, remove, str(timestamp), payer_wallet, '', '', str(watch_id)] joined by newlines.
  • timestamp · ? · requis
    Unix seconds used in the signed message (freshness window: 300s).
  • payer_wallet · string · requis
    Your agent wallet address (must match the watch owner).

  Exemple d'appel

  {"name": "twzrd_watch_remove", "arguments": {"watch_id": 1, "signature": "texte", "timestamp": "texte", "payer_wallet": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• verify_receipt≈ 990 tokens

  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 and any errors. Pure and offline — no DB, no network, no payment. Pass the entire PaidReceipt object you were issued. Trust is anchored on the published key (or expected_pubkey), NOT on whatever pubkey the receipt carries. max_age_seconds: optional freshness gate (replay protection). Same semantics as the Python library verify_paid_receipt(..., max_age_seconds=...) and the standalone CLI --max-age.

  Paramètres, retour & exemple (4)

  Paramètres

  • receipt · object · requis
    The full signed receipt object (leaf + preimage + signature + signing_pubkey) returned by the paid /v1/intel/trust surface (V7; earlier V5/V6 receipts still verify).
  • expected_pubkey · string · optionnel
    Override the trusted signing pubkey to verify against (default: the published TWZRD receipt key).
  • max_age_seconds · ? · optionnel
    If > 0, reject the receipt if its preimage.timestamp_unix is older than this many seconds (replay/freshness protection, same as CLI --max-age and library).
  • require_signature · boolean · optionnel
    Require and verify the Ed25519 signature (default true). Set false only to inspect an unsigned preview.

  Exemple d'appel

  {"name": "verify_receipt", "arguments": {"receipt": {}}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"valid": "texte", "domain": "texte", "errors": "texte", "leaf_valid": "texte", "provided_leaf": "texte", "signing_pubkey": "texte", "trusted_pubkey": "texte", "recomputed_leaf": "texte", "signature_valid": "texte", "signature_checked": "texte"}}

• verify_root_inputs≈ 777 tokens

  Independent root verification: recomputes the leaves, dataset hash and root from the public root data.

  Paramètres, retour & exemple (3)

  Paramètres

  • root_seq · ? · optionnel
    Specific root sequence to verify. If omitted, best-effort resolution via resource metadata or latest.
  • resource_name · ? · optionnel
    Legacy on-chain protocol resource (deposit/claim/settle) for auto-detection and seq hints.
  • seller_wallet · ? · optionnel
    Seller wallet for legacy on-chain protocol resource detection.

  Exemple d'appel

  {"name": "verify_root_inputs", "arguments": {"root_seq": "texte", "resource_name": "texte", "seller_wallet": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"error": "texte", "status": "texte", "root_seq": "texte", "leaf_count": "texte", "onchain_match": "texte", "leaf_hash_match": "texte", "recomputed_root": "texte", "server_consistent": "texte", "recomputed_dataset_hash": "texte"}}

• verify_x402_settled_claim≈ 598 tokens

  Verify a receipts-ledger settlement; this is evidence, not a spend decision.

  Paramètres, retour & exemple (1)

  Paramètres

  • settlement_tx · string · requis
    Solana transaction signature only. No claim body is accepted. Verifies that signature against x402_payment_receipts and a freshly fetched finalized transaction: match requires the only positive USDC balance change to credit that row's merchant for that row's amount, and the only USDC debit to be that amount from that row's payer, which match returns as payer. Returns match, mismatch, or unknown. Unknown does not block payment.

  Exemple d'appel

  {"name": "verify_x402_settled_claim", "arguments": {"settlement_tx": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"payer": "texte", "digest": "texte", "reason": "texte", "status": "match", "finalized": "texte", "artifact_id": "texte", "settlement_tx": "texte", "session_binding": "texte", "self_attested_merchant": "texte", "merchant_credit_verified": "texte"}}

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://intel.twzrd.xyz/mcp