io.github.Tsubaki414/toolfi
Open API Marketplace for AI Agents. Crypto data tools with USDC payments on Base.
Ask AI about io.github.Tsubaki414/toolfi
Powered by Claude Β· Grounded in docs
I know everything about io.github.Tsubaki414/toolfi. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
ToolFi β API Marketplace for AI Agents
"The next unicorn is an API marketplace for agents... where the right API should be selected by Claude and connected automatically" β @auralix4
API 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.
π Website Β· π‘ API Β· π Contract Β· πΊοΈ Roadmap
The Problem
AI agents need external data (prices, security checks, routes). Current solutions:
- RapidAPI, etc. β Built for humans. Agents can't browse and click "Subscribe"
- Hardcoded keys β Security risk, doesn't scale
- Manual integration β Every new tool needs human setup
The Solution
ToolFi = APIs that agents can discover and use autonomously.
- Discovery β Agents find tools via
.well-known/mcp.json, MCP registries, semantic search - Selection β Rich descriptions help agents pick the right tool
- Payment β USDC on Base, no API keys, just pay and use
- Data β Structured responses optimized for LLM consumption
How It Works
Agent β GET /api/price?symbol=ETH
β
Server β 402 Payment Required
{ toolId, price, paymentInstructions }
β
Agent β USDC.approve() β Registry.payForCall(toolId)
β
Agent β Retry with X-Payment-Tx header
β
Server β Verify on-chain β Return data
Available Tools
| Tool | Price | What it does |
|---|---|---|
| Crypto Price Oracle | 0.001 USDC | Real-time prices via DexScreener |
| Rug Pull Scanner | 0.003 USDC | Token security via GoPlus |
| Bridge Router | 0.002 USDC | Cross-chain routes via Li.Fi |
| DeFi Yield Finder | 0.002 USDC | Best yields via DefiLlama |
| Swap Router | 0.002 USDC | DEX aggregation via Li.Fi |
| Trending Coins | 0.001 USDC | What's hot via CoinGecko |
| Protocol TVL | 0.001 USDC | DeFi TVL data via DefiLlama |
| Gas Tracker | 0.0005 USDC | Gas prices for EVM chains |
| Wallet Risk Scanner | 0.005 USDC | Address risk analysis |
| News Digest | 0.002 USDC | Crypto news summary |
Integration Options
Option 1: HTTP API (Any Agent)
# Pay on-chain, then call with payment proof
curl -H "X-Payment-Tx: 0x..." "https://toolfi.vercel.app/api/price?symbol=ETH"
Option 2: MCP Server (Claude Desktop)
cd mcp-server
uv venv && source .venv/bin/activate
uv pip install -e .
Add to Claude Desktop config:
{
"mcpServers": {
"toolfi": {
"command": "/path/to/.venv/bin/python",
"args": ["-m", "src.server"],
"cwd": "/path/to/mcp-server"
}
}
}
Then ask Claude: "Check the security of token 0x... on Base"
For Tool Creators
Publish your API and earn USDC:
cast send $REGISTRY \
"registerTool(string,string,string,uint256)" \
"My Tool" "https://api.example.com" "Description" 10000 \
--rpc-url https://sepolia.base.org --private-key $KEY
Price in 6 decimals: 10000 = $0.01/call
Withdraw earnings:
cast send $REGISTRY "withdraw()" --rpc-url https://sepolia.base.org
Contract
| Chain | Base Sepolia (84532) |
| USDC | 0x036CbD53842c5426634e7929541eC2318f3dCF7e |
| Registry | 0x3D6C600799C67b45061eCAbfD5bBF8ef57Dded88 |
Project Structure
toolfi/
βββ api/ # Vercel serverless API
βββ web/ # Next.js frontend
βββ mcp-server/ # Python MCP server for Claude
βββ src/ # Solidity contracts
βββ skill/ # OpenClaw skill spec
βββ script/ # Deployment scripts
Development
# Contracts
forge build
forge test -v
# API
cd api && npm install && npm start
# MCP Server
cd mcp-server && uv pip install -e . && python -m src.server
Roadmap
- Core registry contract
- Web API with 10 tools
- MCP Server for Claude Desktop
- Mainnet deployment
- Creator dashboard
- Agent SDK (Python/TypeScript)
- Idempotency keys
- Usage analytics
License
MIT
