> ## 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.

# Introduction

> MagicPost programmatic API and MCP server for LLM integrations.

MagicPost exposes a **public REST API** (`/api/v1/*`) and an **MCP server** so you
can manage LinkedIn posts, schedule them, and pull analytics from any program
or LLM client.

> [card] [Quickstart](https://dev.magicpost.in/quickstart.md)
>
> Connect Claude Desktop to your MagicPost account in 3 steps.

> [card] [MCP tools](https://dev.magicpost.in/mcp/tools.md)
>
> The 38 tools available to your LLM client.

> [card] [API reference](https://dev.magicpost.in/api-reference/overview.md)
>
> Raw REST endpoints with curl examples.

> [card] [Authentication](https://dev.magicpost.in/essentials/authentication.md)
>
> How API keys work, scopes, rotation.

## What you can do

* **Generate posts** in your own voice or an imported creator's style
* **Attach chat-provided media** to a draft before scheduling or publishing
* **Schedule and publish posts** to LinkedIn (with same-day & exact-slot warnings)
* **Pull a compact analytics summary** (top posts, totals, averages)
* **List and edit your drafts**
* **Find inspiration** from a global catalogue of high-performing posts
* **Detect and manage leads** from your posts' engagement, scored against your ICPs
* **Manage your org** as a super\_admin — teammates' analytics, posts, and scheduling
* **Trigger a fresh sync** of your LinkedIn data and wait for completion

Most operations are scoped to your own account. Org super\_admins can
additionally read and act on their teammates' posts and analytics.

## Two ways to use it

> [accordion] MCP — for LLM clients (Claude Desktop, Cursor, claude.ai)
>
> The MCP server at `mcp.magicpost.in` exposes the API as **tools** your LLM
> can call. The recommended way for users who want to operate MagicPost from
> inside a conversation.
>
> [→ See MCP setup](https://dev.magicpost.in/mcp/overview.md)

> [accordion] REST — for scripts, integrations, and SDKs
>
> The same API is also reachable directly at `api.magicpost.in/api/v1/*`
> with a `Bearer mp_*` token. Use this when you don't need an LLM in the
> loop.
>
> [→ See API reference](https://dev.magicpost.in/api-reference/overview.md)

## Status

* **Base URL** (production): `https://api.magicpost.in`
* **MCP endpoint**: `https://mcp.magicpost.in/mcp`
* **Authentication**: Personal Access Tokens (PATs), generated from
  [your account settings](https://app.magicpost.in/account?tab=api-keys)
* **Versioning**: only `v1` exists today. Breaking changes will ship under `v2`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.