Skip to main content

Documentation Index

Fetch the complete documentation index at: https://dev.magicpost.in/llms.txt

Use this file to discover all available pages before exploring further.

The MagicPost MCP server lets any Model Context Protocol client — Claude Desktop, Cursor, claude.ai, or a custom agent — operate your MagicPost account from within a conversation, without leaving the chat. It’s a thin, stateless proxy over the REST API. Everything you can do with curl, you can do via the MCP — just from an LLM conversation.

​
What you can do

  • Read your LinkedIn analytics and pull top-line metrics across any time window
  • List your scheduled, draft, and published posts
  • Create new draft posts or edit the text of existing ones
  • Schedule posts for future publication, with same-day and exact-slot conflict warnings
  • Cancel a scheduled post at any time
  • Publish a post to LinkedIn immediately
  • Refresh your LinkedIn data and wait for the sync to complete

​
Architecture

   ┌─────────────────────┐
   │   MCP client        │  Claude Desktop, Cursor, claude.ai, ...
   │  (your LLM tool)    │
   └──────────┬──────────┘
              │  HTTPS, Authorization: Bearer mp_*
              ▼
   ┌─────────────────────┐
   │ mcp.magicpost.in    │  Validates your PAT (cached 60s),
   │  (MCP server)       │  forwards calls to api.magicpost.in
   └──────────┬──────────┘
              │  HTTPS, same PAT
              ▼
   ┌─────────────────────┐
   │ api.magicpost.in    │  Executes your operation and
   │  /api/v1/*          │  returns the result
   └─────────────────────┘

​
Endpoint

The MCP server is available at: 
https://mcp.magicpost.in/mcp
Transport: streamable-http (current MCP standard, stateless mode, JSON responses).

​
Available tools

The server exposes 8 tools. See the full tools catalog for inputs, outputs, and examples.
ToolPurpose
get_metrics_summaryTop-line analytics and top posts by impressions
refresh_my_postsPull fresh LinkedIn data and wait for completion
list_my_postsList drafts, scheduled posts, or published posts
get_postFetch the full record for a single post
create_or_update_postCreate a new draft or edit an existing post’s text
schedule_postSchedule a post with same-day and exact-slot conflict warnings
cancel_scheduled_postUn-schedule a post (idempotent)
publish_post_nowPublish a post to LinkedIn immediately

​
Limitations

  • Text only in v1. Media uploads (images, videos) are not supported via the MCP. After the LLM creates or edits a draft, open the MagicPost web UI to attach media before publishing.
  • No @mention resolution. The MCP cannot resolve a person’s name to the correct LinkedIn profile. Finalize @mentions in the web UI.
  • No cross-user access. Every tool is scoped to your own account. You cannot read or modify another user’s posts.

​
Next steps

Claude Desktop

Connect the flagship LLM client in three steps.

Cursor

Same backend, IDE workflow.

Tools catalog

Inputs, outputs, and examples for all 8 tools.

API reference

The REST endpoints behind the MCP.