@hapticpaper/mcp-server

Official MCP Server for Haptic Paper - Connect your account to AI assistants like Claude, Gemini, and ChatGPT.

Installation

Add to your MCP client configuration:

Claude Desktop / Gemini

{
  "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):

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