# Dotsimple — how to use (mcp.ai)

Connect your Dotsimple account and use 11 tools for social media marketing straight from your AI agent. Connect with your own API key. DotSimple is a comprehensive social media management tool that enables users to plan, create, and publish content across multiple platforms, leveraging AI for content generation and providing analytics for performance optimization.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_dotsimple?ms=1787291280000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `dotsimple_create_tag`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/dotsimple`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/dotsimple/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/dotsimple/create/tag` — Create a new tag in DotSimple workspace for categorizing and organizing social media content. Tags are used to label and filter posts, drafts, and media files in DotSimple. Each tag has a unique name 
  - body: { name: string, hex_color: string, workspace_id?: string }
- `POST https://api.mcp.ai/api/dotsimple/delete/media/files` — Deletes one or more media files (images/videos) from your DotSimple workspace. Use this tool when you need to remove media files that are no longer needed. You must provide the media file IDs as strin
  - body: { items: string[] }
- `POST https://api.mcp.ai/api/dotsimple/delete/tag` — Delete a tag by its UUID from your DotSimple workspace. Use this tool when you need to remove a specific tag. Ensure the UUID is correct before invoking. The tag will be permanently deleted from your 
  - body: { uuid: string, workspace_id?: string }
- `POST https://api.mcp.ai/api/dotsimple/get/media/file` — Tool to retrieve details of a specific media file. Use when you have the mediaFileId and need its metadata.
  - body: { mediaFileId: string, workspace_id?: string }
- `POST https://api.mcp.ai/api/dotsimple/get/tag` — Tool to retrieve details for a specific tag by UUID. Use when you need full tag information after obtaining its identifier.
  - body: { tag_id: string, workspace_id?: string }
- `POST https://api.mcp.ai/api/dotsimple/list/accounts` — List all connected social media accounts in the DotSimple workspace. Returns details about each connected account including ID, name, type (e.g., Google, Microsoft), connection status, and credentials
  - body: { workspace_id?: string }
- `POST https://api.mcp.ai/api/dotsimple/list/autoresponders` — List all autoresponders in the DotSimple workspace with optional pagination. Returns details about each autoresponder including ID, name, and status. Use this to browse through your autoresponder setu
  - body: { page?: integer, per_page?: integer, workspace_id?: string }
- `POST https://api.mcp.ai/api/dotsimple/list/media/files` — List all media files in a DotSimple workspace with optional pagination. This tool retrieves media files from a specific workspace. The workspace_id is required and can be found in the DotSimple dashbo
  - body: { page?: integer, workspace_id: string }
- `POST https://api.mcp.ai/api/dotsimple/list/posts` — List all posts in a DotSimple workspace with optional pagination. This tool retrieves posts from a specific workspace. The workspace_id is required and can be found in your DotSimple dashboard URL (e.
  - body: { page?: integer, page_size?: integer, workspace_id: string }
- `POST https://api.mcp.ai/api/dotsimple/list/reports` — List all account-level email marketing reports from the DotSimple workspace. Returns paginated report entries with aggregated metrics for each date, including emails sent, delivered, opens, clicks, un
  - body: { page?: integer, page_size?: integer, workspace_id?: string }
- `POST https://api.mcp.ai/api/dotsimple/list/tags` — List all tags available in a DotSimple workspace for content organization and categorization. Tags in DotSimple are used to label and categorize social media posts, drafts, and media files. Each tag h
  - body: { workspace_id?: string }

## Example prompts
- "What can I do in Dotsimple?"
- "Show me a summary of my Dotsimple account"

## More
- Page: https://mcp.ai/dotsimple
- Agent spec (llms.txt): https://mcp.ai/dotsimple/llms.txt
- Postman collection: https://mcp.ai/dotsimple/postman.json