MCP Server¶

The GoByte MCP server lets AI assistants such as Claude manage your GoByte account through natural language — creating links, tagging them, generating QR codes, and reading analytics.

Endpoint¶

Property	Value
URL	`https://mcp.gobyte.io/mcp`
Transport	Streamable HTTP (JSON-RPC over HTTP POST)
Auth	`Authorization: Bearer gb_live_<key>`

The MCP server authenticates with the same API keys as the REST API. Create a key in the dashboard and give it the scopes you want the assistant to use.

Connect with Claude Code¶

Add GoByte as an HTTP MCP server, passing your API key in the header:

claude mcp add --transport http gobyte https://mcp.gobyte.io/mcp \
  --header "Authorization: Bearer gb_live_<key>"

Connect with other MCP clients¶

Any client that supports remote HTTP MCP servers can connect. Point it at https://mcp.gobyte.io/mcp and add an Authorization: Bearer gb_live_<key> header. A typical JSON config looks like:

{
  "mcpServers": {
    "gobyte": {
      "transport": "http",
      "url": "https://mcp.gobyte.io/mcp",
      "headers": {
        "Authorization": "Bearer gb_live_<key>"
      }
    }
  }
}

Available tools¶

The server exposes 13 tools:

Tool	Description
`links.create`	Create a short link.
`links.get`	Get a link's details.
`links.list`	List your links.
`links.update`	Update a link.
`links.delete`	Delete (deactivate) a link.
`tags.list`	List tags.
`tags.create`	Create a tag.
`tags.assign`	Assign a tag to a link.
`domains.list`	List available branded domains.
`workspaces.current`	Get the current workspace.
`qr.generate`	Generate a QR code for a link.
`analytics.summary`	Get an analytics summary.
`analytics.timeseries`	Get analytics as a time series.

Note

Paid-plan gating for MCP access is planned. During the current phase, access follows your API key's plan and scopes.

Try it¶

Once connected, ask your assistant something like:

"Create a short link for https://example.com/launch with the alias launch-2026, then show me last week's clicks."

The assistant will call links.create and analytics.summary on your behalf.