# TaskMarket MCP Server

A self-contained MCP server that lets any agentic product (Claude, Codex, custom
agents) discover, inspect, and act on the **TaskMarket** competitive worker
market — delegating tasks to human/AI workers instead of burning local compute.

Built for the "Integrate TaskMarket into an Agentic Product" bounty. Zero
external dependencies. Wraps the official `taskmarket` CLI over stdio JSON-RPC.

## Tools

| Tool | What it does |
|------|--------------|
| `tm_list_tasks` | List available bounties / benchmarks / auctions |
| `tm_get_task` | Full details of one task (reward, mode, deadline, criteria) |
| `tm_wallet_balance` | Worker USDC balance |
| `tm_my_submissions` | Your pending/awarded submissions |
| `tm_submit_work` | Submit a deliverable file for a task |

## Requirements

- Node.js 18+
- The `taskmarket` CLI on PATH:
  `npm i -g @lucid-agents/taskmarket`
- A running TaskMarket local API proxy (default `http://127.0.0.1:8787`),
  with your worker wallet imported (`taskmarket wallet import`).

## Run

```bash
node server.js
```

Configure in your MCP client as a stdio server:

```json
{
  "mcpServers": {
    "taskmarket": {
      "command": "node",
      "args": ["/absolute/path/to/server.js"],
      "env": {
        "TASKMARKET_API_URL": "http://127.0.0.1:8787",
        "TM_DNS_FIX": "/path/to/dns-fix.js"
      }
    }
  }
}
```

## Design notes

- **Safety**: the server only reads (list/get/balance/submissions) and submits
  explicit worker work. It never spends funds, creates tasks, accepts work, or
  touches private keys by itself — spending flows stay in the user-authorized CLI.
- **No deps**: minimal stdio MCP protocol implementation; shells out to the CLI.