> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trypost.it/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Connect AI coding assistants to your TryPost account using the Model Context Protocol

TryPost provides a built-in [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that lets AI coding assistants manage your social media scheduling directly. Your AI assistant can create and publish posts, manage signatures, labels, webhooks, and repurposes, fetch metrics, and more — all through natural language.

## What is MCP?

MCP is an open protocol that connects AI assistants to external tools and data sources. Instead of copying and pasting API calls, your AI assistant can interact with TryPost directly.

## Available tools

TryPost exposes a full set of MCP tools for end-to-end content workflows. See the [Tools reference](/ai/tools-reference) for parameters and examples.

| Category | Tools | Description |
| - | - | - |
| **Posts** | List, Get, Create, Update, Publish, Delete, Attach Media from URL, Request Media Upload, Attach Media from Upload, Preview, Get Metrics | Create, schedule, publish, and analyze posts across all connected platforms — including local-file uploads via signed URLs |
| **Assets** | List, Get, Attach Existing | Browse the workspace Asset Library and attach an existing item to a draft or scheduled post |
| **Platforms** | List Content Types | Discover valid `content_type` values and per-platform limits |
| **Signatures** | List, Create, Update, Delete | Manage reusable text blocks (hashtag sets, CTAs, link callouts) |
| **Labels** | List, Create, Update, Delete | Manage color-coded labels for organizing posts |
| **Social Accounts** | List, List Pinterest Boards, List Discord Channels, Toggle | View connected accounts, resolve Pinterest `board_id` / Discord `channel_id`, toggle active/inactive |
| **Workspace** | Get | Get current workspace details |
| **API Keys** | List, Create, Delete | Manage API keys |
| **Webhooks** | List, Get, Create, Update, Delete, Send Test, Rotate Secret, List Logs, Replay | Subscribe to post events and inspect signed deliveries |
| **Repurpose** | List, Get, Create, Update, Activate, Pause, Resume, Disable, Delete, List Items, List Source Formats | Watch Instagram or Facebook and republish new videos to other networks |

## How it works

<Note>
  MCP access on **TryPost Cloud** requires an active subscription. New accounts pay **\$1 for the first month** during welcome. See [Plans & billing](/knowledge-base/plans-and-billing) for details. Self-hosted instances skip this check.
</Note>

<Steps>
  <Step title="Add the TryPost MCP server in your assistant">
    Use your assistant's MCP configuration to add a remote HTTP server pointing to `https://app.trypost.it/mcp/trypost`. Each [client guide](#next-steps) below has the exact command or settings file.
  </Step>

  <Step title="Sign in through your browser">
    The first time the assistant calls a tool, TryPost opens a browser window asking you to sign in and authorize the connection. Click **Allow** and you're done — the assistant holds the OAuth token from then on, with automatic refresh.
  </Step>

  <Step title="Start using natural language">
    Ask your assistant to manage your TryPost account. For example: "Create a new post for LinkedIn next Tuesday at 9am" or "List all my scheduled posts."
  </Step>
</Steps>

## Server URL

```
https://app.trypost.it/mcp/trypost
```

## Authentication

TryPost's MCP server uses **OAuth 2.1** with Dynamic Client Registration (DCR), PKCE, and the `mcp:use` scope. Modern MCP clients (Claude, Claude Code, Claude Desktop, ChatGPT, Muse Code, Perplexity, Cursor, Windsurf, VS Code, GitHub Copilot in IDE, Gemini CLI, OpenCode, OpenClaw, Codex) detect this automatically from the `.well-known` discovery endpoints — you only point them at the URL and the browser sign-in handles the rest.

<Warning>
  Personal Access Tokens from **Settings → API Keys** authenticate the [REST API](/api-reference/introduction) only. They are **not** accepted on `/mcp/trypost`. MCP requires an OAuth grant with the `mcp:use` scope (browser sign-in from a supported client). Manage connected assistants under workspace **Settings → MCP**.
</Warning>

## Troubleshooting

<AccordionGroup>
  <Accordion title="HTTP 402 — Active subscription required">
    Your OAuth grant is valid and the config is correct — the account behind it just doesn't have an active subscription. Open [app.trypost.it](https://app.trypost.it), pick a plan, then reconnect the MCP server. Self-hosted instances skip this check.
  </Accordion>

  <Accordion title="HTTP 401 — Unauthenticated">
    The OAuth session expired and refresh failed, or the access token is missing/malformed/revoked. Re-run the assistant's connect flow to sign in again.
  </Accordion>

  <Accordion title="HTTP 403 — MCP OAuth authorization required">
    The request used a Personal Access Token (API key) or an OAuth token without the `mcp:use` scope. Remove any `Authorization: Bearer …` API key from the MCP config and connect with OAuth instead. For scripts and CI, call the [REST API](/api-reference/introduction) with an API key — not the MCP endpoint.
  </Accordion>

  <Accordion title="Server shows as “Failed to connect”">
    Run the connection probe your assistant exposes (for example `claude mcp list` or `devin mcp list`). The HTTP status from the probe tells you which case you're in: `402` → see above; `401` → re-authenticate; `403` → use OAuth (not an API key); anything else → open an issue on [GitHub](https://github.com/trypostit/trypost/issues).
  </Accordion>

  <Accordion title="Browser doesn't open during sign-in">
    Some clients print the authorize URL to the terminal instead of launching the browser when running over SSH or inside a container. Copy the URL into a local browser, complete the flow, and the assistant will pick up the callback automatically. If the callback port is blocked, use a client that can finish OAuth locally, or drive TryPost through the [REST API](/api-reference/introduction) with an API key.
  </Accordion>
</AccordionGroup>

## Next steps

Every Build with AI page is linked here — the tools reference plus all 16 setup guides.

<CardGroup cols={3}>
  <Card title="Tools reference" icon="wrench" href="/ai/tools-reference">
    Every MCP tool, parameters, and the publish workflow.
  </Card>

  <Card title="Claude web" icon="https://mintcdn.com/trypostit/ECPn-cQFoyRmjNWl/images/ai/claude.svg?fit=max&auto=format&n=ECPn-cQFoyRmjNWl&q=85&s=e99cf6eb522462dfe34752ccfa2bb06f" href="/ai/claude" width="2500" height="2500" data-path="images/ai/claude.svg">
    Claude on the web (claude.ai).
  </Card>

  <Card title="Claude Code" icon="https://mintcdn.com/trypostit/ECPn-cQFoyRmjNWl/images/ai/claude.svg?fit=max&auto=format&n=ECPn-cQFoyRmjNWl&q=85&s=e99cf6eb522462dfe34752ccfa2bb06f" href="/ai/claude-code" width="2500" height="2500" data-path="images/ai/claude.svg">
    CLI assistant by Anthropic.
  </Card>

  <Card title="Claude Desktop" icon="https://mintcdn.com/trypostit/ECPn-cQFoyRmjNWl/images/ai/claude.svg?fit=max&auto=format&n=ECPn-cQFoyRmjNWl&q=85&s=e99cf6eb522462dfe34752ccfa2bb06f" href="/ai/claude-desktop" width="2500" height="2500" data-path="images/ai/claude.svg">
    Desktop app by Anthropic.
  </Card>

  <Card title="ChatGPT" icon="https://mintcdn.com/trypostit/ECPn-cQFoyRmjNWl/images/ai/chatgpt.svg?fit=max&auto=format&n=ECPn-cQFoyRmjNWl&q=85&s=e872f8a3d1dcef6ffedf18ed3cb427c9" href="/ai/chatgpt" width="2500" height="2500" data-path="images/ai/chatgpt.svg">
    OpenAI ChatGPT with MCP apps.
  </Card>

  <Card title="Muse AI Agent" icon="https://mintcdn.com/trypostit/ni22MQKrVgzHKnLi/images/ai/muse.svg?fit=max&auto=format&n=ni22MQKrVgzHKnLi&q=85&s=876e04f8998c0bcdc78c7e7adcb918b0" href="/ai/muse" width="100" height="100" data-path="images/ai/muse.svg">
    Personal agent by Meta.
  </Card>

  <Card title="Muse Code" icon="https://mintcdn.com/trypostit/ni22MQKrVgzHKnLi/images/ai/muse.svg?fit=max&auto=format&n=ni22MQKrVgzHKnLi&q=85&s=876e04f8998c0bcdc78c7e7adcb918b0" href="/ai/muse-code" width="100" height="100" data-path="images/ai/muse.svg">
    CLI assistant by Meta.
  </Card>

  <Card title="Perplexity" icon="https://mintcdn.com/trypostit/ECPn-cQFoyRmjNWl/images/ai/perplexity.svg?fit=max&auto=format&n=ECPn-cQFoyRmjNWl&q=85&s=b43ead698e9bf9511ea0bd3de03a544f" href="/ai/perplexity" width="16" height="16" data-path="images/ai/perplexity.svg">
    Perplexity chat and Computer.
  </Card>

  <Card title="Grok" icon="https://mintcdn.com/trypostit/cN8e4E77yD6iUrr7/images/ai/grok.svg?fit=max&auto=format&n=cN8e4E77yD6iUrr7&q=85&s=970896f47284b00bd839162fc7b84337" href="/ai/grok" width="16" height="16" data-path="images/ai/grok.svg">
    Grok on the web, iOS, and Android.
  </Card>

  <Card title="Cursor" icon="https://mintcdn.com/trypostit/ECPn-cQFoyRmjNWl/images/ai/cursor.svg?fit=max&auto=format&n=ECPn-cQFoyRmjNWl&q=85&s=4f536cfb6dbabd4bdbf91745adc3fafe" href="/ai/cursor" width="16" height="16" data-path="images/ai/cursor.svg">
    AI-powered code editor.
  </Card>

  <Card title="Devin" icon="https://mintcdn.com/trypostit/pZtskrEY5ipAEvdB/images/ai/devin.svg?fit=max&auto=format&n=pZtskrEY5ipAEvdB&q=85&s=470dc459634b6105e5562c40c3654c9d" href="/ai/devin" width="44" height="50" data-path="images/ai/devin.svg">
    AI software engineer by Cognition.
  </Card>

  <Card title="VS Code" icon="https://mintcdn.com/trypostit/ECPn-cQFoyRmjNWl/images/ai/vscode.svg?fit=max&auto=format&n=ECPn-cQFoyRmjNWl&q=85&s=50fcd5b135c6d7574d5790bf3e8f035c" href="/ai/vs-code" width="16" height="16" data-path="images/ai/vscode.svg">
    Native MCP support in Copilot Chat.
  </Card>

  <Card title="GitHub Copilot" icon="https://mintcdn.com/trypostit/ECPn-cQFoyRmjNWl/images/ai/github-copilot.svg?fit=max&auto=format&n=ECPn-cQFoyRmjNWl&q=85&s=f129365749410e9def9d49d9ff6ddf9e" href="/ai/github-copilot" width="24" height="24" data-path="images/ai/github-copilot.svg">
    Copilot agent mode.
  </Card>

  <Card title="Gemini CLI" icon="https://mintcdn.com/trypostit/ECPn-cQFoyRmjNWl/images/ai/gemini.svg?fit=max&auto=format&n=ECPn-cQFoyRmjNWl&q=85&s=335cc95fc73889395d1b092d6a93394f" href="/ai/gemini-cli" width="16" height="16" data-path="images/ai/gemini.svg">
    CLI assistant by Google.
  </Card>

  <Card title="OpenCode" icon="https://mintcdn.com/trypostit/ECPn-cQFoyRmjNWl/images/ai/opencode.svg?fit=max&auto=format&n=ECPn-cQFoyRmjNWl&q=85&s=cd00ce6e8adf6419044460dc494cb012" href="/ai/opencode" width="24" height="24" data-path="images/ai/opencode.svg">
    Open-source CLI assistant.
  </Card>

  <Card title="OpenClaw" icon="https://mintcdn.com/trypostit/ECPn-cQFoyRmjNWl/images/ai/openclaw.svg?fit=max&auto=format&n=ECPn-cQFoyRmjNWl&q=85&s=f47b875e9a6bd29d23d3c38742b0133a" href="/ai/openclaw" width="120" height="120" data-path="images/ai/openclaw.svg">
    Personal AI assistant gateway.
  </Card>

  <Card title="Hermes" icon="https://mintcdn.com/trypostit/anNmn10eWDSrNXKl/images/ai/hermes.png?fit=max&auto=format&n=anNmn10eWDSrNXKl&q=85&s=647f0ec0920372e561063e7e1ff5e8cb" href="/ai/hermes" width="256" height="256" data-path="images/ai/hermes.png">
    Hermes Agent by Nous Research.
  </Card>

  <Card title="Codex" icon="https://mintcdn.com/trypostit/ECPn-cQFoyRmjNWl/images/ai/codex.svg?fit=max&auto=format&n=ECPn-cQFoyRmjNWl&q=85&s=7b88e4b9b19c37b3803e20090d3d3152" href="/ai/codex" width="16" height="16" data-path="images/ai/codex.svg">
    CLI agent by OpenAI.
  </Card>

  <Card title="Antigravity" icon="https://mintcdn.com/trypostit/ECPn-cQFoyRmjNWl/images/ai/antigravity.svg?fit=max&auto=format&n=ECPn-cQFoyRmjNWl&q=85&s=2a088ef86e93f6b072089b7d9a773fe3" href="/ai/antigravity" width="16" height="16" data-path="images/ai/antigravity.svg">
    AI agent by Google.
  </Card>
</CardGroup>


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