io.github.BFAI-1/taskfleet-mcp
Pay-per-call MCP tools: web search, scraping, on-chain wallet intel, extraction. x402 USDC on Base.
Open source Open in the app JSON README (API)
About
Pay-per-call MCP tools: web search, scraping, on-chain wallet intel, extraction. x402 USDC on Base.
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- bfai-1
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.1
- Last push
- 2026-08-04T19:45:24Z
- Repository state
- ativo
- Language
- JavaScript
- Added
- 2026-08-29 03:01:42
- Updated
- 2026-08-29 03:01:42
- Origin id
io.github.BFAI-1/taskfleet-mcp
README
# taskfleet-mcp
An [MCP](https://modelcontextprotocol.io) server that exposes **TaskFleet**'s
pay-per-call AI task APIs as tools any MCP-capable agent can discover and call:
web search, web scraping, structured extraction, translation, code review,
summarization, and on-chain wallet intelligence.
Payment is handled by the **x402** protocol (USDC on Base) — the caller brings
the wallet; there are no accounts or API keys.
## Why this exists
It's a discovery channel. Agents that browse MCP registries or load MCP
servers can find and use TaskFleet directly, in addition to the x402
directories. The tool list is loaded live from the fleet's manifest, so new
services appear automatically.
## Use it (as an agent operator)
Add to your MCP client config (e.g. Claude Desktop, or any MCP host):
```json
{
"mcpServers": {
"taskfleet": {
"command": "npx",
"args": ["-y", "taskfleet-mcp"],
"env": {
"BUYER_WALLET_PRIVATE_KEY": "0xYOUR_WALLET_KEY"
}
}
}
}
```
- **With** `BUYER_WALLET_PRIVATE_KEY` (an EVM key holding a little USDC on Base):
tool calls auto-pay via x402 and return results.
- **Without** it: tools still list (discovery works) and a call returns the
x402 payment instructions, so an x402-capable client can pay itself.
- `TASKFLEET_URL` overrides the target (defaults to `https://taskfleet.net`).
The wallet key stays on the operator's machine — it never reaches TaskFleet,
which only ever sees the on-chain payment.
## Tools
One tool per TaskFleet service, named `taskfleet_<service>` (e.g.
`taskfleet_search`, `taskfleet_scrape`, `taskfleet_wallet_intel`). Each tool's
input schema and price come straight from the fleet manifest.
## Publish it (as the fleet operator — discovery)
```bash
cd mcp
npm install
npm publish # publishes taskfleet-mcp to npm
```
Once on npm it's installable via `npx taskfleet-mcp` and can be listed in MCP
registries (the public MCP Registry, Smithery, PulseMCP, etc.) — each listing
is another place agents discover TaskFleet. Submitting to those registries is
free and generally just points at the npm package or this repo.
## Local test
```bash
npm install
TASKFLEET_URL=https://taskfleet.net node index.mjs
# should print: taskfleet-mcp v0.1.0: 14 tools from https://taskfleet.net (payment: caller-pays)
```