Cursor Integration

Schedule social media posts from Cursor

Add the PostQuickAI MCP server to Cursor and its agent can schedule social media posts for you. It gets 40+ tools for writing posts, generating images, scheduling threads and reading analytics, all from inside your editor.

You need Cursor and a PostQuickAI plan; every plan includes API access. Your first plan has a 7-day free trial, card required.

1. Install the MCP server

Use the Cursor settings screen or edit the config file yourself.

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

Per project (best for teams, since you can commit it to the 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"
      }
    }
  }
}

⚠️ After saving, quit Cursor fully and open it again. Cursor loads MCP servers at startup, so reloading the window is not enough.

2. Add the Skills bundle (optional, recommended)

Skills are written workflows that tell the agent which MCP tools to call, in what order. Clone them into your project and Cursor picks them up:

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 so Cursor knows when a request should go to the PostQuickAI tools.

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, on 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 and agent access

Included in every plan

Every plan includes the REST API, MCP server, Claude Skills, and AGENTS.md integration, at no extra charge.

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 the project file (without secrets) so your team shares the same MCP setup.

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

Yes. Cursor loads MCP servers at startup, so quit Cursor fully and open it again. Reloading the window is not enough.

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

Yes. Commit .cursor/mcp.json to your repo with environment-variable expansion in place of the key. 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

Connection failed

Set command to npx and provide args as an array. Restart the agent after changing its configuration.

Plan required

MCP and REST API access need an active plan. Every plan includes them. View plans.

API key missing

Create a key in API settings. Keys begin with pq_live_ and belong in the MCP configuration environment block.

Rate limit reached

Basic allows 30 requests/minute and 5,000/day. Pro allows 120 requests/minute and 50,000/day. Read the rate-limit reference.

Cursor setup still failing

Check the developer documentation or email konark@arktechllc.net.

Setup guides for other agents

Each guide uses the same PostQuickAI API and MCP server with tool-specific configuration.

Schedule posts from Cursor

Start a plan to get your API key, paste the MCP config into Cursor, then restart it.

Start free trial