# Go2

> Links for AI agents.

Go2 is the link, attribution, and click-event primitive for AI agents. Every link an agent creates carries (agent_id, run_id, tool_call_id, actor_id) — captured at the edge, queryable from REST, MCP, or webhooks. Built on Cloudflare Workers + D1 + KV. Open source (AGPL). Humans get a dashboard; agents get a tool.

## Quick reference

- Site: https://go2.gg
- API: https://api.go2.gg
- OpenAPI: https://go2.gg/openapi.json
- Docs: https://go2.gg/docs
- Full LLM corpus: https://go2.gg/llms-full.txt
- MCP server: @go2/mcp-server (npm) or remote at https://mcp.go2.gg/mcp
- Status: https://go2.gg/status
- Source: https://github.com/rakesh1002/go2.gg

## Concepts

- **link** — A short URL with destination, expiry, geo/device targeting, password gating, click cap, and optional agent attribution context.
- **click** — A single redirect event with geo, device, browser, OS, referrer, bot detection, uniqueness, and any agent attribution captured at redirect time.
- **agent_id** — Stable identifier for the agent that created or invoked the link (e.g. claude-code, cursor, gpt-5-task-runner).
- **agent_run_id** — Per-execution identifier so you can attribute every click back to the specific agent run that produced the link.
- **agent_actor_id** — Optional end-user / persona identifier for the human the agent acted on behalf of.
- **agent_tool_call_id** — Optional MCP tool-call id captured at click time so individual tool invocations resolve to clicks.

## REST endpoints

Authenticated with `Authorization: Bearer go2_...` (API key) or OAuth access token.
Full machine-readable spec: https://go2.gg/openapi.json

- `POST /api/v1/links` — Create a tracked short link. Accepts agent attribution context inline.
- `GET /api/v1/links` — List links for the authenticated org, paginated and searchable.
- `GET /api/v1/links/{id}` — Fetch a single link by id.
- `PATCH /api/v1/links/{id}` — Update destination, expiry, click limit, targeting, or agent attribution.
- `DELETE /api/v1/links/{id}` — Archive a link. Existing redirects return 410.
- `GET /api/v1/agent-attribution` — Stream of clicks filtered by agent_id / agent_run_id / link_id.
- `GET /api/v1/agent-attribution/summary` — Click rollup grouped by agent_id or agent_run_id.
- `GET /api/v1/agent-attribution/runs` — Distinct agent runs with click counts and first/last timestamps.
- `GET /api/v1/analytics/{linkId}` — Per-link analytics: geo, device, browser, OS, referrer breakdowns.
- `POST /api/v1/qr` — Generate a QR code (PNG or SVG) for a link.
- `GET /api/v1/api-keys` — List API keys for the authenticated organization.
- `POST /api/v1/api-keys` — Provision a new API key. Plaintext returned once at creation time.
- `GET /api/v1/webhooks` — List outgoing webhook subscriptions.
- `POST /api/v1/webhooks` — Subscribe a URL to events such as click, link.created, qr.scanned.
- `GET /api/v1/usage` — Current-period usage counters: links created, clicks, custom domains.

## MCP server

Package: `@go2/mcp-server` (>= 0.2.0)
Transports: stdio, http
Remote endpoint: https://mcp.go2.gg/mcp
OAuth 2.1: https://api.go2.gg/api/v1/auth/oauth2/authorize

Tools:
- `create_link` (links) — Create a short link.
- `list_links` (links) — List links for the authenticated org.
- `get_link` (links) — Fetch a single link by id.
- `update_link` (links) — Update an existing link.
- `delete_link` (links) — Archive a link.
- `bulk_create_links` (links) — Create many links in one call.
- `get_analytics` (links) — Per-link analytics roll-up.
- `track_agent_link` (attribution) — Create a link and stamp it with agent_id, agent_run_id, agent_actor_id.
- `get_run_attribution` (attribution) — Click stream for a given agent_run_id / agent_id / link.
- `list_agent_runs` (attribution) — Distinct agent runs with click counts and first/last timestamps.
- `create_revocable_link` (lifecycle) — Create a single-use link that 410s after one click.
- `create_expiring_link` (lifecycle) — Create a link with TTL in minutes.
- `revoke_run_links` (lifecycle) — Archive every link associated with a given agent_run_id.
- `search_docs` (docs) — Search Go2 documentation.
- `get_doc` (docs) — Fetch a documentation page by slug.
- `list_docs` (docs) — Enumerate documentation pages.

## Clients

- **Claude Code** (stdio): Anthropic's CLI agent. Install Go2 with `claude mcp add go2 npx @go2/mcp-server`.
- **Claude Desktop** (stdio): Anthropic's macOS/Windows app. Add a stdio entry to claude_desktop_config.json.
- **Claude.ai (web + iOS)** (remote-mcp): Add Go2 as a remote MCP connector. OAuth 2.1 sign-in, no local install required.
- **Cursor** (deep-link): Deep-link install via cursor:// URL. One-click from go2.gg/developers/mcp.
- **Windsurf** (config-snippet): Add a stdio entry to windsurf MCP config.
- **OpenAI Codex CLI** (config-snippet): AGENTS.md plus an MCP stdio entry in ~/.codex/config.toml.
- **ChatGPT** (remote-mcp): Connect Go2 as an Apps SDK / plugin manifest source.
- **Perplexity** (config-snippet): Plugin manifest at /.well-known/ai-plugin.json.
- **Raycast AI** (config-snippet): Configure Raycast to call the Go2 remote MCP endpoint.

## Scopes

- `links:read` — List and read links.
- `links:write` — Create, update, and archive links.
- `analytics:read` — Read per-link click analytics.
- `attribution:read` — Read agent attribution streams and rollups.
- `attribution:write` — Mutate agent attribution metadata on links.
- `webhooks:read` — List webhook subscriptions.
- `webhooks:write` — Manage webhook subscriptions.

## Pricing

Free: 50 links / 2K clicks per month. Pro $9/mo: 2K links / 100K clicks. Business $49/mo: 20K links / 500K clicks + team seats. Scale: usage-based at $0.40 per 1K agent-attributed events above 500K. Self-host AGPL or commercial license $5K/yr.
Details: https://go2.gg/pricing

---

Generated: 2026-04-27T14:41:11.666Z