Overview MCP server REST API Skills llms.txtOpenAPI 3.1

@go2/mcp-server@0.2.0

One MCP server. Every client.

Name: Go2
Author: Go2

Stdio install for any local agent runtime. Remote Streamable HTTP at https://mcp.go2.gg/mcp with OAuth 2.1 for hosted clients.

npm .well-known/mcp.json Source

Claude Code

Stdio

Anthropic's CLI agent. Single command install.

Run in your terminal

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

Claude Desktop

Stdio

Add to claude_desktop_config.json on macOS or Windows.

Add to claude_desktop_config.json

{
  "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.ai (web + iOS)

Remote MCP

Connect a remote MCP at https://mcp.go2.gg/mcp with OAuth 2.1.

Paste into "Add custom MCP server" on Claude.ai

https://mcp.go2.gg/mcp

Cursor

Deep link

One-click install via cursor:// deep link, or paste into ~/.cursor/mcp.json.

Add to ~/.cursor/mcp.json

{
  "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"
      }
    }
  }
}

Open in Cursor

Windsurf

Config

Add to ~/.codeium/windsurf/mcp_config.json.

Add to mcp_config.json

{
  "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"
      }
    }
  }
}

OpenAI Codex CLI

Config

Add to ~/.codex/config.toml. AGENTS.md is auto-discovered at go2.gg/AGENTS.md.

Add to ~/.codex/config.toml

# ~/.codex/config.toml
[mcp.servers.go2]
command = "npx"
args = ["-y", "@go2/mcp-server@latest"]
env.GO2_API_KEY = "go2_xxx"
env.GO2_AGENT_ID = "codex"

ChatGPT

Remote MCP

Connect Go2 as an Apps SDK / plugin manifest. ChatGPT can also fetch the OpenAPI spec directly.

Plugin manifest URL

https://go2.gg/.well-known/ai-plugin.json

Perplexity

Remote MCP

Connect via the remote MCP endpoint with OAuth.

Remote MCP endpoint

https://mcp.go2.gg/mcp

Raycast AI

Config

Configure as an MCP server in the Raycast AI extension.

MCP server config

{
  "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"
      }
    }
  }
}

Any remote MCP client

Remote MCP

Use the Streamable HTTP endpoint with OAuth 2.1.

Remote MCP config

{
  "mcpServers": {
    "go2": {
      "url": "https://mcp.go2.gg/mcp",
      "transport": "streamable-http"
    }
  }
}

Tools available in every client

linkscreate_link— Create a short link.
linkslist_links— List links for the authenticated org.
linksget_link— Fetch a single link by id.
linksupdate_link— Update an existing link.
linksdelete_link— Archive a link.
linksbulk_create_links— Create many links in one call.
linksget_analytics— Per-link analytics roll-up.
attributiontrack_agent_link— Create a link and stamp it with agent_id, agent_run_id, agent_actor_id.
attributionget_run_attribution— Click stream for a given agent_run_id / agent_id / link.
attributionlist_agent_runs— Distinct agent runs with click counts and first/last timestamps.
lifecyclecreate_revocable_link— Create a single-use link that 410s after one click.
lifecyclecreate_expiring_link— Create a link with TTL in minutes.
lifecyclerevoke_run_links— Archive every link associated with a given agent_run_id.
docssearch_docs— Search Go2 documentation.
docsget_doc— Fetch a documentation page by slug.
docslist_docs— Enumerate documentation pages.

Authenticate

Get an API key at /dashboard/developer. For remote MCP, OAuth 2.1 with PKCE is enforced. RFC 7591 dynamic client registration is enabled at https://api.go2.gg/api/v1/auth/oauth2/register.

Troubleshooting

{ "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" } } } }

Tools available in every client

linkscreate_link— Create a short link.
linkslist_links— List links for the authenticated org.
linksget_link— Fetch a single link by id.
linksupdate_link— Update an existing link.
linksdelete_link— Archive a link.
linksbulk_create_links— Create many links in one call.
linksget_analytics— Per-link analytics roll-up.
attributiontrack_agent_link— Create a link and stamp it with agent_id, agent_run_id, agent_actor_id.
attributionget_run_attribution— Click stream for a given agent_run_id / agent_id / link.
attributionlist_agent_runs— Distinct agent runs with click counts and first/last timestamps.
lifecyclecreate_revocable_link— Create a single-use link that 410s after one click.
lifecyclecreate_expiring_link— Create a link with TTL in minutes.
lifecyclerevoke_run_links— Archive every link associated with a given agent_run_id.
docssearch_docs— Search Go2 documentation.
docsget_doc— Fetch a documentation page by slug.
docslist_docs— Enumerate documentation pages.

One MCP server. Every client.

Tools available in every client

Authenticate

Troubleshooting

agent_id / agent_run_id are empty in my clicks

I get 401 Unauthorized on every tool call

Remote MCP keeps reopening the OAuth window

track_agent_link / get_run_attribution doesn't show up in my agent

One MCP server. Every client.

Tools available in every client

Authenticate

Troubleshooting

agent_id / agent_run_id are empty in my clicks

I get 401 Unauthorized on every tool call

Remote MCP keeps reopening the OAuth window

track_agent_link / get_run_attribution doesn't show up in my agent