Skip to main content

Environment variables

The libraries do not read environment variables directly — all configuration is passed via init() or CLI flags. However, the IDE proxy (mcp-tap-proxy package) detects these for IDE identification:
VariableIDE
CURSOR_TRACE_IDCursor
WINDSURF_SESSIONWindsurf
CLAUDE_DESKTOPClaude Desktop

Default endpoint

Both libraries default to:
https://mcp-tap.vercel.app/api/v1/events
Override with the endpoint parameter in init() or --endpoint on the CLI.

Custom endpoint requirements

If self-hosting the backend, the endpoint must accept:
  • Method: POST
  • Headers: Content-Type: application/json, x-api-key: <key>
  • Body: JSON array of TapEvent objects