Agent Wormhole
Integration guide: payment safety, policy, confirmed top-ups and launch attestations.
接入你的智能体
發布者自己的指令。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
npx -y [email protected]Claude Code 沒有本機指令的安裝連結。複製下方指令並在終端機中執行。
claude mcp add wormhole-x402 -- npx -y wormhole-x402@0.11.0在終端機中執行。
{ "mcpServers": { "wormhole-x402": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
Integration guide: payment safety, policy, confirmed top-ups and launch attestations.
Refuse an agent payment (Solana or EVM x402) that does not match what the agent was quoted, and scan the quote's own text for prompt injection before the model reads it. Offline, no RPC.
The security layer for agentic commerce.
AI agents now read instructions they did not write, sign payments a merchant priced, and buy tokens whose metadata an attacker typed. All three are the same problem — untrusted text reaching a model that acts — and this is one stack that covers all three:
Everything verifiable is free forever — badges, attestations, signatures, verdicts. The metered work is what costs, in USDC over x402, and an agent can pay for itself with no human in the loop.
pipx install wormhole-guard
wormhole scan ~/your-project --blast-radius # what is there now
wormhole init ~/your-project # harden + baseline (dry run until --apply)
CRITICAL SessionStart hook executes a script from an unusual path [AUTOSTART-002]
.claude/settings.json
`node .github/setup.js` runs unprompted on SessionStart. This survives
uninstalling the package that planted it.
No account, no API token, no network call. Your CLAUDE.md never leaves the
machine. Then wire the three hooks — what arrives, what leaves, what persists:
wormhole readguard --install # inbound: fetched pages, shell output, MCP responses
wormhole outbound --install # outbound: refuse to pass a payload on
wormhole guard --install # writes: the PreToolUse hook
Claude Code, Cursor, any MCP host — five tools, including check_token
(check a token launch before reading its metadata) and check_before_use
(check a page, manifest, or listing before trusting it):
{
"mcpServers": {
"wormhole": {
"command": "npx",
"args": ["-y", "wormhole-x402", "mcp"],
"env": { "WORMHOLE_API_KEY": "awk_..." }
}
}
}
Without a key the tools run locally and read the free registry; with one, unobserved tokens are scanned on demand.
No GitHub, no browser, no human. Attach an x402 payment (USDC on Base or Solana) and the new tenant is born funded:
curl -X POST https://dashboard.agentwormhole.com/api/v1/register \
-H "content-type: application/json" \
-H "X-PAYMENT: <base64 x402 payment>" \
-d '{"name":"my trading agent"}'
# → { "api_key": "awk_…", "balance_micro_usdc": "1000000", ... }
Registering without a payment also works — the key starts at zero and any paid call answers 402 with an exact quote for both rails. Sign EVM authorizations with hours of validity, not minutes: an expired authorization is money nobody can collect.
# then: check any token before your agent reads it (free)
curl https://dashboard.agentwormhole.com/api/v1/token/4663/0x… # Robinhood Chain
curl https://dashboard.agentwormhole.com/api/v1/token/0/<base58> # Solana
# scan one on demand ($0.01) — metadata plus every link it ships with
curl -X POST https://dashboard.agentwormhole.com/api/v1/scan \
-H "x-api-key: awk_…" -H "content-type: application/json" \
-d '{"network":"solana","address":"<mint>"}'
# put a token's website on a continuous watch (re-checks bill at $0.005)
curl -X POST https://dashboard.agentwormhole.com/api/v1/watch \
-H "x-api-key: awk_…" -H "content-type: application/json" \
-d '{"kind":"url","subject":"https://token-site.example"}'
Scan at creation, before the token exists; mint with the same bytes and the pre-attestation chains to the on-chain one:
curl -X POST https://dashboard.agentwormhole.com/api/v1/scan \
-H "x-api-key: awk_…" -H "content-type: application/json" \
-d '{"bundle":{"name":"…","symbol":"…","description":"…"}}'
<a href="https://dashboard.agentwormhole.com/t/4663/{address}">
</a>
The badge is live: green check while clean, amber on a metadata change, red on findings, grey when stale — and it never says "safe", because that is not what is being attested. Full kit with 402 handling and offline signature verification: docs.agentwormhole.com#launchpad-kit.

Prepaid via x402: USDC on Base or Solana, or USDG on Robinhood Chain. No subscription, no minimum. When credit runs out the endpoint answers 402 with an exact, signed-payable quote.
All of this revenue buys back $WORM on Robinhood Chain, and the $WORM bought is burned. The free tools never need the token. The wallets, and how Wormbook's fees are used, are in the docs.
June 2026: the Miasma worm disabled 73 Microsoft GitHub repositories — not
with a memory bug, but by writing agent configuration: SessionStart hooks,
.cursor/rules, folderOpen tasks. The persistence survives npm uninstall
and survives reinstalling the agent. Your vendor protects its own
settings.json; nothing protects your CLAUDE.md — and by default your agent
can write to it. (Threat model, with the Dataminr
analysis and the NDSS 2026 AgentWorm paper: 82% attack success via skill
poisoning, 0% under sandbox isolation, and 0 of 82 public configs had it on.)
The same asymmetry runs through payments and launches. A payment to an
attacker's address simulates perfectly — so wormhole-x402 checks the
transaction against the merchant's own 402 quote, a channel the model never
touches. A token launch is attacker-controlled text that reaches a trading
agent before any moderation exists — the launch layer's first live scan
caught a token impersonating "STOCK" with an invisible zero-width character.
Every launch on Robinhood Chain is now observed within minutes, attested
with an ed25519 signature over its exact bytes, and re-checked daily; a
metadata edit — on-chain or in the IPFS JSON — voids the attestation by
arithmetic, publicly, with a counter.
What the words never say is "safe". Verdicts are clean_by_rules or
findings; badges say checked, changed, or findings. Rules are the evadable
layer and are labelled as such — the load-bearing parts are hashes,
signatures, and baselines, which do not care how a payload is worded.
This is an integrity monitor for the text an agent acts on. The parts that matter do not care what the payload says.
The control that drives infection to zero is sandbox isolation, and it lives in your agent framework, not here — per Anthropic's own docs it does not cover Read/Edit/Write by default. This tool makes that gap impossible to overlook.
Stated plainly, because a security tool that overclaims is worse than none:
clean_by_rules is not a safety certificate, abstain is not an
all-clear, and a checked token can still rug. Contract code, tokenomics,
and teams are out of scope, on purpose.watch reads transcripts after the fact; nothing here removes an
infection from a running agent or contains an agent running as root.The local tools send nothing anywhere: no account, no telemetry, no network call at any point. In full: docs/limits.md.
Runnable examples, each with its actual output pasted in: claude-code-hooks · x402-solana · x402-evm · quote-scanning · ci-github-action · agent-fleet
Published research, every number reproducible: the launch layer · 26,844 MCP servers scanned · the agentic-trading injection · ACP seller re-pricing · Solana memo base rate
Every new detection rule ships with a benign twin — a file discussing the same attack without being one. If the rule fires on the twin, it does not ship. See CONTRIBUTING.md and SECURITY.md.
Apache 2.0.
Refuse an agent payment (Solana or EVM x402) that does not match what the agent was quoted, and scan the quote's own text for prompt injection before the model reads it. Offline, no RPC.
{ "mcpServers": { "wormhole-x402": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Wormhole X402 透過 stdio 在本機執行。
上次檢查時間:2026-11-16。 Refuse an agent payment (Solana or EVM x402) that does not match what the agent was quoted, and scan the quote's own text for prompt injection before the model reads it. Offline, no RPC.