{
  "markdown": "# ToolFi — API Marketplace for AI Agents\n\n> \"The next unicorn is an API marketplace for agents... where the right API should be selected by Claude and connected automatically\" — [@auralix4](https://twitter.com/auralix4)\n\nAPI marketplaces exist, but they're built for human developers. ToolFi is built for **AI workflows** — agents discover, select, and pay for APIs automatically, without human intervention.\n\n🌐 **[Website](https://toolfi.dev)** · 📡 **[API](https://toolfi.vercel.app)** · 📜 **[Contract](https://sepolia.basescan.org/address/0x3D6C600799C67b45061eCAbfD5bBF8ef57Dded88)** · 🗺️ **[Roadmap](ROADMAP.md)**\n\n## The Problem\n\nAI agents need external data (prices, security checks, routes). Current solutions:\n- **RapidAPI, etc.** — Built for humans. Agents can't browse and click \"Subscribe\"\n- **Hardcoded keys** — Security risk, doesn't scale\n- **Manual integration** — Every new tool needs human setup\n\n## The Solution\n\n**ToolFi** = APIs that agents can discover and use autonomously.\n\n1. **Discovery** — Agents find tools via `.well-known/mcp.json`, MCP registries, semantic search\n2. **Selection** — Rich descriptions help agents pick the right tool\n3. **Payment** — USDC on Base, no API keys, just pay and use\n4. **Data** — Structured responses optimized for LLM consumption\n\n## How It Works\n\n```\nAgent → GET /api/price?symbol=ETH\n                ↓\nServer → 402 Payment Required\n         { toolId, price, paymentInstructions }\n                ↓\nAgent → USDC.approve() → Registry.payForCall(toolId)\n                ↓\nAgent → Retry with X-Payment-Tx header\n                ↓\nServer → Verify on-chain → Return data\n```\n\n## Available Tools\n\n| Tool | Price | What it does |\n|------|-------|--------------|\n| Crypto Price Oracle | 0.001 USDC | Real-time prices via DexScreener |\n| Rug Pull Scanner | 0.003 USDC | Token security via GoPlus |\n| Bridge Router | 0.002 USDC | Cross-chain routes via Li.Fi |\n| DeFi Yield Finder | 0.002 USDC | Best yields via DefiLlama |\n| Swap Router | 0.002 USDC | DEX aggregation via Li.Fi |\n| Trending Coins | 0.001 USDC | What's hot via CoinGecko |\n| Protocol TVL | 0.001 USDC | DeFi TVL data via DefiLlama |\n| Gas Tracker | 0.0005 USDC | Gas prices for EVM chains |\n| Wallet Risk Scanner | 0.005 USDC | Address risk analysis |\n| News Digest | 0.002 USDC | Crypto news summary |\n\n## Integration Options\n\n### Option 1: HTTP API (Any Agent)\n\n```bash\n# Pay on-chain, then call with payment proof\ncurl -H \"X-Payment-Tx: 0x...\" \"https://toolfi.vercel.app/api/price?symbol=ETH\"\n```\n\n### Option 2: MCP Server (Claude Desktop)\n\n```bash\ncd mcp-server\nuv venv && source .venv/bin/activate\nuv pip install -e .\n```\n\nAdd to Claude Desktop config:\n```json\n{\n  \"mcpServers\": {\n    \"toolfi\": {\n      \"command\": \"/path/to/.venv/bin/python\",\n      \"args\": [\"-m\", \"src.server\"],\n      \"cwd\": \"/path/to/mcp-server\"\n    }\n  }\n}\n```\n\nThen ask Claude: *\"Check the security of token 0x... on Base\"*\n\n## For Tool Creators\n\nPublish your API and earn USDC:\n\n```bash\ncast send $REGISTRY \\\n  \"registerTool(string,string,string,uint256)\" \\\n  \"My Tool\" \"https://api.example.com\" \"Description\" 10000 \\\n  --rpc-url https://sepolia.base.org --private-key $KEY\n```\n\nPrice in 6 decimals: `10000` = $0.01/call\n\nWithdraw earnings:\n```bash\ncast send $REGISTRY \"withdraw()\" --rpc-url https://sepolia.base.org\n```\n\n## Contract\n\n| | |\n|-|-|\n| Chain | Base Sepolia (84532) |\n| USDC | `0x036CbD53842c5426634e7929541eC2318f3dCF7e` |\n| Registry | [`0x3D6C600799C67b45061eCAbfD5bBF8ef57Dded88`](https://sepolia.basescan.org/address/0x3D6C600799C67b45061eCAbfD5bBF8ef57Dded88) |\n\n## Project Structure\n\n```\ntoolfi/\n├── api/           # Vercel serverless API\n├── web/           # Next.js frontend\n├── mcp-server/    # Python MCP server for Claude\n├── src/           # Solidity contracts\n├── skill/         # OpenClaw skill spec\n└── script/        # Deployment scripts\n```\n\n## Development\n\n```bash\n# Contracts\nforge build\nforge test -v\n\n# API\ncd api && npm install && npm start\n\n# MCP Server\ncd mcp-server && uv pip install -e . && python -m src.server\n```\n\n## Roadmap\n\n- [x] Core registry contract\n- [x] Web API with 10 tools\n- [x] MCP Server for Claude Desktop\n- [ ] Mainnet deployment\n- [ ] Creator dashboard\n- [ ] Agent SDK (Python/TypeScript)\n- [ ] Idempotency keys\n- [ ] Usage analytics\n\n## License\n\nMIT\n",
  "bytes": 4304,
  "sha": "e6d723b7dfda16c1eda1c402c789c64c165d9767a9a79b30c41e30dd8eab9bb6",
  "repo_slug": "tsubaki414/toolfi",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_tsubaki414_toolfi_68de987a/readme"
}