> ## 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 and labels, 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 |
| **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, Toggle                                                                                                                            | View connected accounts and toggle active/inactive                                                                         |
| **Workspace**       | Get                                                                                                                                     | Get current workspace details                                                                                              |
| **API Keys**        | List, Create, Delete                                                                                                                    | Manage API keys                                                                                                            |

## How it works

<Note>
  MCP access on **TryPost Cloud** requires an active trial or subscription. New accounts get a 7-day trial automatically. 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 Code, Claude Desktop, Cursor, Windsurf, VS Code, GitHub Copilot in IDE, Gemini CLI, OpenCode, 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.

<Accordion title="Bearer token fallback (CI, scripts, or clients without OAuth)">
  If your environment can't open a browser — for example a CI pipeline, the GitHub Copilot cloud coding agent, or a client that doesn't speak OAuth yet — you can authenticate with a Personal Access Token instead. Create one in **Settings > API Keys** on the [TryPost dashboard](https://app.trypost.it) and send it as `Authorization: Bearer YOUR_API_KEY`. The same token works for both the REST API and the MCP endpoint.

  Keep the token in a secret store, not committed to source. Rotate from **Settings > API Keys** if a key leaks.
</Accordion>

## Troubleshooting

<AccordionGroup>
  <Accordion title="HTTP 402 — Active subscription required">
    Your token is valid and the config is correct — the account behind it just doesn't have an active trial or subscription. Open [app.trypost.it](https://app.trypost.it), start a trial or pick a plan (7-day free trial), 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 (in the Bearer fallback) the token is missing/malformed/revoked. Re-run the assistant's connect flow to re-authenticate, or issue a new PAT from **Settings > API Keys**.
  </Accordion>

  <Accordion title="Server shows as “Failed to connect”">
    Run the connection probe your assistant exposes (for example `claude mcp list`). The HTTP status from the probe tells you which case you're in: `402` → see above; `401` → re-authenticate; 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 the Bearer fallback.
  </Accordion>
</AccordionGroup>

## Next steps

<Columns cols={3}>
  <Card title="Claude Code" icon="terminal" href="/ai/claude-code">
    CLI assistant by Anthropic.
  </Card>

  <Card title="Claude Desktop" icon="message-bot" href="/ai/claude-desktop">
    Desktop app by Anthropic.
  </Card>

  <Card title="Cursor" icon="arrow-pointer" href="/ai/cursor">
    AI-powered code editor.
  </Card>

  <Card title="Windsurf" icon="water" href="/ai/windsurf">
    Editor with Cascade AI.
  </Card>

  <Card title="VS Code" icon="code" href="/ai/vs-code">
    Native MCP support in Copilot Chat.
  </Card>

  <Card title="GitHub Copilot" icon="github" href="/ai/github-copilot">
    Copilot agent mode.
  </Card>

  <Card title="Gemini CLI" icon="terminal" href="/ai/gemini-cli">
    CLI assistant by Google.
  </Card>

  <Card title="OpenCode" icon="terminal" href="/ai/opencode">
    Open-source CLI assistant.
  </Card>

  <Card title="Codex" icon="terminal" href="/ai/codex">
    CLI agent by OpenAI.
  </Card>

  <Card title="Antigravity" icon="terminal" href="/ai/antigravity">
    AI agent by Google.
  </Card>
</Columns>