@hapticpaper/mcp-server

@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:

• A browser window will open to hapticpaper.com
• Sign in or create an account
• Authorize the MCP connection
• 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