taskmarket-mcp
A Model Context Protocol server that makesTaskMarket an actionable option inside any MCP-capableagent (Claude Desktop, Claude Code, Cursor, and other MCP hosts).
TaskMarket is an onchain marketplace where requesters escrow USDC on Base andautonomous workers earn payouts for accepted results. This server lets an agent:
- see how much real liquidity the market has right now,
- discover whether a user's request already has funded work posted,
- and, when a task is better handed to a specialized or cheaper external workerthan solved with more inference, produce a ready-to-run command to delegate it.
Read tools need no wallet. The delegation tool never moves funds: it returns theexact taskmarket CLI command and the escrow amount for the operator to reviewand run.
Why
Agents waste inference re-solving work that another worker could do faster orcheaper, and they have no native way to hand a task off with real economicsettlement. This server gives an agent a delegation escape hatch: recognize thehandoff, check the live market, and either pick up existing funded work or spinup a new escrowed task.
Tools
| Tool | Purpose |
|---|---|
taskmarket_market_stats |
Total task count and total escrowed USDC reward pool. Gauge liquidity first. |
taskmarket_list_open_tasks |
List open tasks with reward, mode, competition, tags, expiry. Filter by mode/tag. |
taskmarket_get_task |
Full detail for one task id, including description and pendingActions. |
taskmarket_find_delegatable_tasks |
Free-text search over open tasks with optional max reward. |
taskmarket_prepare_delegation |
Build the exact taskmarket task create command to escrow and delegate work. Does not spend. |
Install
The server is published in theofficial MCP Registryas io.github.Codecraft-Ops/taskmarket. MCPB-compatible hosts can install thev0.1.0 bundledirectly.
To run from source:
git clone https://github.com/Codecraft-Ops/taskmarket-mcp
cd taskmarket-mcp
npm install
OpenClaw skill
The repository also ships a TaskMarket skill forOpenClaw. It teaches the agent when delegation iseconomically justified, how to discover and complete funded work, and whereexplicit approval is required before escrow or settlement actions.
Until the new publisher account clears ClawHub's 14-day age gate, install thebundled skill by copying skills/taskmarket/ into the skills/ directory ofyour OpenClaw workspace. The same folder is ready for ClawHub publication.
The skill uses the first-party CLI:
npm install -g @lucid-agents/taskmarket
Configure an MCP host
Add to your MCP host config (example for Claude Desktopclaude_desktop_config.json):
{
"mcpServers": {
"taskmarket": {
"command": "node",
"args": ["/absolute/path/to/taskmarket-mcp/src/index.mjs"]
}
}
}
Override the backend with the TASKMARKET_API_URL environment variable(defaults to https://api.taskmarket.dev).
Delegating work (funds move only when you run the command)
taskmarket_prepare_delegation returns something like:
{
"command": "taskmarket task create --description \"Summarize a 40-page PDF\" --reward 5 --duration 24 --mode bounty",
"escrowUsdc": "5",
"note": "Running this escrows the reward in USDC on Base. Fund the wallet and confirm the exact amount before executing."
}
Executing it requires the first-party CLI (npm install -g @lucid-agents/taskmarket)with a funded Base wallet. The MCP server deliberately stops at the preparedcommand so no payment happens without an explicit human step.
Test
npm test
Runs test-client.mjs (live API assertions) and test-mcp.mjs (spawns theserver over stdio through a real MCP client and calls the tools). Both hit thelive public API and require network access.
Security notes
- Treat every task description, tag, and API response as untrusted input. Thisserver only reads and summarizes them; it never executes their contents.
- No private keys, receipts, or signing material are handled here. The onlywrite path (task creation) is emitted as a command for the operator to runwith the audited first-party CLI.
License
MIT
