go2-mcp-server

MCP server for Go2 — short links your AI agent can call. Create branded URLs, track every click, query per-run agent attribution. Works in Claude Code, Claude Desktop, Cursor, Windsurf, Codex.

latest

Source

npm

Version: 0.2.2

Version published: 4 months ago

Maintainers: 1

Created: 4 months ago

Source

go2-mcp-server

MCP server for Go2 — short links with first-class per-run agent attribution.

Every link an agent creates can carry (agent_id, agent_run_id, agent_actor_id, agent_tool_call_id). Every click is queryable through the same MCP, the REST API, or webhooks.

Install

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "go2": {
      "command": "npx",
      "args": ["-y", "go2-mcp-server@latest", "--api-key", "go2_xxx"],
      "env": {
        "GO2_AGENT_ID": "claude-desktop",
        "GO2_AGENT_RUN_ID": "set-per-conversation"
      }
    }
  }
}

Claude Code

claude mcp add go2 npx -y go2-mcp-server@latest --api-key "$GO2_API_KEY"

Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "go2": {
      "command": "npx",
      "args": ["-y", "go2-mcp-server@latest"],
      "env": { "GO2_API_KEY": "go2_xxx" }
    }
  }
}

Windsurf

Add the same stdio entry to ~/.codeium/windsurf/mcp_config.json.

Claude.ai web / iOS, ChatGPT (remote MCP)

Add https://mcp.go2.gg/mcp as a custom remote MCP server. OAuth 2.1 sign-in handles authentication.

Configuration

Flags (preferred for command-style installs) and env vars (preferred for stdio in apps):

Flag	Env var	Purpose
`--api-key`	`GO2_API_KEY`	API key from https://go2.gg/dashboard/developer
`--api-url`	`GO2_API_URL`	Override API base. Default `https://api.go2.gg`.
`--agent-id`	`GO2_AGENT_ID`	Stable agent identifier (`claude-code`, `cursor`, ...)
`--agent-run-id`	`GO2_AGENT_RUN_ID`	Per-conversation / per-task run id. Generate at run start.
`--agent-actor-id`	`GO2_AGENT_ACTOR_ID`	Optional: end-user / persona id the agent is acting on behalf of.

Per-call overrides on every tool also take precedence over env vars.

Tools

Attribution

Tool	What it does
`track_agent_link`	Create a short link stamped with the current run context.
`get_run_attribution`	Stream of clicks for a run / agent / link.
`list_agent_runs`	Distinct (agent_id, agent_run_id) with click counts and timestamps.

Lifecycle

Tool	What it does
`create_revocable_link`	Single-use link that 410s after one click.
`create_expiring_link`	TTL in minutes (default 60, max 30 days).
`revoke_run_links`	Archive every link with a given `agent_run_id`.

Links

Tool	What it does
`create_link`	Create a short link.
`list_links`	Paginated list of links.
`get_link`	Fetch a link by id.
`update_link`	Update destination/slug/etc.
`delete_link`	Archive a link.
`bulk_create_links`	Create many links in one call.
`get_analytics`	Per-link click analytics rollup.