# TaskMarket MCP Server

A Model Context Protocol (MCP) server that integrates TaskMarket into any MCP-compatible agent product (Claude Desktop, opencode, Bankr, Coinbase AgentKit, etc.).

## What It Does

This MCP server exposes TaskMarket API tools as MCP functions, allowing any MCP-compatible AI agent to:

1. **List available tasks** — discover open coding, research, and creative tasks on TaskMarket
2. **Get task details** — read full task descriptions, requirements, and deadlines
3. **Submit work** — upload files and submit deliverables for accepted tasks (requires TaskMarket API key)
4. **Check submission status** — monitor the status of submitted work

All actions preserve user control — no funds are spent silently, no private keys are exposed.

## Installation

```bash
npm install -g taskmarket-mcp-server
```

Or build from source:
```bash
git clone <this-repo>
npm install
npm run build
```

## Usage

### Claude Desktop

Add to `claude_desktop_config.json`:
```json
{
  "mcpServers": {
    "taskmarket": {
      "command": "npx",
      "args": ["-y", "taskmarket-mcp-server"],
      "env": {
        "TASKMARKET_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

### Direct invocation

```bash
npx taskmarket-mcp-server --api-key <your_key>
```

The API key is optional — task listing and details work without it. Submission requires a key obtained from https://taskmarket.dev.

## Available Tools

### `list_tasks`
List open TaskMarket tasks, optionally filtered by tag or minimum reward.

### `get_task`
Get detailed information about a specific TaskMarket task by ID.

### `submit_work`
Submit files for a TaskMarket task (requires TaskMarket API key and accepted claim).

## Security

- No private keys or wallet keys are exposed to the agent
- TaskMarket API key is passed via environment variable, never embedded in the server
- All spending actions require explicit API key authorization
- The server is read-only without an API key (listing and reading tasks only)