# TWZRD Agent Intelligence MCP server Trust + receipt layer for x402 agents on Solana: free preflight + paid signed V5 trust receipt. ## Links - Registry page: https://www.getdrio.com/mcp/xyz-twzrd-intel-twzrd-agent-intel - Repository: https://github.com/twzrd-sol/wzrd-final - Website: https://intel.twzrd.xyz ## Install - Command: `uvx twzrd-agent-intel` - Endpoint: https://intel.twzrd.xyz/mcp - Auth: Not captured ## Setup notes - Package: Pypi twzrd-agent-intel v0.2.3 - Environment variable: TWZRD_SIGNAL_SOURCE - Remote endpoint: https://intel.twzrd.xyz/mcp ## Tools - get_readiness_card_tool - Returns an agentic readiness card for a provider or x402 resource. Answers four questions before an agent pays: - can_spend: bool — is it safe to spend on this resource? - trust_score: 0-100 — composite trust signal - proof: dict — V5 receipt upsell path, known wallets, provider reputation - caveats: list[str] — risk factors and negative signals - next_fixes: list[str] — what the provider should fix to improve trust - decision: "allow" | "warn" | "block" - trust_score_basis: str — ALWAYS a free heuristic from the small internal registry + Dexter marketplace signals (dexter_heuristic_registry_v0:*). This is NOT the real 42k+ cross-facilitator x402 corpus. The full corpus (x402_payment_receipts + intel_renorm_v1 + signed V5 receipt) is paid-only, via GET /v1/intel/trust/{wallet}. A caveat always restates this. Also returns: resource_name, seller_wallet, category, price_usdc, paid_deep_dive, paid_price_usdc (see the outputSchema for the full contract). Provide at least one of resource_name or seller_wallet. Endpoint: https://intel.twzrd.xyz/mcp - dexter_preflight - Low-level Dexter preflight check. Returns a richer result object including the upsell path to the paid /v1/intel/trust surface with V5 receipt. Prefer get_readiness_card 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). Endpoint: https://intel.twzrd.xyz/mcp - 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. Endpoint: https://intel.twzrd.xyz/mcp - get_solana_market_visibility_map - Returns the current Solana Market API visibility map (which markets have meaningful on-chain settlement activity and liquidity signals). Returns metadata-market count, on-chain-trade-market count, their overlap (decodable_overlap), coverage_pct, and sample tickers unique to each side. Free discovery tool. On failure returns a structured {status:"error", kind, retryable, detail} envelope (call get_solana_market_status to disambiguate). Endpoint: https://intel.twzrd.xyz/mcp - get_solana_market_orderbook_depth - Returns normalized orderbook depth and liquidity profile for a specific ticker from Solana Market API data. Tickers are prediction-market event tickers (e.g. KXUSNFP-26MAY01), not spot DEX symbols. Free discovery tool. On failure returns a structured {status:"error", kind, retryable, detail} envelope. Endpoint: https://intel.twzrd.xyz/mcp - get_solana_market_shape - Returns market shape / structure signals for a ticker (concentration, venue fragmentation, settlement patterns). Excellent for understanding *how* a market actually trades on-chain. Tickers are prediction-market event tickers (e.g. KXUSNFP-26MAY01). On failure returns a structured {status:"error", kind, retryable, detail} envelope. Endpoint: https://intel.twzrd.xyz/mcp - get_solana_market_onchain_trades_summary - Returns recent on-chain trade and settlement activity. - With `ticker`: raw per-market trade rows from the live by-market feed (/onchain-trades-by-market). - Without `ticker`: aggregated counts across all markets (total_trades_observed, distinct_markets_observed, markets_sample) from /onchain-trades-summary. The two branches return DIFFERENT shapes (raw rows vs aggregated counts). Tickers are prediction-market event tickers (e.g. KXUSNFP-26MAY01). On failure returns a structured {status:"error", kind, retryable, detail} envelope. Endpoint: https://intel.twzrd.xyz/mcp - score_wallet_for_intel - Free discovery: real 0-100 intel score for a wallet from its observed x402 payment history across the broader x402 ecosystem (paid calls, distinct counterparties, volume, recency). 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). For the full corpus-breadth renormalized model (intel_renorm_v1: score_raw, confidence, breadth_factor, wash_factor) + signed portable V5 receipt, pay for the HTTP surface: GET /v1/intel/trust/{wallet} (0.05 USDC). Endpoint: https://intel.twzrd.xyz/mcp - get_top_intel_agents - Leaderboard of the most active paying agents on the network, each with its real intel score. The free discovery flywheel: find credible counterparties by actual on-chain payment activity. 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. Endpoint: https://intel.twzrd.xyz/mcp - 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. Returns a wash_label + reputation tier + wash_flagged bool. Complements score_wallet_for_intel (payer side) with the seller side. Fail-open: a DB gap returns wash_label/tier "unknown" rather than erroring. This is the free seller signal; the paid per-wallet renorm model + signed V5 receipt remain at GET /v1/intel/trust/{wallet} (0.05 USDC). Endpoint: https://intel.twzrd.xyz/mcp - 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. 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. Endpoint: https://intel.twzrd.xyz/mcp - verify_receipt - Free utility: offline-verify a portable V5 trust receipt — 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. Endpoint: https://intel.twzrd.xyz/mcp - 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. Endpoint: https://intel.twzrd.xyz/mcp - 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 are part of the paid intel surface (GET /v1/intel/trust/{wallet}). Fail-open. Endpoint: https://intel.twzrd.xyz/mcp - 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. Endpoint: https://intel.twzrd.xyz/mcp - 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). Endpoint: https://intel.twzrd.xyz/mcp ## Resources Not captured ## Prompts Not captured ## Metadata - Owner: xyz.twzrd.intel - Version: 0.2.3 - Runtime: Pypi - Transports: STDIO, HTTP - License: Not captured - Language: Not captured - Stars: Not captured - Updated: Jun 6, 2026 - Source: https://registry.modelcontextprotocol.io