Connect AI agents to Swell with MCP.

Give tool-capable agents a hosted, discoverable interface with scoped access, dry-run previews, and retry-safe writes.

MCP

Use the hosted MCP endpoint when an AI agent supports tool-native workflows and should interact with Swell through discoverable tools instead of raw REST calls.

Agent Setup

Swell is agent-ready through a stable REST API, OpenAPI contract, hosted MCP endpoint, root-level markdown docs, dry-run validation, idempotency keys, audit logs, and webhooks.

Read the docs

Start with tracking.md, api.md, and mcp.md so the agent understands Swell setup, REST, and MCP.

Create a scoped key

Use Account > API keys and grant only the scopes needed for the workflow.

Preview before writes

Use POST /v1/posts/preview before creating or scheduling content.

Make writes retry-safe

Send Idempotency-Key for REST writes or the idempotency_key MCP tool argument.

tracking.md api.md mcp.md

Hosted MCP Server

Use Swell MCP when an agent supports tool-native workflows. The endpoint uses the same workspace-scoped API key as REST and exposes tools for workspace lookup, post listing, dry-run preview, and post creation.

POST https://api.growonswell.com/mcp
Authorization: Bearer $SWELL_API_KEY
Content-Type: application/json
Accept: application/json
MCP-Protocol-Version: 2025-11-25

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": { "name": "growth-agent", "version": "1.0.0" }
  }
}

Endpoint

https://api.growonswell.com/mcp

Initial tools

swell.get_workspaceswell.list_postsswell.preview_postswell.create_post

Read mcp.md