Developer docs

Antwork MCP connector

Connect Antwork to Claude, ChatGPT, Cursor, or any MCP-compatible AI assistant. Manage posts, brand DNA, analytics, and media from inside the chat — without switching tabs.

Overview

Antwork exposes its full social media management surface as an MCP (Model Context Protocol) server. Once connected, your AI assistant can draft, schedule, and publish posts, read brand strategy, fetch engagement metrics, and manage media — all on behalf of the authenticated Antwork user.

The connector follows the published MCP Apps spec: tool calls return both structured data and embedded UI widgets (calendar, posts table, analytics chart, media gallery, post preview) that render inline in supported hosts.

Server endpoint

URLhttps://api.antwork.io/mcp

TransportStreamable HTTP

AuthenticationOAuth 2.0 (authorization code + PKCE)

Discoveryhttps://api.antwork.io/.well-known/oauth-authorization-server

Add to Claude.ai

Open Settings → Connectors in Claude.ai.
Click Add custom connector.
Paste https://api.antwork.io/mcp as the server URL.
Sign in with your Antwork account when prompted and approve the requested scopes.
The 35 Antwork tools become available in any new chat.

Don't have an Antwork account? Sign up free — no card required.

OAuth scopes

Tokens are granted per-scope. Each tool enforces the minimum scope it needs via JWT verification on every request.

readList posts, media, brand DNA, analytics, voice profiles. Implied by all higher scopes.

writeCreate and update drafts, brand guidelines, workspace settings, attach media.

publishPublish or schedule posts to connected social platforms; retry failures; delete posts.

mediaUpload and delete items in the workspace media library.

Tools

35 tools across 6 categories. Each tool returns a structured JSON response; 12 of them additionally surface an interactive UI widget via the _meta.ui.resourceUri field.

Workspace discovery

whoamiget_workspace_contextget_workspace_settingsget_brand_dnaget_voice_profilesget_platform_limits

Posts (read)

list_postssearch_postsget_postget_post_historyget_post_statsget_calendarfetch_platform_posts

Posts (write)

create_postupdate_postduplicate_postdelete_postschedule_postpublish_postretry_failed_postgenerate_postcreate_campaign

Social accounts

list_social_accountsget_connection_urlsget_optimal_posting_times

Analytics

get_performanceget_engagement_history

Media

list_mediaget_mediaupload_mediaattach_mediadelete_media

Brand and workspace settings

update_brand_guidelinesupdate_brand_identityupdate_workspace_settings

UI widgets

Tools that return list-shaped or chart-shaped data attach an _meta.ui.resourceUri pointing to one of five embedded apps. Hosts that support MCP Apps render them inline; other hosts simply surface the structured data.

Posts table — list_posts, search_posts
Post preview — get_post, create_post, update_post, duplicate_post, generate_post
Analytics chart — get_engagement_history, get_post_history
Media gallery — list_media, get_media
Calendar — get_calendar

Data and privacy

The connector accesses only data the authenticated Antwork user already owns inside their workspace. No conversation content is collected; tool calls are logged for the user's own activity feed only and follow the standard Antwork retention policy.

See the privacy policy for the full data flow, retention windows, and revocation steps.

Revoking access

In Claude.ai: Settings → Connectors → Antwork → Disconnect. Removes the OAuth tokens on the host side.
In Antwork: Settings → Connected apps. Revokes server-side tokens and prevents future use of any cached refresh tokens.
For full data removal, submit a request via /data-deletion-request.

Support

For integration questions, open an issue on github.com/antwork-io/antwork/issues or email iker.gonzalez@antwork.io.