Cursor Integration

Schedule social media posts from Cursor

Install PostQuickAI's MCP server in Cursor and your IDE's agent gets 40+ social media tools — create posts, generate AI images, schedule threads, pull analytics — without ever leaving your editor.

Requires Cursor and the PostQuickAI API add-on. paid plans available.

1. Install the MCP server

Two options — UI or config file.

Option A: Cursor Settings UI

  1. Open Settings: Cmd + , (macOS) or Ctrl + , (Windows)
  2. Navigate to Features → MCP
  3. Click + Add New MCP Server
  4. Paste the JSON block below and save

Option B: Config file

Project-specific (recommended for teams — commit to repo):

# .cursor/mcp.json (at your project root)

Or user-global:

# ~/.cursor/mcp.json  (macOS/Linux)
# %USERPROFILE%\.cursor\mcp.json  (Windows)

The config

{
  "mcpServers": {
    "postquickai": {
      "command": "npx",
      "args": ["-y", "@postquickai/mcp"],
      "env": {
        "POSTQUICKAI_API_KEY": "pq_live_your_key_here"
      }
    }
  }
}

⚠️ Fully quit and reopen Cursor after saving — MCP servers only load at startup. A window reload isn't enough.

2. Add the Skills bundle (optional, recommended)

Skills wrap MCP tools in opinionated workflows. Clone into your project and Cursor auto-discovers them:

git clone https://github.com/kodenark/postquickai-agent-skills .agents/

Full catalog: postquick.ai/agent-skills.

3. Drop AGENTS.md in your project (optional)

Cursor reads AGENTS.md alongside .cursorrules. Paste our snippet from /agents-md for project-aware behavior (Cursor will know when to call the MCP tools vs. when not to).

4. Try it in Cursor's agent

Ask Cursor in Ask mode or Composer:

"List my PostQuickAI content groups"
"Schedule a post for my Acme brand tomorrow at 9am about home workouts — Instagram and LinkedIn"
"Plan 7 posts for this week for our Pro content group, grounded in our brand voice"
"Pull last 30 days of analytics and show me top performers by engagement"
"Create a 5-tweet thread about our Series A announcement, schedule for 10am ET tomorrow"

API + Agent access

MCP server, Skills, and REST API ship together as a separate paid API add-on — never bundled with Basic or Pro. Stack it on top of any subscription.

FAQ

Frequently Asked Questions

Global: ~/.cursor/mcp.json (macOS/Linux) or %USERPROFILE%\.cursor\mcp.json (Windows). Project-scoped: .cursor/mcp.json in your project root — commit this so your team shares the same MCP setup (without secrets).

Open Settings (Cmd+, on macOS, Ctrl+, on Windows), navigate to Features → MCP, click "+ Add New MCP Server", and paste the JSON block below.

Yes. MCP servers only load at startup. Fully quit and reopen Cursor — don't just reload the window.

Yes. Clone postquickai/agent-skills into your project (or into a .agents/ folder) and Cursor discovers the SKILL.md files automatically. The AGENTS.md snippet at /agents-md also works — Cursor reads it alongside .cursorrules.

Yes. Commit .cursor/mcp.json to your repo without secrets — use environment-variable expansion. Each teammate sets their own POSTQUICKAI_API_KEY locally.

Both. Cursor's agent exposes MCP tools to both Ask (for one-shot questions like "how many posts are scheduled?") and Composer (for multi-step agent tasks like "plan and schedule my week of content").

Troubleshooting

"Failed to connect to postquickai"

Almost always a config format issue. Make sure command is just npx and args is an array — never put the whole command in one string. Also fully quit and restart your agent after editing config.

"API add-on required" / 403 errors

MCP and REST API access both require the API add-on on your plan. Enable it at postquick.ai/pricing.

"Missing POSTQUICKAI_API_KEY"

Generate a key at postquick.ai/dashboard/api. Keys start with pq_live_. Put it in the env block of your MCP config.

Rate limit exceeded

Basic plan: 30 req/min, 5k/day. Pro plan: 120 req/min, 50k/day. See rate limits in the API docs.

Cursor-specific issues

Still stuck? See the developer docs or email konark@arktechllc.net.

Also works with

PostQuickAI is agent-native — same API, same MCP server, same skills bundle across every major AI coding agent.

Ready to automate your social from Cursor?

Get paid plans API key, paste the MCP config, restart Cursor. 5 minutes start to finish.

View Plans