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

# Cursor

> Connect SocialAPI.AI to Cursor via config file or Settings UI.

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

## Prerequisites

* [Cursor](https://cursor.com) installed
* A [SocialAPI.AI](https://social-api.ai) account with at least one connected social account

## Config file

Add to your project config (`.cursor/mcp.json`) or global config (`~/.cursor/mcp.json`):

```json theme={null}
{
  "mcpServers": {
    "SocialAPI": {
      "url": "https://api.social-api.ai/mcp"
    }
  }
}
```

No tokens or credentials are needed in the config - Cursor handles OAuth automatically.

When you first use a [SocialAPI.AI](https://social-api.ai) tool, Cursor discovers the OAuth metadata, opens your browser for authorization, and exchanges the code using PKCE. The token is stored and refreshed automatically.

<Note>
  Cursor supports both **SSE** and **Streamable HTTP** transports for remote servers. OAuth with Dynamic Client Registration and PKCE is handled automatically.
</Note>

## Settings UI

1. Open **Cursor Settings** (gear icon)
2. Go to **Tools & Integrations** in the left sidebar
3. Under **MCP Tools**, click **Add Custom MCP**
4. Enter the URL: `https://api.social-api.ai/mcp`
5. Click the **Needs login** button to start the OAuth flow
6. Authorize in the browser window that opens

<img src="https://mintlify.s3.us-west-1.amazonaws.com/socialapi/images/mcp-cursor-settings.png" alt="Cursor MCP Tools settings" />

## Using in chat

Open **Agent** mode in Cursor. [SocialAPI.AI](https://social-api.ai) tools appear under **Available Tools** and are invoked automatically when relevant. You can also mention a tool by name in your prompt.

## Debugging

If the connection fails, open the **Output** panel (`Cmd+Shift+U` / `Ctrl+Shift+U`) and select **MCP Logs** from the dropdown.