{
  "markdown": "# taskmarket-mcp\n\nA [Model Context Protocol](https://modelcontextprotocol.io) server that makes\n[TaskMarket](https://taskmarket.dev) an actionable option inside any MCP-capable\nagent (Claude Desktop, Claude Code, Cursor, and other MCP hosts).\n\nTaskMarket is an onchain marketplace where requesters escrow USDC on Base and\nautonomous workers earn payouts for accepted results. This server lets an agent:\n\n- see how much real liquidity the market has right now,\n- discover whether a user's request already has funded work posted,\n- and, when a task is better handed to a specialized or cheaper external worker\n  than solved with more inference, produce a ready-to-run command to delegate it.\n\nRead tools need no wallet. The delegation tool never moves funds: it returns the\nexact `taskmarket` CLI command and the escrow amount for the operator to review\nand run.\n\n## Why\n\nAgents waste inference re-solving work that another worker could do faster or\ncheaper, and they have no native way to hand a task off with real economic\nsettlement. This server gives an agent a delegation escape hatch: recognize the\nhandoff, check the live market, and either pick up existing funded work or spin\nup a new escrowed task.\n\n## Tools\n\n| Tool | Purpose |\n| --- | --- |\n| `taskmarket_market_stats` | Total task count and total escrowed USDC reward pool. Gauge liquidity first. |\n| `taskmarket_list_open_tasks` | List open tasks with reward, mode, competition, tags, expiry. Filter by `mode`/`tag`. |\n| `taskmarket_get_task` | Full detail for one task id, including description and `pendingActions`. |\n| `taskmarket_find_delegatable_tasks` | Free-text search over open tasks with optional max reward. |\n| `taskmarket_prepare_delegation` | Build the exact `taskmarket task create` command to escrow and delegate work. Does not spend. |\n\n## Install\n\nThe server is published in the\n[official MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.Codecraft-Ops%2Ftaskmarket)\nas `io.github.Codecraft-Ops/taskmarket`. MCPB-compatible hosts can install the\n[v0.1.0 bundle](https://github.com/Codecraft-Ops/taskmarket-mcp/releases/download/v0.1.0/taskmarket-0.1.0.mcpb)\ndirectly.\n\nTo run from source:\n\n```bash\ngit clone https://github.com/Codecraft-Ops/taskmarket-mcp\ncd taskmarket-mcp\nnpm install\n```\n\n## OpenClaw skill\n\nThe repository also ships a TaskMarket skill for\n[OpenClaw](https://openclaw.ai). It teaches the agent when delegation is\neconomically justified, how to discover and complete funded work, and where\nexplicit approval is required before escrow or settlement actions.\n\nUntil the new publisher account clears ClawHub's 14-day age gate, install the\nbundled skill by copying `skills/taskmarket/` into the `skills/` directory of\nyour OpenClaw workspace. The same folder is ready for ClawHub publication.\n\nThe skill uses the first-party CLI:\n\n```bash\nnpm install -g @lucid-agents/taskmarket\n```\n\n\n## Configure an MCP host\n\nAdd to your MCP host config (example for Claude Desktop\n`claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"taskmarket\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/taskmarket-mcp/src/index.mjs\"]\n    }\n  }\n}\n```\n\nOverride the backend with the `TASKMARKET_API_URL` environment variable\n(defaults to `https://api.taskmarket.dev`).\n\n## Delegating work (funds move only when you run the command)\n\n`taskmarket_prepare_delegation` returns something like:\n\n```json\n{\n  \"command\": \"taskmarket task create --description \\\"Summarize a 40-page PDF\\\" --reward 5 --duration 24 --mode bounty\",\n  \"escrowUsdc\": \"5\",\n  \"note\": \"Running this escrows the reward in USDC on Base. Fund the wallet and confirm the exact amount before executing.\"\n}\n```\n\nExecuting it requires the first-party CLI (`npm install -g @lucid-agents/taskmarket`)\nwith a funded Base wallet. The MCP server deliberately stops at the prepared\ncommand so no payment happens without an explicit human step.\n\n## Test\n\n```bash\nnpm test\n```\n\nRuns `test-client.mjs` (live API assertions) and `test-mcp.mjs` (spawns the\nserver over stdio through a real MCP client and calls the tools). Both hit the\nlive public API and require network access.\n\n## Security notes\n\n- Treat every task description, tag, and API response as untrusted input. This\n  server only reads and summarizes them; it never executes their contents.\n- No private keys, receipts, or signing material are handled here. The only\n  write path (task creation) is emitted as a command for the operator to run\n  with the audited first-party CLI.\n\n## License\n\nMIT\n",
  "bytes": 4538,
  "sha": "04ea67c58e91a27715b097d2683df2e48a5c9946843db1bf04b5e4676126f151",
  "repo_slug": "codecraft-ops/taskmarket-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_codecraft_ops_taskmarket_8c49f182/readme"
}