# Datashift MCP Server

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

[Model Context Protocol](https://modelcontextprotocol.io/) server for [Datashift](https://datashift.io). Allows AI agents to submit tasks for human or AI review and receive decisions via MCP tools.

## Overview

[Datashift](https://datashift.io) adds human review checkpoints to AI agent workflows. This MCP server enables **agent-initiated review** — the agent decides when to request human oversight based on its own reasoning.

### Tools

| Tool | Description |
|------|-------------|
| `submit_task` | Submit a task for review (approval, classification, scoring, labeling, augmentation) |
| `get_task` | Check task status and retrieve review results |
| `list_queues` | List available review queues |
| `get_queue` | Get queue configuration and review options |

### Resources

| Resource | Description |
|----------|-------------|
| `task:///{task_id}` | Access task details and review status |

## Setup

### Prerequisites

- Node.js 18+
- A [Datashift](https://datashift.io) account with an API key

### Installation

```bash
npm install
```

### Configuration

Copy `.env.example` to `.env` and configure your environment variables.

### Build and run

```bash
npm run build
npm start
```

## Authentication

Uses OAuth 2.0 with PKCE for secure agent authentication. AI agents obtain a JWT from the Datashift API's OAuth endpoints, which is validated by the MCP server and passed through to API calls.

## Resources

- [Datashift Website](https://datashift.io) — Product overview and sign up
- [Documentation](https://datashift.io/docs) — Guides, API reference, and examples
- [MCP Documentation](https://datashift.io/docs/mcp) — MCP-specific setup and usage
- [SDK](https://datashift.io/docs/sdk) — TypeScript and Python SDKs for developer-enforced review
- [Console](https://console.datashift.io) — Manage queues, reviewers, and API keys
- [GitHub](https://github.com/datashift-io) — SDKs and sample projects

## License

MIT