Trust + receipt layer that Solana agents call before and after paying over x402 — free preflight readiness cards, paid signed trust receipts, and a wash/Sybil-resistant agent reputation corpus. MCP + HTTP.
Project description
twzrd-agent-intel
The trust + receipt layer that Solana agents call before and after paying over x402.
Before an autonomous agent pays a stranger's API, it should be able to answer one
question: should I pay this, and what proof will I get? twzrd-agent-intel answers
it. Free preflight readiness cards score any x402 resource on a wash/Sybil-resistant
reputation corpus; a paid trust endpoint returns a portable, offline-verifiable
signed v6 receipt. Live on Solana mainnet.
Where this sits
Autonomous agents hold wallets and pay strangers over x402 — no human gut-check. At pay time a wash seller looks identical to an honest one. TWZRD is the wedge that scores the seller before the agent signs.
AGENTS (spend) 70k payers · 866 real shoppers (ecosystem-observed — NOT TWZRD revenue)
│ "should I pay this seller?" ── no reputation rail exists
v
┌──────────────────── TWZRD TRUST LAYER ────────────────────┐
│ POST /v1/intel/preflight → decision = allow | warn | BLOCK │
│ + trust 0-100 + caveats │
│ CORPUS moat (cross-facilitator x402 graph) + paid v6 receipt│
│ CONSUMABLE: plugin-trustgate (npm) · MCP · PyPI · verifier │
└──────────────────────────────┬──────────────────────────────┘
allow / warn │ BLOCK
│ │ │
v │ v
RAILS THAT SETTLE (PayAI · openfacilitator · x402) ╳ agent ABORTS
│
v
SELLERS honest hub wash-shaped tail controlled rig
7uh2ibD1 34w53Ukh FTNMk
→ WARN → BLOCK → BLOCK
(clean) (91% captive; a real (test fleet)
shopper paid it $7.9k)
Live proof of organic intercept. Flagged seller 34w53Ukh (real, non-TWZRD;
wash_flagged, 91.4% captive payers, a real shopper paid it ~$7,957) → decision=block
(trust 30): an agent running the guard aborts. Clean control 7uh2ibD1 → warn
(trust 45): it proceeds. The gate discriminates on live, unfunded sellers.
Honest frontier. Trust gates the buyer preflight today (proven, 100% agent-driven).
The settle-side hook (onBeforeSettle) is next. One real agent installing the guard =
demand unlocked.
Try it now (no install, no signup)
curl -s -X POST https://intel.twzrd.xyz/v1/intel/preflight \
-H "Content-Type: application/json" \
-d '{
"seller_wallet": "6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P",
"agent_intent": "swap_quote"
}'
Returns a ReadinessCard with decision (allow / warn / block), trust_score,
can_spend, caveats, and the path to the paid deep-dive receipt.
Install
pip install twzrd-agent-intel
Wire into Claude Code / Claude Desktop / Cursor (60 seconds)
Add to your MCP config and restart. The remote server runs the live large cross-facilitator corpus — no env vars, no local server, no configuration:
{
"mcpServers": {
"twzrd-agent-intel": {
"type": "streamable-http",
"url": "https://intel.twzrd.xyz/mcp"
}
}
}
After restart your agent sees 17 tools. The most useful one to call first:
get_readiness_card_tool(seller_wallet="6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P")
That's the full install. No database, no keypair, no USDC needed for the free tools.
18 MCP tools
Free preflight + discovery (no payment, no auth):
get_readiness_card_tool— primary ReadinessCarddexter_preflight— lower-level preflight + spend recommendationscore_wallet_for_intel— wallet intel scoreget_top_intel_agents— agent leaderboard discovery
Free corpus reputation + receipts:
get_provider_reputation— inbound corpus reputation for a seller/merchant walletis_wash_fleet— circular-flow / wash-fleet check on a walletget_facilitator_footprint— which x402 facilitators a payer settled throughget_counterparties— capped teaser: top merchants a wallet pays (limit ≤ 25)score_wallets_batch— score up to 25 wallets in one callcompare_wallets— side-by-side intel for two walletsverify_receipt— offline v5/v6 receipt verification (recompute leaf + check Ed25519 sig)verify_root_inputs— independently recompute a published attention root and assert against the on-chain commitmentevaluate_x402_resource— evaluate whether a resource server deserves payment: receipt pipeline quality, guard coverage, and spend recommendation
Solana market intel (free over MCP; $0.03 USDC each over HTTP x402):
get_solana_market_visibility_mapget_solana_market_orderbook_depthget_solana_market_shapeget_solana_market_onchain_trades_summaryget_solana_market_status
The paid trust receipt (GET /v1/intel/trust/{pubkey}, 0.05 USDC over x402) is also
available over HTTP with a portable signed v6 receipt you can verify offline.
HTTP API
# Free preflight (no payment required)
curl -s -X POST https://intel.twzrd.xyz/v1/intel/preflight \
-H "Content-Type: application/json" \
-d '{"seller_wallet": "<pubkey>", "agent_intent": "swap_quote"}'
# Paid trust receipt (0.05 USDC over x402 — use an x402-capable client)
curl -s https://intel.twzrd.xyz/v1/intel/trust/<pubkey>
# → 402 Payment Required with payment requirements if no x402 header
# Free sample receipt for offline verify testing
curl -s https://intel.twzrd.xyz/v1/receipts/example
- OpenAPI: https://intel.twzrd.xyz/openapi.json
- Agent card: https://intel.twzrd.xyz/.well-known/agent-card.json
- MCP card: https://intel.twzrd.xyz/.well-known/mcp-server.json
Self-hosting
Note: Running
twzrd-agent-intel-mcplocally serves from a small static research registry by default — not the live large cross-facilitator corpus. Use the remote MCP above for real data. Self-host only if you need to run behind a firewall or extend the server.
# Local MCP stdio (static demo data by default)
twzrd-agent-intel-mcp
# Local HTTP server
uvicorn twzrd_agent_intel.server_http:app --port 8001
Point a self-hosted instance at live data with environment variables:
TWZRD_SIGNAL_SOURCE |
What it does |
|---|---|
artifacts |
Aggregate your own settlement volume from TWZRD_ARTIFACTS_DIR |
bazaar |
Pull the live cross-facilitator x402 catalog (CDP Bazaar) |
What makes the score trustworthy
- Wash/Sybil-resistant: circular-flow- and wash-resistant scoring over a large cross-facilitator corpus.
- Honest basis: trust components are renormalized (
score_version intel_renorm_v1) so arbitrary wallets aren't penalized for lacking TWZRD-native execution history. - Verifiable: every paid response carries a signed v6 receipt you can verify offline
at
/v1/receipts/verifywithout trusting our server.
More TWZRD surfaces
- Verify a live receipt offline in one command (TypeScript SDK, no wallet):
npx @wzrd_sol/sdk - OpenClaw agents: install the skill that wraps this API into a pre-payment check:
clawhub install twzrd-trust
License
MIT
- Public leaderboard: https://twzrd.xyz/leaderboard
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file twzrd_agent_intel-0.5.3.tar.gz.
File metadata
- Download URL: twzrd_agent_intel-0.5.3.tar.gz
- Upload date:
- Size: 232.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.10.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c677a05c55e7251a8df2c63b92f18edf7993fed9de159e3db46efb52013ad83a
|
|
| MD5 |
36161c38eeb1aaace5a70e6a679518a4
|
|
| BLAKE2b-256 |
77562d77da48a44e66e34489e7119c72be6bf4c5b341bd62700955a2d1a2ef4e
|
File details
Details for the file twzrd_agent_intel-0.5.3-py3-none-any.whl.
File metadata
- Download URL: twzrd_agent_intel-0.5.3-py3-none-any.whl
- Upload date:
- Size: 250.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.10.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
79ed7d3283d820d0a21d29eb7174901f037ecf0be43c65be9a23de8e82ad55b4
|
|
| MD5 |
476cb4c4c5e3ae568730e0c9fe84624a
|
|
| BLAKE2b-256 |
c1a6714170a908b078926d5f17a35bc3cd334843d21558c908582a4b160d3f3c
|