cely-mcp

MCP server for the Cely Copilot dashboard. Exposes the Cely REST API as Model Context Protocol tools so any MCP-aware client (Codex, Claude Desktop, Cursor, Continue, etc.) can manage clients, creators, posts, manual metrics, audience demographics, Sprout/Sheets integrations, team access and rollbacks.

Install + run

You don't have to install it — npx runs it on demand:

npx cely-mcp@latest

It needs your Cely API token (cely_pat_*). Get one at https://cely.sounext.xyz/admin/api-tokens.

Configure in your client

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "cely": {
      "command": "npx",
      "args": ["-y", "cely-mcp@latest"],
      "env": {
        "CELY_API_TOKEN": "cely_pat_xxxxxxxxxxxxxxxx",
        "CELY_BASE_URL": "https://cely.sounext.xyz"
      }
    }
  }
}

Restart Claude Desktop.

Codex CLI

~/.codex/config.toml:

[mcp_servers.cely]
command = "npx"
args = ["-y", "cely-mcp@latest"]

[mcp_servers.cely.env]
CELY_API_TOKEN = "cely_pat_xxxxxxxxxxxxxxxx"
CELY_BASE_URL = "https://cely.sounext.xyz"

Cursor

~/.cursor/mcp.json (global) or .cursor/mcp.json (workspace):

{
  "mcpServers": {
    "cely": {
      "command": "npx",
      "args": ["-y", "cely-mcp@latest"],
      "env": {
        "CELY_API_TOKEN": "cely_pat_xxxxxxxxxxxxxxxx",
        "CELY_BASE_URL": "https://cely.sounext.xyz"
      }
    }
  }
}

Cursor → Settings → MCP → reload.

CLI flags / env vars

| Flag | Env var | Default | |------|---------|---------| | --token | CELY_API_TOKEN | (required) | | --base-url | CELY_BASE_URL | https://cely.sounext.xyz | | --openapi | CELY_OPENAPI_PATH | /api/gpt/openapi.json?part=gpt |

The server fetches the OpenAPI spec at startup and exposes every operationId as an MCP tool. Updating the API on the server side adds tools the next time the server starts — no client release needed.

What is exposed

30 tools covering:

• Reads: listClients, getClient, getDashboardSnapshot, listCreators, listCampaigns, listPosts, listManualMetrics, listAudience.
• Creates / links: createClient, createCreator, createPost, linkPost, linkSproutCampaign.
• Bulk ingest: ingestManualBatch, ingestAudienceBatch.
• Updates: updateClient, updateCreator, updateCampaign, updatePostMetrics, updateManualMetric.
• Sync: syncSprout, syncSheets, syncManual.
• Team / external access: listTeam, upsertTeamMember, revokeTeamMember.
• Destructive + rollback: publishClient, archiveClient, archivePost, rollbackMutation.

License

MIT