# Run your Magent workspace from any MCP client.

> Connect Claude, Cursor or your own agent to the same campaigns, signals, leads and inbox you use in Magent — with a separate permission boundary on the API key.

Markdown rendition of https://trymagent.com/en/developers/mcp · language: en

Updated August 2026 · Streamable HTTP

## Connect in three steps

1. **Generate a scoped key** — Open Settings → MCP Server. Read access is required; lead changes, automation control and AI generation are separate opt-ins.
2. **Add the Streamable HTTP endpoint** — Use the endpoint below and send the key as a Bearer token in the Authorization header.
3. **Let the client discover the tools** — Magent publishes the tool catalogue over MCP. Start with get_account_overview for a one-call picture of the workspace.

## Endpoint and authentication

Magent currently authenticates remote MCP clients with scoped API keys. The raw key is shown once and only its SHA-256 hash is stored. OAuth sign-in is not available yet.

- **Endpoint:** `https://app.trymagent.com/api/mcp`
- **Authorization header:** `Authorization: Bearer magent_…`

## Four permissions, each tied to an effect

Every tool call is checked on the server. Existing keys retain their current access; new keys start read-only.

- **`account:read` · Read workspace** — Read campaigns, lists, leads, signals, inbox conversations, deals, credits and account metrics.
- **`leads:write` · Manage leads** — Edit list rows, notes and reminders, approve or reject campaign contacts, and update deal stages.
- **`automation:write` · Control automations** — Pause or resume campaigns, lead-finding agents and their individual signals.
- **`ai:generate` · Generate with AI** — Create grounded reply drafts. Generation may consume credits; the result is returned as a draft only.

## The GTM control surface

The server exposes 38 tools grouped around the work Magent already does.

- **Overview and intent** — Account overview, hot accounts, signal runs, recent activity and pipeline attribution.
- **Leads and campaigns** — Lists, contacts, campaign queues, approvals, notes, reminders and deal stages.
- **Agents and signals** — Agent status, discovered leads, configured signals and scoring rules.
- **Inbox** — Connected accounts, conversations, messages and grounded reply drafts.

## What an MCP client cannot do

There is no send-message tool. A client can draft a reply only when the key has ai:generate; sending stays in Magent under the account's caps, working hours and review mode.

## Works with standard MCP clients

Use the generated snippets for Claude Code, Claude Desktop and Cursor, or configure any client that supports Streamable HTTP and custom Authorization headers.

[Generate my scoped key](https://app.trymagent.com/settings/mcp)


## Other pages

- [Magent](https://trymagent.com/en/index.md)
- [Product: outbound from signal to reply](https://trymagent.com/en/product.md)
- [Solutions for sales, marketing and founders](https://trymagent.com/en/solutions.md)
- [Pricing: one plan, the whole engine](https://trymagent.com/en/pricing.md)
- [Contact](https://trymagent.com/en/contact.md)
- [Sign up / sign in](https://app.trymagent.com)