# Typefully — MCP server on 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.

By: mcp.ai · official
Page: https://mcp.ai/typefully

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_typefully?ms=1787293440000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/typefully/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/typefully/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/typefully/skill.md
Postman collection (v2.1): https://mcp.ai/typefully/postman.json

## Tools
- typefully_create_draft(tags?: string[], share?: boolean, platforms: object, publish_at?: string, draft_title?: string, social_set_id: integer, scratchpad_text?: string) — 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, 
- typefully_create_tag(name: string, social_set_id: integer) — 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
- typefully_delete_draft(draft_id: integer, social_set_id: integer) — 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
- 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 
- typefully_get_draft(draft_id: integer, social_set_id: integer) — 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
- typefully_get_media_status(media_id: string, social_set_id: integer) — 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
- typefully_get_queue(end_date: string, start_date: string, social_set_id: integer) — 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 
- typefully_get_queue_schedule(social_set_id: integer) — 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
- typefully_get_social_set(social_set_id: integer) — 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
- typefully_initialize_media_upload(file_name: string, social_set_id: integer) — 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`
- typefully_list_drafts(tag?: string[], limit?: integer, offset?: integer, status?: string, order_by?: string, social_set_id: integer) — 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
- typefully_list_social_sets(limit?: integer, offset?: integer) — 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
- typefully_list_tags(limit?: integer, offset?: integer, social_set_id: integer) — 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
- typefully_resolve_linked_in_organization(social_set_id: integer, organization_url: string) — 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
- typefully_update_draft(tags?: string[], share?: boolean, draft_id: integer, platforms?: object, publish_at?: string, draft_title?: string, social_set_id: integer, scratchpad_text?: string) — 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
- typefully_update_queue_schedule(rules: object[], social_set_id: integer) — 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

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

## Links
Docs: https://mcp.ai/docs/mcps/typefully
Website: https://mcp.ai/mcps/typefully