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. Free trial 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 are all included with the API add-on on any paid plan.

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 support@postquick.ai.

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 a free trial API key, paste the MCP config, restart Cursor. 5 minutes start to finish.

Start free trial