01
The catalogue
37 tools · 7 categoriesRead-only tools never mutate state; destructive tools (publish, delete, disconnect) trigger explicit confirmation in clients that honour the destructiveHint annotation. Two further tools are iframe-internal and are not listed here — the model is never meant to call them.
Identity & workspaces
| Tool | Access | What it does |
|---|---|---|
| whoami | Read | Profile of the authenticated user. |
| list_workspaces | Read | List all workspaces the user belongs to. Shows isDefault flag. |
| set_default_workspace | Write | Set or clear the default workspace so subsequent tools omit workspace_id. |
| create_workspace | Write | Create a new workspace owned by the authenticated user. |
| get_workspace_settings | Read | Brand identity, content guidelines, target audience, and per-platform preferences. |
| update_workspace_identity | Destructive | Rename a workspace or update its description. |
| update_workspace_settings | Destructive | Mutate workspace-level content guidelines and brand settings. |
Social accounts
| Tool | Access | What it does |
|---|---|---|
| list_social_accounts | Read | All connected social accounts with health, expiry, and platform. |
| get_connection_urls | Read | OAuth URLs for connecting new social accounts. |
| disconnect_social_account | Destructive | Revoke a connected social account; tokens are deleted server-side. |
| fetch_platform_posts | Read | Pull recent posts from a connected platform. These posts are the voice — the model reads them and matches them. |
Posts — read
| Tool | Access | What it does |
|---|---|---|
| get_post_context | Read | One-call drafting bundle: workspace identity, the target account, and its recent posts with engagement. Call this before writing. |
| list_posts | Read | List drafts, scheduled, published, and failed posts. Filterable by status and platform. |
| search_posts | Read | Full-text search across post bodies, hashtags, and per-platform copy. |
| get_post | Read | Single post with full payload (text, media, status, per-platform URLs). |
| get_post_history | Read | Per-day metric history for a published post — likes / comments / shares / impressions. |
Posts — write
| Tool | Access | What it does |
|---|---|---|
| create_post | Write | Create a DRAFT post. Does not publish or schedule on its own — follow up with schedule_post or publish_post. |
| update_post | Write | Mutate any field on a post — text, platforms, hashtags, media, schedule time, per-platform copy. |
| duplicate_post | Write | Clone an existing post into a fresh draft. |
| delete_post | Destructive | Soft-delete a post. For published posts also enqueues platform-side deletion when the connector supports it. |
Posts — publishing
| Tool | Access | What it does |
|---|---|---|
| publish_post | Destructive | Publish a draft immediately to every configured platform. Waits up to ~25 seconds for terminal status and returns per-platform URLs. |
| schedule_post | Destructive | Schedule a draft for a future timestamp. Server enforces that the time is in the future. |
| retry_failed_post | Destructive | Retry a previously-failed publish — useful when a token was refreshed or rate limits cleared. |
| comment_post | Destructive | Comment on a published LinkedIn post as the connected account. |
Analytics & planning
| Tool | Access | What it does |
|---|---|---|
| get_performance | Read | Aggregate engagement totals across the workspace for a given window. |
| get_engagement_history | Read | Per-day engagement timeseries across the workspace. |
| get_optimal_posting_times | Read | Suggested posting windows per platform inferred from historical engagement. |
| refresh_post_metrics | Write | Hit the platform APIs live for specific posts and refresh their cached metrics. Slow but freshest — prefer get_performance for broad reads. |
| get_calendar | Read | Scheduled and published posts grouped by date. Renders as an interactive calendar in MCP App clients. |
Media
| Tool | Access | What it does |
|---|---|---|
| list_media | Read | Workspace media library — images, video, PDFs. |
| get_media | Read | Single media item with download URL and per-mime metadata. |
| upload_media | Write | Ingest a file from a public URL (e.g. AI-generated image hosted elsewhere). LLM-facing path; the post-card's Add media picker uses upload_media_inline internally with base64. |
| attach_chatgpt_file | Write | Attach a file the user added to the chat, downloaded server-side so its size costs no context. |
| attach_media | Write | Attach media items to a draft post. |
| delete_media | Destructive | Soft-delete a media item; does not affect posts that already reference it. |
| request_upload_url | Write | Mint a short-lived signed PUT URL for a direct upload. For hosts without a media picker. |
| register_uploaded_media | Write | Validate a signed-PUT upload and register it in the workspace media library. |
Tool argument schemas are introspected from the server live — connect a client and call tools/list to see the canonical JSON Schemas with required fields and types.