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

# Use with AI Assistants

> Connect the social media API for AI agents to Claude, ChatGPT, Mistral, Cursor, VS Code, and other AI tools as an MCP server.

[SocialAPI.AI](https://social-api.ai) is a social media API for AI agents, exposed as an [MCP](https://modelcontextprotocol.io) (Model Context Protocol) server. Once connected, your AI assistant can list accounts, fetch comments, reply, send DMs, publish posts, and more through natural language.

**MCP Server URL:** `https://api.social-api.ai/mcp`

## Authentication

The MCP endpoint accepts two credential types on the `Authorization: Bearer` header:

| Method                  | Best for                                                                             | How to obtain                                                                |
| ----------------------- | ------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------- |
| **OAuth 2.1 with PKCE** | Claude, ChatGPT, Cursor, VS Code, Le Chat, and other MCP clients with built-in OAuth | Handled automatically by the client on first tool use                        |
| **API key**             | Custom MCP clients, headless agents, server-side scripts, CI jobs                    | Create one in the [dashboard](https://app.social-api.ai), prefix `sapi_key_` |

OAuth-capable clients discover the authorization server via `/.well-known/oauth-protected-resource`, so no credentials are needed in their config files. For everything else, see [Custom MCP clients](/integrations/custom).

## Choose your platform

<CardGroup cols={2}>
  <Card title="Claude" icon="message" href="/integrations/claude">
    Web, Desktop, Claude Code, Mobile
  </Card>

  <Card title="ChatGPT" icon="comment" href="/integrations/chatgpt">
    Web, Desktop, Mobile
  </Card>

  <Card title="Mistral / Le Chat" icon="bolt" href="/integrations/mistral">
    Web, Mobile
  </Card>

  <Card title="Cursor" icon="code" href="/integrations/cursor">
    Config file or Settings UI
  </Card>

  <Card title="VS Code + Copilot" icon="terminal" href="/integrations/vscode">
    Config file or Command Palette
  </Card>
</CardGroup>

## Available tools

Your AI assistant has access to **78 tools** covering all [SocialAPI.AI](https://social-api.ai) functionality:

| Category              | What the assistant can do                                                                                                                          |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Accounts**          | List connected accounts, connect new accounts, disconnect, complete OAuth exchange, list account pages, fetch creator info, get per-account limits |
| **Brands**            | List, create, update, delete brands                                                                                                                |
| **Posts**             | List, create, get, update, delete, retry, unpublish posts; fetch metrics; validate; import                                                         |
| **Instagram Stories** | List currently-active Instagram Stories (Instagram only)                                                                                           |
| **Media**             | List, delete media; get upload URLs; upload; verify; check storage usage                                                                           |
| **Comments**          | List commented posts, list comments on a post, list reply threads, reply, hide/unhide, like/unlike, delete, send private reply, moderate           |
| **DMs**               | List conversations, get conversation, list and send messages, mark as read                                                                         |
| **Reviews**           | List reviews, reply to a review, update or delete a review reply                                                                                   |
| **Mentions**          | Fetch mentions for an account                                                                                                                      |
| **Inbox posts**       | List inbox posts                                                                                                                                   |
| **Usage**             | Check workspace usage, per-account limits, storage usage, account constraints, publishing constraints                                              |
| **Keys**              | List, create, revoke API keys                                                                                                                      |
| **Webhooks**          | List, create, get, update, delete webhooks; list deliveries; retry deliveries; test webhooks; list event catalog                                   |
| **Exports**           | Create exports, get an export, list exports, fetch export videos                                                                                   |
| **Events**            | List events, fetch events summary                                                                                                                  |
| **Invites**           | List, create, revoke brand invites                                                                                                                 |
| **Users**             | Get/update profile, delete account                                                                                                                 |
| **Feedback**          | Send feedback to the [SocialAPI.AI](https://social-api.ai) team                                                                                    |

## Troubleshooting

**Authorization fails or loops** - Make sure pop-ups are not blocked in your browser when the OAuth window opens. Some browser extensions (ad blockers, privacy tools) can interfere with the redirect.

**Tool calls fail with 401** - Your OAuth session may have expired. Remove the [SocialAPI.AI](https://social-api.ai) connection and re-add it to trigger a fresh authorization. If you authenticate with an API key, check that the key is still active in the [dashboard](https://app.social-api.ai/settings/keys).

**"MCP server not responding"** - Verify the URL is exactly `https://api.social-api.ai/mcp`. Check [status.social-api.ai](https://status.social-api.ai) for any ongoing incidents.

## Still have questions?

If you have any issues or want to learn more about using [SocialAPI.AI](https://social-api.ai) with AI assistants, reach out to our support team at [support@social-api.ai](mailto:support@social-api.ai).