Cursor

The stdio bridge is the most portable Cursor configuration and works without a separate OAuth flow.

Prerequisites

Node.js 20 or later;
a SocQ API key;
a current Cursor release with MCP support.

Configure

Open Cursor’s MCP settings, add a local server, and use:

{
  "mcpServers": {
    "socq": {
      "command": "npx",
      "args": ["-y", "@socq/mcp"],
      "env": {
        "SOCQ_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

This local configuration contains a credential. Do not commit or share it.

If your Cursor version supports authenticated Streamable HTTP with environment-backed bearer tokens, it can connect to https://api.socq.ai/mcp directly. Keep the stdio configuration when remote authentication is unavailable.

Limit the tool list

To expose typed YouTube tools, change the server name and arguments:

{
  "mcpServers": {
    "socq-youtube": {
      "command": "npx",
      "args": ["-y", "@socq/mcp", "--platforms", "youtube"],
      "env": {
        "SOCQ_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

See Choose MCP tools for mode selection and filtering limits.

Verify

Restart the SocQ MCP server in Cursor, then ask:

Use SocQ to check my account, then collect the latest 20 comments from this
YouTube video. Wait for the task to finish and return the results as a table:
https://www.youtube.com/watch?v=VIDEO_ID

The connection is working when Cursor discovers the SocQ tools, calls socq_account, submits the collection, and reads the returned task with socq_get_task.

Troubleshoot

Restart the server after configuration changes so Cursor refreshes the tool list. See Troubleshooting integrations for authentication, missing-tool, and task errors.

Get started

Clients

Cursor

Cursor

Prerequisites

Configure

Limit the tool list

Verify

Troubleshoot

​Cursor

​Prerequisites

​Configure

​Limit the tool list

​Verify

​Troubleshoot

Cursor

Prerequisites

Configure

Limit the tool list

Verify

Troubleshoot