Agent Wormhole MCP
An open-source security layer for AI agents that prevents prompt injection, config tampering, and unauthorized payments. It includes hooks to inspect tool usage, baseline file integrity, and an x402 payment guard that refuses transactions not matching a quoted price.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
Checks and signals
Each line is separate evidence, not a trust score.
- Popularity 5 GitHub stars
What you can do with it
- Inspect config writes before they land to prevent persistence attacks
- Refuse to sign payments that do not match the x402 quote
- Scan on-chain memo text for hidden instructions
- Baseline and verify config file integrity
Source and maintenance
- Last repository push
- Latest release
- v0.1.2
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
wormhole-x402 0.8.0
{
"version": "0.8.0",
"transport": "stdio",
"identifier": "wormhole-x402",
"runtimeHint": "npx",
"registryType": "npm",
"environmentVariables": [
{
"name": "WORMHOLE_API_KEY",
"format": "string",
"description": "Optional. Hosted-mode key from dashboard.agentwormhole.com: adds URL checks with change history, and the operator's spend policy (budgets, approvals, kill switch) on payments."
},
{
"name": "WORMHOLE_VERIFY_URL",
"format": "string",
"description": "Optional. Override the hosted verifier endpoint (default https://dashboard.agentwormhole.com/api/v1/verify)."
},
{
"name": "WORMHOLE_ADDRESS_LEDGER",
"format": "string",
"description": "Optional. Path to the address-provenance ledger written by wormhole-guard's readguard hook (default ~/.wormhole/addresses.jsonl)."
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · repository · passed · metadata changed · updated
- · backfill · recorded · Pre-expansion baseline; unobserved rich metadata remains unknown
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
{
"mcpServers": {
"agent-wormhole-mcp": {
"command": "npx",
"args": [
"-y",
"wormhole-x402@0.8.0"
],
"env": {
"WORMHOLE_API_KEY": "<YOUR_WORMHOLE_API_KEY>",
"WORMHOLE_VERIFY_URL": "<YOUR_WORMHOLE_VERIFY_URL>",
"WORMHOLE_ADDRESS_LEDGER": "<YOUR_WORMHOLE_ADDRESS_LEDGER>"
}
}
}
}Cline
{
"mcpServers": {
"agent-wormhole-mcp": {
"command": "npx",
"args": [
"-y",
"wormhole-x402@0.8.0"
],
"env": {
"WORMHOLE_API_KEY": "<YOUR_WORMHOLE_API_KEY>",
"WORMHOLE_VERIFY_URL": "<YOUR_WORMHOLE_VERIFY_URL>",
"WORMHOLE_ADDRESS_LEDGER": "<YOUR_WORMHOLE_ADDRESS_LEDGER>"
}
}
}
}VS Code
{
"servers": {
"agent-wormhole-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"wormhole-x402@0.8.0"
],
"env": {
"WORMHOLE_API_KEY": "<YOUR_WORMHOLE_API_KEY>",
"WORMHOLE_VERIFY_URL": "<YOUR_WORMHOLE_VERIFY_URL>",
"WORMHOLE_ADDRESS_LEDGER": "<YOUR_WORMHOLE_ADDRESS_LEDGER>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"agent-wormhole-mcp": {
"command": "npx",
"args": [
"-y",
"wormhole-x402@0.8.0"
],
"env": {
"WORMHOLE_API_KEY": "<YOUR_WORMHOLE_API_KEY>",
"WORMHOLE_VERIFY_URL": "<YOUR_WORMHOLE_VERIFY_URL>",
"WORMHOLE_ADDRESS_LEDGER": "<YOUR_WORMHOLE_ADDRESS_LEDGER>"
}
}
}
}Let your agent find its tools
Find servers like Agent Wormhole MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.