open-index/open-npm huggingface dataset:
npm package: @hapticpaper/mcp-server
Description: Official MCP Server for Haptic Paper - Connect your account to create human tasks from agentic pipelines.
Latest version: 1.0.62

# @hapticpaper/mcp-server

Official MCP Server for [Haptic Paper](https://hapticpaper.com) - Connect your account to AI assistants like Claude, Gemini, and ChatGPT.

## Installation

Add to your MCP client configuration:

### Claude Desktop / Gemini

```json
{
  "mcpServers": {
    "hapticpaper": {
      "command": "npx",
      "args": ["-y", "@hapticpaper/mcp-server"]
    }
  }
}
```

### First-Time Authentication

The first time you use any tool, you'll be prompted to authenticate:

1. A browser window will open to `hapticpaper.com`
2. Sign in or create an account
3. Authorize the MCP connection
4. Return to your AI assistant - you're connected!

Your tokens are stored securely in `~/.hapticpaper/tokens.json`.

## Available Tools

| Tool | Description | Actions |
|------|-------------|---------|
| `tasks` | Manage task lifecycle | `create`, `get`, `list`, `update`, `cancel` |
| `workers` | Browse and view workers | `search`, `get_profile` |
| `account` | Manage your account | `get_my_profile`, `get_balance` |
| `qualifications` | Onboarding & Interviews | `start`, `continue`, `check_status` |
| `haptic` | Discovery & Helpers | `intent`, `search_docs` |

## Manual Authentication

To authenticate manually (useful for troubleshooting):

```bash
npx @hapticpaper/mcp-server auth
```

## Environment Variables

| Variable | Description | Default |
|----------|-------------|---------|
| `AUTH_URL` | OAuth authorization endpoint | `https://hapticpaper.com/oauth/authorize` |
| `TOKEN_URL` | OAuth token endpoint | `https://hapticpaper.com/api/v1/oauth/token` |
| `API_URL` | API base URL | `https://hapticpaper.com/api/v1` |

## License

MIT