# MCP Server

GetScaled ships a native **Model Context Protocol (MCP)** server so AI agents can operate the platform directly — creating campaigns, managing contacts, building journeys, pulling analytics, and running deliverability operations — using the same `gsk_` API key as the REST API.

## What it is

The Model Context Protocol is an open standard that lets AI agents discover and call tools exposed by a server. GetScaled's MCP server exposes **200+ tools** covering the full product surface, so an agent connected to it can plan and execute real marketing and sales work instead of just reading documentation. Because it shares authentication and the underlying API with the REST interface, anything an agent does through MCP is governed by the same scopes and the same platform rules.

## Connection details

- **URL** — `https://mcp.getscaled.com/v1`
- **Transport** — Streamable HTTP
- **Auth** — your `gsk_` API key, sent as `Authorization: Bearer gsk_your_key_here` (the same key that works for REST)
- **Server card** — [https://mcp.getscaled.com/.well-known/mcp/server-card.json](https://mcp.getscaled.com/.well-known/mcp/server-card.json)

Issue a key at [https://portal.getscaled.com/admin/api-keys](https://portal.getscaled.com/admin/api-keys). The key's scopes bound what the agent can do through MCP, exactly as they do over REST.

You can inspect the server's advertised metadata and capabilities by fetching the server card:

```bash
curl https://mcp.getscaled.com/.well-known/mcp/server-card.json
```

## Adding it to a client

GetScaled's MCP server works with **Claude, ChatGPT, and Cursor**. The general pattern is the same everywhere: point the client at `https://mcp.getscaled.com/v1`, use the Streamable HTTP transport, and supply your `gsk_` key as a bearer token.

### Claude Desktop

Add GetScaled as a custom connector / MCP server pointing at `https://mcp.getscaled.com/v1`, with the `Authorization: Bearer gsk_your_key_here` header. Once connected, GetScaled's tools become available to Claude in your conversations.

### Cowork

In Cowork, add GetScaled as an MCP connector using the URL `https://mcp.getscaled.com/v1` and your `gsk_` key as the bearer token. After it connects, the GetScaled tools appear alongside your other connectors.

### Cursor

Add an MCP server in Cursor's settings with the URL `https://mcp.getscaled.com/v1` and the `Authorization: Bearer gsk_your_key_here` header. Cursor will then expose GetScaled's tools to its agent.

## Representative tool categories

The 200+ tools group into the same areas as the product:

- **Campaigns** — create, update, launch, pause, clone campaigns; read live and historical stats.
- **Contacts** — create, update, search, import, segment, suppress, and export contacts and lists.
- **Journeys & sequences** — build and manage automated journeys and cold-outreach sequences, enroll contacts, and read journey/sequence analytics.
- **Analytics** — engagement, funnel, cohort, ISP-level, geo, device, send-time, and revenue analytics.
- **Deliverability** — domain auth (DKIM/SPF/DMARC), dedicated IP warmup, reputation and blacklist monitoring, inbox-placement testing, and feedback-loop/suppression management.

For the authoritative, machine-readable list of tools and capabilities, read the server card at [https://mcp.getscaled.com/.well-known/mcp/server-card.json](https://mcp.getscaled.com/.well-known/mcp/server-card.json).

## See also

- **Developer landing** — [https://getscaled.com/developers.md](https://getscaled.com/developers.md)
- **Quickstart** — [https://getscaled.com/docs/quickstart.md](https://getscaled.com/docs/quickstart.md)
- **Authentication** — [https://getscaled.com/docs/authentication.md](https://getscaled.com/docs/authentication.md)
- **OpenAPI 3.1 spec** — [https://api.getscaled.com/openapi.json](https://api.getscaled.com/openapi.json)

Questions? Email [developers@getscaled.com](mailto:developers@getscaled.com).