{"_id":"@itzannetos/x402-tools-claude","_rev":"5-f6add22d2b5d72a41a986de4d6c24301","name":"@itzannetos/x402-tools-claude","dist-tags":{"latest":"2.1.1"},"versions":{"1.0.0":{"name":"@itzannetos/x402-tools-claude","version":"1.0.0","keywords":["claude-code","plugin","mcp","x402","payments","AI","tools"],"author":{"name":"TzannetosGiannis","email":"george@402box.io"},"license":"MIT","_id":"@itzannetos/x402-tools-claude@1.0.0","maintainers":[{"name":"itzannetos","email":"tzannetosg@gmail.com"}],"bin":{"x402-tools-claude":"dist/index.js"},"dist":{"shasum":"a725dd869b232137bba8a01d6716654d648ce071","tarball":"https://registry.npmjs.org/@itzannetos/x402-tools-claude/-/x402-tools-claude-1.0.0.tgz","fileCount":8,"integrity":"sha512-N5SGTYZ4iPHIbcXrlrqL8Ic2Wb44KXMPCoEmrA4wXUl9xrBeODo8akFwd+qzb+695WVp8rzpKodsyW0tsSKvVw==","signatures":[{"sig":"MEUCIQDIhk1hoAT4iZYlthGkTkg3xFhlTGC82VCUPLRzpXesGwIgPwe7PKRm5ioAkVwZNk1OpKDAEV6uNEKdcBsdv7ldFrE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":15343},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"770ba0bb2890dfe6a82bee9764c370b39e3f4043","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"itzannetos","email":"tzannetosg@gmail.com"},"_npmVersion":"10.9.2","description":"Claude Code plugin for x402 payment-gated AI tools on Base network","directories":{},"_nodeVersion":"23.6.1","dependencies":{"zod":"^3.23.8","viem":"^2.21.26","axios":"^1.7.9","dotenv":"^16.4.5","x402-axios":"^1.1.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","typescript":"^5.5.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/x402-tools-claude_1.0.0_1769424945836_0.8694150306280903","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@itzannetos/x402-tools-claude","version":"1.0.1","keywords":["claude-code","plugin","mcp","x402","payments","AI","tools"],"author":{"name":"TzannetosGiannis","email":"george@402box.io"},"license":"MIT","_id":"@itzannetos/x402-tools-claude@1.0.1","maintainers":[{"name":"itzannetos","email":"tzannetosg@gmail.com"}],"bin":{"x402-tools-claude":"dist/index.js"},"dist":{"shasum":"61ea7a5902205a7bb1603afcf9993b6a2e0a3f14","tarball":"https://registry.npmjs.org/@itzannetos/x402-tools-claude/-/x402-tools-claude-1.0.1.tgz","fileCount":8,"integrity":"sha512-XI9arAmKuaZ0DaKvMJ6h7gM515Ve69n1FxbJ9A+K9g5TEfnJRTXIC9jbaU4NzPvKyZ5e0eFpPeyzCGtGFKyILQ==","signatures":[{"sig":"MEYCIQDbmwHc/jHNQSBhMNP+sxCkb3VvAnOEX9vAqjhlv2NOWwIhAP5ZcFUL3ZWXKZxgEmoSF0ndB6DbKZDQJInFpVuyda4H","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":15370},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"bc5f154b9debf8faf8d7070c80887f309cfb15ae","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"itzannetos","email":"tzannetosg@gmail.com"},"_npmVersion":"10.9.2","description":"Claude Code plugin for x402 payment-gated AI tools on Base network","directories":{},"_nodeVersion":"23.6.1","dependencies":{"zod":"^3.23.8","viem":"^2.21.26","axios":"^1.7.9","dotenv":"^16.4.5","x402-axios":"^1.1.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","typescript":"^5.5.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/x402-tools-claude_1.0.1_1769425383788_0.9708690294995845","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"@itzannetos/x402-tools-claude","version":"2.0.0","keywords":["claude-code","plugin","x402","payments","AI","tools"],"author":{"name":"TzannetosGiannis","email":"george@402box.io"},"license":"MIT","_id":"@itzannetos/x402-tools-claude@2.0.0","maintainers":[{"name":"itzannetos","email":"tzannetosg@gmail.com"}],"bin":{"x402-tools":"dist/cli.js"},"dist":{"shasum":"93f10e8aff0ffb702fead0d552a7cbc3b1090774","tarball":"https://registry.npmjs.org/@itzannetos/x402-tools-claude/-/x402-tools-claude-2.0.0.tgz","fileCount":10,"integrity":"sha512-BdnGbK9HBABkJf/1X1PgZsBywalNAPCWQxY/cRMOggdfb82TQzvLGJajOxCS+stSGiU7R7IynBaWq0yOnRwWFQ==","signatures":[{"sig":"MEYCIQCeYh/+82L8CjVoNspD4ajbHI1BCe9J46eN1C13t4G4ZQIhAIaXNAjWZnl0045mzv6/ZCYFFgsrqhAh4QBxhyZaQH+D","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1690197},"main":"dist/cli.js","gitHead":"e8acfb16581b7e7f739caf59aaf2b6db2b0dd31b","scripts":{"dev":"tsx src/cli.ts","build":"esbuild src/cli.ts --bundle --platform=node --target=node18 --format=cjs --outfile=dist/cli.js --banner:js='#!/usr/bin/env node'","start":"node dist/cli.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"itzannetos","email":"tzannetosg@gmail.com"},"_npmVersion":"10.9.2","description":"Claude Code plugin for x402 payment-gated AI tools on Base network","directories":{},"_nodeVersion":"23.6.1","dependencies":{"viem":"^2.21.26","axios":"^1.7.9","dotenv":"^16.4.5","x402-axios":"^1.1.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","esbuild":"^0.20.2","typescript":"^5.5.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/x402-tools-claude_2.0.0_1769426291220_0.6259436021519615","host":"s3://npm-registry-packages-npm-production"}},"2.1.0":{"name":"@itzannetos/x402-tools-claude","version":"2.1.0","keywords":["claude-code","plugin","x402","payments","AI","tools"],"author":{"name":"TzannetosGiannis","email":"george@402box.io"},"license":"MIT","_id":"@itzannetos/x402-tools-claude@2.1.0","maintainers":[{"name":"itzannetos","email":"tzannetosg@gmail.com"}],"bin":{"x402-tools":"dist/cli.js"},"dist":{"shasum":"344cec3d17c0909343daf94e4aa303066264a3eb","tarball":"https://registry.npmjs.org/@itzannetos/x402-tools-claude/-/x402-tools-claude-2.1.0.tgz","fileCount":11,"integrity":"sha512-61S5RHycCD3gr3tYGf4G4xFOvtr6PZg2kCF822/+gy1M7epQ1GqjwqaSDchbGXkr9TaK1EbM+ns9CmfxKOksUw==","signatures":[{"sig":"MEUCIQCbSmhTWhGVAwybpx6SO28tTw+siu/gLQ4U+qkEJJl5vgIgSnByLr44iFukESeZa20YI7NEcxeycHDz672UkwrFJio=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1693220},"main":"dist/cli.js","gitHead":"1f3bf10c0f1ac09dfd94d6deec97736555d969aa","scripts":{"dev":"tsx src/cli.ts","build":"esbuild src/cli.ts --bundle --platform=node --target=node18 --format=cjs --outfile=dist/cli.js --banner:js='#!/usr/bin/env node'","start":"node dist/cli.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"itzannetos","email":"tzannetosg@gmail.com"},"_npmVersion":"10.9.2","description":"Claude Code plugin for x402 payment-gated AI tools on Base network","directories":{},"_nodeVersion":"23.6.1","dependencies":{"viem":"^2.21.26","axios":"^1.7.9","dotenv":"^16.4.5","x402-axios":"^1.1.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","esbuild":"^0.20.2","typescript":"^5.5.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/x402-tools-claude_2.1.0_1769612306711_0.19445881726205005","host":"s3://npm-registry-packages-npm-production"}},"2.1.1":{"name":"@itzannetos/x402-tools-claude","version":"2.1.1","description":"Claude Code plugin for x402 payment-gated AI tools on Base network","main":"dist/cli.js","bin":{"x402-tools":"dist/cli.js"},"scripts":{"build":"esbuild src/cli.ts --bundle --platform=node --target=node18 --format=cjs --outfile=dist/cli.js --banner:js='#!/usr/bin/env node'","start":"node dist/cli.js","dev":"tsx src/cli.ts","prepublishOnly":"npm run build"},"keywords":["claude-code","plugin","x402","payments","AI","tools"],"author":{"name":"TzannetosGiannis","email":"george@402box.io"},"license":"MIT","dependencies":{"axios":"^1.7.9","dotenv":"^16.4.5","viem":"^2.21.26","x402-axios":"^1.1.0"},"devDependencies":{"@types/node":"^20.0.0","esbuild":"^0.20.2","tsx":"^4.19.0","typescript":"^5.5.0"},"_id":"@itzannetos/x402-tools-claude@2.1.1","gitHead":"f34ff0c56458544f12af3e3178a8e33d55b6d29e","_nodeVersion":"23.6.1","_npmVersion":"10.9.2","dist":{"integrity":"sha512-2mIpxGgkSojCxKYNfkuVxD2fiyrgmeEEOuoYgiHsTWOTsc01h6C/NQKav9M/KoxwxZ+qOHS4IIqOoXvH1U8FUg==","shasum":"e95095fd663754af37e58e20e6ddb841be93290d","tarball":"https://registry.npmjs.org/@itzannetos/x402-tools-claude/-/x402-tools-claude-2.1.1.tgz","fileCount":11,"unpackedSize":1693608,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQC1Spp6z6D+6sUl8ZmVeIWefVIp7iz6fnf5KRZe5wwU0QIgOzN5R8yf8uiMQIhKwk80uDJLZQDdL+xKC8ZdwuRlaj4="}]},"_npmUser":{"name":"itzannetos","email":"tzannetosg@gmail.com"},"directories":{},"maintainers":[{"name":"itzannetos","email":"tzannetosg@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/x402-tools-claude_2.1.1_1769612493341_0.8939466169128871"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-26T10:55:45.584Z","modified":"2026-01-28T15:01:33.700Z","1.0.0":"2026-01-26T10:55:45.969Z","1.0.1":"2026-01-26T11:03:03.930Z","2.0.0":"2026-01-26T11:18:11.390Z","2.1.0":"2026-01-28T14:58:26.937Z","2.1.1":"2026-01-28T15:01:33.591Z"},"author":{"name":"TzannetosGiannis","email":"george@402box.io"},"license":"MIT","keywords":["claude-code","plugin","x402","payments","AI","tools"],"description":"Claude Code plugin for x402 payment-gated AI tools on Base network","maintainers":[{"name":"itzannetos","email":"tzannetosg@gmail.com"}],"readme":"# X402 Tools Plugin for Claude Code\n\nPayment-gated AI tools using x402 micropayments on Base network. Access powerful X/Twitter search and OSINT research tools directly from Claude Code via skills.\n\n## Features\n\n### X Search ($0.05 USDC/request)\nAI-powered X/Twitter search agent for:\n- Real-time trends and breaking news\n- Social media sentiment analysis\n- Viral content tracking\n- Public opinion research\n\n### Find People ($0.15 USDC/request)\nOpen Source Intelligence (OSINT) agent for:\n- Professional background research\n- Career timeline verification\n- Due diligence on potential hires/partners\n- Competitive intelligence on industry leaders\n- Investor research on startup founders\n\n### Alpha Finder ($0.03 USDC/request)\nMarket Oracle for prediction market intelligence:\n- Polymarket event research\n- Kalshi market analysis\n- Searches web, GitHub, Reddit, and X\n- Probability assessments and market sentiment\n- Arbitrage opportunity identification\n\n## Prerequisites\n\n- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) v1.0.33+\n- Ethereum wallet with USDC on Base network\n- **NO gas needed** - x402 handles transaction costs\n\n## Installation\n\n### Option 1: Install via Claude Code (Recommended)\n\nInside Claude Code, run:\n\n```\n/plugin marketplace add TzannetosGiannis/x402-tools-claude\n/plugin install x402-tools@x402-tools-claude\n```\n\n### Option 2: Install from Source\n\n```bash\ngit clone https://github.com/TzannetosGiannis/x402-tools-claude.git\ncd x402-tools-claude\nnpm install\nnpm run build\n```\n\nThen load the plugin:\n\n```bash\nclaude --plugin-dir .\n```\n\n## Configuration\n\nYou need to provide your Ethereum private key to sign payment transactions. The plugin checks for the key in this order:\n\n### Option 1: Configuration File (Recommended)\n\nCreate `.claude/x402-tools.json` in your project directory:\n\n```json\n{\n  \"private_key\": \"your_private_key_here\"\n}\n```\n\n### Option 2: Environment Variable\n\nSet `X402_PRIVATE_KEY` in your `.env` file:\n\n```bash\nX402_PRIVATE_KEY=your_private_key_here\n```\n\n> **Security Warning**:\n> - Never commit your private key to version control\n> - Use a dedicated wallet with only the USDC you need for testing\n> - The `.claude/x402-tools.json` file is automatically gitignored\n\n## Usage\n\nOnce the plugin is installed, Claude will have access to two new skills that it can use automatically:\n\n### X Search\nJust ask Claude to search Twitter/X:\n```\n\"What are people saying about AI agents on Twitter?\"\n```\n\nClaude will use the `x-search` skill automatically.\n\n### Find People\nAsk Claude to research someone:\n```\n\"Find information about the founder of Ethereum\"\n```\n\nClaude will use the `find-people` skill automatically.\n\n## How It Works\n\n```\n┌─────────────┐     ┌─────────────┐     ┌─────────────┐     ┌─────────────┐\n│ Claude Code │────▶│   Skills    │────▶│ x402-axios  │────▶│ 402box.io   │\n│             │     │ (npx CLI)   │     │ (payment)   │     │ (AI agents) │\n└─────────────┘     └─────────────┘     └─────────────┘     └─────────────┘\n                           │\n                           ▼\n                    ┌─────────────┐\n                    │ Base Chain  │\n                    │ (USDC pay)  │\n                    └─────────────┘\n```\n\n1. You ask Claude to search Twitter or research a person\n2. Claude recognizes the task and uses the appropriate skill\n3. The skill runs the CLI via npx\n4. The x402-axios interceptor automatically signs a USDC payment\n5. The 402box.io API processes your request\n6. Results are returned to Claude\n\n## CLI Usage (Direct)\n\nYou can also use the CLI directly:\n\n```bash\n# X/Twitter search\nnpx @itzannetos/x402-tools-claude x-search \"AI trends 2024\"\n\n# Find people\nnpx @itzannetos/x402-tools-claude find-people \"Vitalik Buterin\"\n\n# Alpha finder (prediction markets)\nnpx @itzannetos/x402-tools-claude alpha-finder \"Bitcoin 100k prediction market odds\"\n```\n\n## Troubleshooting\n\n### \"X402 private key missing\"\nMake sure you've configured your private key in either `.claude/x402-tools.json` or the `X402_PRIVATE_KEY` environment variable.\n\n### \"Not enough USDC in your wallet\"\nYour wallet needs USDC on the Base network. You can:\n1. Bridge USDC from Ethereum mainnet to Base\n2. Buy USDC on Base through an exchange\n3. Use a faucet for testing (if available)\n\n### Skills not appearing\n1. Make sure you're using Claude Code v1.0.33 or later\n2. Check that the plugin is installed: `/plugin` → Installed tab\n3. Try reinstalling the plugin\n\n## Contributing\n\nContributions are welcome! Please open an issue or submit a pull request.\n\n## Support\n\n- GitHub Issues: [Report bugs](https://github.com/TzannetosGiannis/x402-tools-claude/issues)\n- Email: george@402box.io\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n## Credits\n\nBuilt on top of the [x402 protocol](https://402box.io) for micropayments on Base network.\n","readmeFilename":"README.md"}