MCP overview

The MagicPost MCP server lets any Model Context Protocol client — Claude Desktop, Cursor, claude.ai, custom agents — operate your MagicPost account from within a conversation, without leaving the chat.

What it does

Generates posts in your own voice — or in an imported creator’s writing style
Reads your analytics, lists your draft / scheduled / published posts
Writes new drafts, schedules posts (same-day & exact-slot warnings), cancels, publishes now
Finds inspiration in a global catalogue of high-performing posts
Detects & manages leads from your posts’ engagement, scored against your ICPs and synced to your CRM
Manages your org (super_admins) — read teammates’ analytics and posts, schedule on their behalf
Refreshes your LinkedIn data and waits for completion

It’s a thin, stateless proxy over our REST API. Everything you can do with curl, you can do via the MCP — just from an LLM conversation.

Architecture

   ┌─────────────────────┐
   │   MCP client        │  Claude Desktop, Cursor, claude.ai, ...
   │  (your LLM tool)    │
   └──────────┬──────────┘
              │  HTTPS, Authorization: Bearer mp_*
              ▼
   ┌─────────────────────┐
   │ mcp.magicpost.in    │  Validates the PAT (cached 60s),
   │  (MCP server)       │  forwards calls to api.magicpost.in
   └──────────┬──────────┘
              │  HTTPS, same PAT
              ▼
   ┌─────────────────────┐
   │ api.magicpost.in    │  Our Flask backend.
   │  /api/v1/*          │  Runs your operation against Supabase,
   └─────────────────────┘  Airtable, LinkedIn OAuth tokens, etc.

Endpoint

https://mcp.magicpost.in/mcp

Transport: streamable-http (current MCP standard, stateless mode, JSON responses).

Available tools

The server exposes 25 tools — see the full catalog.

Generation & styles

Tool	Purpose
`generate_post`	Generate a new LinkedIn post and persist it as a draft.
`list_my_writing_styles`	List the LinkedIn profiles the user has imported as writing-style candidates, including which one is currently active in the UI.
`find_writing_style_profile`	Search the global LinkedIn profile catalog by name or LinkedIn URL.
`add_writing_style_profile`	Attach a LinkedIn profile to the user’s account as a writing-style candidate, scraping its posts if needed.

Posts

Tool	Purpose
`list_my_posts`	List the user’s posts filtered by lifecycle status.
`get_post`	Fetch the full record for a single MagicPost owned by the user.
`create_or_update_post`	Create a new draft post (no post_id) or update an existing one’s text.

Scheduling

Tool	Purpose
`schedule_post`	Schedule a post for future publication on LinkedIn.
`cancel_scheduled_post`	Cancel a scheduled post.
`publish_post_now`	Publish a post to LinkedIn immediately (no schedule).

Analytics

Tool	Purpose
`get_metrics_summary`	Get a compact summary of the user’s LinkedIn analytics.
`refresh_my_posts`	Trigger a fresh pull of the user’s LinkedIn posts and wait until done.

Inspiration

Tool	Purpose
`search_inspiration_posts`	Search the global LinkedIn inspiration catalogue (NOT the user’s own posts) for high-performing examples to draw inspiration from.

Leads & CRM

Tool	Purpose
`list_leads`	List the user’s LinkedIn leads (prospects detected from the engagement on their posts and qualified against their ICPs).
`get_lead`	Full detail of one lead: profile, interactions (likes/comments on the user’s posts), qualification reasoning, icebreaker, and CRM sync state (`deliveries` to connected external CRMs).
`list_icps`	List the user’s ICPs (Ideal Customer Profiles).
`get_leads_summary`	Leads quota status: trial state (is_trial, trial_days_remaining, trial_ends_at), monthly quota (leads_monthly_included, leads_consumed_in_period, leads_remaining), top-ups (topup_leads_remaining, topups_detail), and renewal date (period_end).
`get_detection_status`	Poll the status of running lead detections (they are async and typically take 2-15 minutes).
`detect_leads`	Detect new leads from the engagement (likes + comments) on one of the user’s LinkedIn posts.
`update_lead`	Update a lead’s pipeline fields.

Org / team

Tool	Purpose
`list_org_members`	List the active members of your organisation.
`get_org_metrics_summary`	Compact analytics for the org or one specific member.
`list_org_member_posts`	List posts across the org, optionally scoped to one member.
`get_org_member_post`	Fetch the full record of ONE post owned by a member of your org.
`schedule_member_post`	Schedule a post on behalf of an org member.

What it does NOT do (yet)

Media uploads (images, videos) — text-only for v1. Add media in the MagicPost web UI after the LLM creates a draft.
@mentions that need LinkedIn tag resolution — the LLM cannot pick the right LinkedIn profile from a name. Finalize @mentions in the web UI.

Most tools are scoped to your own account. Org super_admins additionally get read/scheduling access to their teammates’ posts and analytics via the *_org_* / *_member_* tools.

Next steps

Setup Claude Desktop

The flagship LLM client.

Setup Cursor

Same backend, IDE workflow.

Tool catalog

Inputs, outputs, examples for the 25 tools.

API reference

The REST endpoints behind the MCP.

Getting started

Essentials

MCP integration

What it does

Architecture

Endpoint

Available tools

Generation & styles

Posts

Scheduling

Analytics

Inspiration

Leads & CRM

Org / team

What it does NOT do (yet)

Next steps

Setup Claude Desktop

Setup Cursor

Tool catalog

API reference

​What it does

​Architecture

​Endpoint

​Available tools

​Generation & styles

​Posts

​Scheduling

​Analytics

​Inspiration

​Leads & CRM

​Org / team

​What it does NOT do (yet)

​Next steps

Setup Claude Desktop

Setup Cursor

Tool catalog

API reference

What it does

Architecture

Endpoint

Available tools

Generation & styles

Posts

Scheduling

Analytics

Inspiration

Leads & CRM

Org / team

What it does NOT do (yet)

Next steps