CuteDyno/Docs/MCP Server

Model Context Protocol

CuteDyno MCP Server

The official MCP server for CuteDyno. Add it to Claude, Cursor, Codex, and other MCP-compatible tools to discover connected social pages, upload media, and schedule posts — without writing raw HTTP requests.

Create a CuteDyno API key, then follow the setup guide for your tool below. MCP access is included on paid plans alongside the REST API.

Get your API key

  1. Log in to CuteDyno on a paid plan.
  2. Go to Dashboard → API keys and create a new key.
  3. Copy the key (starts with cdyn_live_).
  4. Paste it into your MCP client config as shown below.
OAuth for connecting social accounts is only available in the dashboard. Use MCP to schedule posts to accounts you have already connected.

Tools

These tools map directly to the CuteDyno v1 REST API. Your agent calls them to manage posts and media on your behalf.

ToolDescription
list_social_pagesList connected social pages. Use each page id as a targetId when creating posts.
list_postsList posts with optional filters for state, content type, and platform.
get_postGet full post detail including platform options and per-account overrides.
create_postCreate a draft, scheduled, or immediately queued post.
update_postEdit a draft or scheduled post.
cancel_postCancel a scheduled or queued post.
get_upload_signed_urlGet a presigned URL for uploading images or videos before creating a post.

Resources & prompts

Resources

  • cutedyno://docs/workflowStep-by-step scheduling workflow
  • cutedyno://docs/content-typesText, image, and video payload shapes

Prompts

  • draft-social-postDraft a post for a platform and create it via the API
  • weekly-content-planPlan and draft a week of content across platforms

Cursor

  1. Create an API key from your CuteDyno dashboard (Settings → API).
  2. Open your MCP config at ~/.cursor/mcp.json (global) or .cursor/mcp.json in your project.
  3. Add the CuteDyno server configuration below.
  4. Save the file. Cursor picks up changes automatically.
  5. Start a chat and ask your agent to list your connected social pages.
{
  "mcpServers": {
    "cutedyno": {
      "command": "npx",
      "args": ["-y", "cutedyno-mcp"],
      "env": {
        "CUTEDYNO_API_KEY": "cdyn_live_YOUR_KEY"
      }
    }
  }
}

Claude Desktop

  1. Create an API key from your CuteDyno dashboard.
  2. Open Claude Desktop → Settings → Developer → Edit Config.
  3. On macOS the file is ~/Library/Application Support/Claude/claude_desktop_config.json.
  4. Add the mcpServers block below inside the root JSON object.
  5. Restart Claude Desktop completely, then look for the tools icon below the chat input.
{
  "mcpServers": {
    "cutedyno": {
      "command": "npx",
      "args": ["-y", "cutedyno-mcp"],
      "env": {
        "CUTEDYNO_API_KEY": "cdyn_live_YOUR_KEY"
      }
    }
  }
}

Claude Desktop requires a full restart after saving the config file.

Claude Code

  1. Install the Claude Code CLI: npm install -g @anthropic-ai/claude-code
  2. Add the CuteDyno MCP server (user scope works across all projects):
claude mcp add cutedyno --transport stdio --scope user -- npx -y cutedyno-mcp

Set CUTEDYNO_API_KEY in your shell environment, or add --env CUTEDYNO_API_KEY=cdyn_live_... to the command. Run /mcp in Claude Code to verify the connection.

Remote (Streamable HTTP)

  1. Use the hosted MCP endpoint if your client supports remote servers with Bearer auth.
  2. No local npx process required — your client connects directly to the CuteDyno API.
  3. Add the configuration below to your client MCP settings.
{
  "mcpServers": {
    "cutedyno": {
      "url": "https://api.cutedyno.com/mcp",
      "headers": {
        "Authorization": "Bearer cdyn_live_YOUR_KEY"
      }
    }
  }
}

Endpoint: POST https://api.cutedyno.com/mcp with Authorization: Bearer cdyn_live_...

https://api.cutedyno.com/mcp

OpenAI Codex CLI

  1. Install: npm install -g @openai/codex@latest
  2. Add the CuteDyno MCP server:
codex mcp add cutedyno --env CUTEDYNO_API_KEY=cdyn_live_YOUR_KEY -- npx -y cutedyno-mcp

Run codex, then type /mcp to verify tools like list_social_pages and create_post are available.

Windsurf

  1. Edit ~/.codeium/windsurf/mcp_config.json
  2. Add the configuration below.
{
  "mcpServers": {
    "cutedyno": {
      "command": "npx",
      "args": ["-y", "cutedyno-mcp"],
      "env": {
        "CUTEDYNO_API_KEY": "cdyn_live_YOUR_KEY"
      }
    }
  }
}
Try asking your agent: “List my connected social pages on CuteDyno” or “Draft a LinkedIn post about our product launch and save it as a draft.”

Built with the MCP TypeScript SDK. See also the REST API reference for raw HTTP endpoints.