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

# MCP

> Point an agent at Connect. Same account as the REST API. OAuth, not API keys. No connect tool.

[MCP](https://modelcontextprotocol.io) is how Cursor, Claude, ChatGPT, and similar clients use your Connect account as tools — posts, media, social accounts, sets, webhooks, logs.

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

The agent signs in with OAuth (`mcp:use`). An API key on this URL returns **403**. Keys are for [REST](/docs/getting-started/authentication) only.

Revoke assistants under [Settings → MCP](https://connect.trypost.it/settings/account/mcp).

## Add a client

<AccordionGroup>
  <Accordion title="Cursor">
    Cursor 1.0+. In the project root, `.cursor/mcp.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "trypost-connect": {
          "url": "https://connect.trypost.it/mcp"
        }
      }
    }
    ```

    Open MCP settings → **Connect** next to **trypost-connect** → approve in the browser. Then: `List my Connect social accounts`.
  </Accordion>

  <Accordion title="Claude Code">
    ```bash theme={null}
    claude mcp add --transport http trypost-connect https://connect.trypost.it/mcp
    ```

    Append `--scope user` to share it across projects. The first tool call opens the Connect sign-in.
  </Accordion>

  <Accordion title="Claude web">
    [Customize → Connectors](https://claude.ai/customize/connectors) → **Add custom connector**. Name `TryPost Connect`, URL `https://connect.trypost.it/mcp`. Leave Client ID / Secret empty. Enable the connector on the chat **+** menu before asking it to post.
  </Accordion>

  <Accordion title="ChatGPT">
    Requires Pro/Plus/Business (or similar) and **Developer mode** on the web. [Create a connector](https://chatgpt.com/plugins#settings/Connectors?create-connector=true\&redirectAfter=%2Fplugins): name `TryPost Connect`, URL `https://connect.trypost.it/mcp`, authentication **OAuth**, no client id/secret. In a new chat, turn on Developer mode and the connector.
  </Accordion>
</AccordionGroup>

## How an agent should work

1. List connected social accounts.
2. Ask for the format catalog (`list-content-types-tool`) — valid types and media caps. REST has no catalog; the [platform pages](/docs/platforms/linkedin) are the other source.
3. For Pinterest or Discord, list boards or channels first.
4. Request an upload slot, put the file, then pass that public URL. External URLs are rejected. There is no attach-from-URL tool and no asset library.
5. Create a draft. Preview if you want.
6. Publish now, or schedule.

Connecting a new network is still a [browser flow](/docs/guides/connect-accounts). The agent cannot start OAuth.

## What the tools cover

| Area          | What the agent can do                                                                                       |
| ------------- | ----------------------------------------------------------------------------------------------------------- |
| Posts         | List, get, create a draft, update a draft, publish, preview, delete, metrics                                |
| Media         | Request an upload slot (same as REST presign)                                                               |
| Accounts      | List, disconnect, assign a set, list Pinterest boards and Discord channels                                  |
| Sets          | Full create / update / delete                                                                               |
| Webhooks      | Same events and HMAC as [Webhooks](/docs/guides/webhooks)                                                        |
| Keys and logs | List and create keys (plain secret once). List activity (90 days). No get-one-log tool — use REST for that. |

Create-post may omit which accounts to target (every connected identity is added, disabled until you enable rows). REST create requires at least one. Update cannot jump straight to “publishing” — that is `publish-post-tool`.

## If it fails

<AccordionGroup>
  <Accordion title="Active subscription required">
    OAuth worked; the account lost app access. Open [connect.trypost.it](https://connect.trypost.it), subscribe, reconnect.
  </Accordion>

  <Accordion title="Unauthenticated">
    The session expired or the token was revoked. Run the client's Connect flow again.
  </Accordion>

  <Accordion title="MCP OAuth authorization required">
    The client sent an API key. Remove any `Authorization` header from the MCP config.
  </Accordion>
</AccordionGroup>