# Typefully — how to use (mcp.ai)

Connect your Typefully account and use 16 tools for social media marketing straight from your AI agent. Connect with your own API key. Typefully is a platform for creating and managing AI-powered content.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_typefully?ms=1787293380000`
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. `typefully_create_draft`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/typefully`
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/typefully/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/typefully/create/draft` — Create a new draft with platform-specific content for multi-platform publishing. Use this action when you need to create a draft that can target multiple social media platforms (X, LinkedIn, Threads, 
  - body: { tags?: string[], share?: boolean, platforms: object, publish_at?: string, draft_title?: string, social_set_id: integer, scratchpad_text?: string }
- `POST https://api.mcp.ai/api/typefully/create/tag` — Creates a new tag for organizing drafts within a social set in Typefully. Use this action when you need to add a new organizational tag to help categorize and group drafts within a specific social acc
  - body: { name: string, social_set_id: integer }
- `POST https://api.mcp.ai/api/typefully/delete/draft` — Permanently deletes a draft from Typefully. This action cannot be undone. Use this action when you need to remove a draft that is no longer needed. WARNING: This is a destructive operation. Once delet
  - body: { draft_id: integer, social_set_id: integer }
- `POST https://api.mcp.ai/api/typefully/get/current/user` — Get the current authenticated user's information. Returns user details including profile information, email, signup date, and optional profile image URL. Use this action when you need to retrieve the 
- `POST https://api.mcp.ai/api/typefully/get/draft` — Retrieves a single draft by its ID with full details including platform-specific content, tags, status, and scheduling information. Use this action when you need to retrieve comprehensive details abou
  - body: { draft_id: integer, social_set_id: integer }
- `POST https://api.mcp.ai/api/typefully/get/media/status` — Check the processing status of an uploaded media file. Use when you need to poll the status of a media file after uploading it. Poll this endpoint until status becomes 'ready' before using the media i
  - body: { media_id: string, social_set_id: integer }
- `POST https://api.mcp.ai/api/typefully/get/queue` — Get the scheduled content queue for a social set within a date range. Returns upcoming scheduled drafts organized by day with their scheduled times. Use this action when you need to view what content 
  - body: { end_date: string, start_date: string, social_set_id: integer }
- `POST https://api.mcp.ai/api/typefully/get/queue/schedule` — Get the queue schedule configuration for a social set, including posting slots and timezone settings. Use this action when you need to retrieve the scheduling rules and timezone configuration for a so
  - body: { social_set_id: integer }
- `POST https://api.mcp.ai/api/typefully/get/social/set` — Get detailed information about a specific social set, including all connected platforms (X, LinkedIn, Mastodon, Threads, Bluesky) with account details and profile information. Use this action when you
  - body: { social_set_id: integer }
- `POST https://api.mcp.ai/api/typefully/initialize/media/upload` — Initializes a media upload by returning a presigned URL. Use when you need to upload images, videos, GIFs, or PDFs to attach to draft posts. First call this action to get a `media_id` and `upload_url`
  - body: { file_name: string, social_set_id: integer }
- `POST https://api.mcp.ai/api/typefully/list/drafts` — List drafts for a social set with filtering and sorting options. Use this action when you need to retrieve drafts from a specific social set in Typefully. Supports filtering by status (draft, schedule
  - body: { tag?: string[], limit?: integer, offset?: integer, status?: string, order_by?: string, social_set_id: integer }
- `POST https://api.mcp.ai/api/typefully/list/social/sets` — List all social sets (groups of connected platform accounts) accessible to the authenticated user. Returns paginated list of social sets with basic info including id, username, name, and profile image
  - body: { limit?: integer, offset?: integer }
- `POST https://api.mcp.ai/api/typefully/list/tags` — List all tags for a social set. Tags help organize and categorize drafts. Use this action when you need to retrieve all tags associated with a specific social set to organize, filter, or categorize dr
  - body: { limit?: integer, offset?: integer, social_set_id: integer }
- `POST https://api.mcp.ai/api/typefully/resolve/linked/in/organization` — Resolve a LinkedIn organization from its public URL. Returns the organization URN needed for mentions in LinkedIn posts. Use this action when you need to get the LinkedIn organization identifier to in
  - body: { social_set_id: integer, organization_url: string }
- `POST https://api.mcp.ai/api/typefully/update/draft` — Update an existing draft with partial update semantics. Use this action when you need to modify specific fields of an existing draft. Only the fields you provide will be updated; omitted fields remain
  - body: { tags?: string[], share?: boolean, draft_id: integer, platforms?: object, publish_at?: string, draft_title?: string, social_set_id: integer, scratchpad_text?: string }
- `POST https://api.mcp.ai/api/typefully/update/queue/schedule` — Replace the queue schedule configuration for a social set. Defines the posting slots for scheduled content. Use this action when you need to update or configure the posting schedule for a social accou
  - body: { rules: object[], social_set_id: integer }

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

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