How to Connect SocialPilot With Cursor Using MCP Server?

SocialPilot MCP Server lets you use Cursor to run SocialPilot workflows through prompts.

Instead of stopping at content creation, you can use Cursor to create posts, schedule content, manage drafts, review publishing status, and handle repetitive execution tasks across your SocialPilot accounts.

This is useful for agencies, social media managers, and teams managing multiple brands or high-volume publishing workflows.

In This Article:


Requirements

Make sure you have:

  • Cursor installed and signed in.
  • Access to your SocialPilot account.
  • Your SocialPilot API key.
  • Internet access to connect with the SocialPilot MCP Server.

You can get your API key in SocialPilot by:

  1. Log in to your SocialPilot account.
  2. Click your profile icon in the top-right corner.
  3. Go to Security.

  4. Scroll to the API Key section.

  5. Copy your API key.

Use the MCP Server URL format below during setup:

https://mcp.socialpilot.co/YOUR_API_KEY/mcp    

Replace YOUR_API_KEY     with your actual API key.


How to Set Up SocialPilot MCP in Cursor Using API Key?

  1. Open Cursor and navigate to Settings.

  2. Then go to Tools & MCPs and click Add Custom MCP.

  3. Cursor will open the mcp_config.json     file.

  4. Paste the following code:
{
  "mcpServers": {
    "socialpilot": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.socialpilot.co/YOUR_API_KEY/mcp"
      ]
    }
  }
}
  1. Replace YOUR_API_KEY     with your SocialPilot API key.
  2. Save the mcp_config.json     file.

  3. Return to Cursor.
  4. You should now see SocialPilot listed under MCP tools.

Once connected, your SocialPilot account becomes available inside Cursor for execution.


How to Use SocialPilot in Cursor?

You can now use prompts in Cursor to run SocialPilot workflows.

Example Prompts

Creating and Publishing:

  • Schedule this launch post to all LinkedIn accounts tomorrow at 10 AM.
  • Publish this weekend offer to Instagram and Facebook today at 6 PM.
  • Create and schedule a campaign post for Group X next Monday morning.

Drafting and Reviewing

  • Save this post as a draft for Client A.
  • Show drafts waiting for review.
  • Update the latest draft with a shorter caption.

Monitoring and Troubleshooting

  • What posts are scheduled today?
  • Show posts that failed in the last 7 days.
  • Which posts missed their scheduled time this week?

Troubleshooting


SocialPilot Is Not Showing in Cursor

Check that the mcp.json  file is saved correctly and the JSON syntax is valid.

Then return to Tools & Integrations and check the MCP tools section again. If it still does not appear, restart Cursor.


Invalid API Key

Make sure your API key is active and entered correctly in the MCP Server URL.

Use this format:

https://mcp.socialpilot.co/YOUR_API_KEY/mcp

You can copy your API key from the Security section in your SocialPilot account.


Cursor Cannot Reach the MCP Server

Verify that the MCP URL is correct and your internet connection is active.

Also make sure firewall, VPN, or network restrictions are not blocking the connection.


Tools Are Connected but Not Working

Refresh the MCP tools list or restart Cursor after saving the config file.

Some MCP tools may require Cursor to reload the configuration before they become available.


Invalid JSON Error

Check for:

  • missing commas
  • extra brackets
  • duplicate quotation marks
  • broken formatting inside mcp.json

Cursor requires valid JSON before loading MCP servers.


Notes:

  • SocialPilot remains connected until the configuration is removed, changed, or requires reconnection.
  • All actions follow your existing SocialPilot account permissions.
  • Access is limited to the accounts and data already available in your SocialPilot workspace.
  • If you regenerate your API key, update the Cursor configuration using the new key.
  • Keep your API key private and do not share your mcp.json  file publicly.
  • Restarting Cursor may help apply recent configuration changes.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us