Claude Code Integration

Schedule social media posts from Claude Code

One command adds the PostQuickAI MCP server to Claude Code. Claude Code then has 40+ social media tools and 6 ready-made skills, so you can schedule posts, generate content and pull analytics from your terminal.

You need Claude Code 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

The easiest way is one CLI command:

claude mcp add postquickai \
  -e POSTQUICKAI_API_KEY=pq_live_your_key_here \
  -- npx -y @postquickai/mcp

The -- separator matters. Everything after it is the command and its arguments. Without it, Claude Code treats the whole string as the binary name and fails to connect.

Verify:

claude mcp list

You should see postquickai: ... ✓ Connected. If it says "Failed to connect", see Troubleshooting below.

Prefer to edit JSON directly?

Claude Code stores MCP configs in ~/.claude.json under a per-project mcpServers key. Add:

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

2. Install the Skills marketplace

Inside Claude Code:

/plugin marketplace add kodenark/postquickai-agent-skills
/plugin install weekly-content-batch

You can install any of the 6 skills. See /agent-skills for the catalog.

3. Restart Claude Code

Quit Claude Code fully and open it again. MCP servers load only on a full restart, so reloading the window is not enough.

4. Ask Claude Code to do things

Try these in a fresh conversation:

"List my PostQuickAI content groups"
"Plan my content for this week across my main brand"
"Schedule a post for Acme tomorrow at 9am about home workouts to Instagram and LinkedIn"
"Pull last month's analytics for my main brand and give me the top 3 posts by engagement"
"Create a 5-tweet thread explaining why founders hire too fast, post to twitter_x and threads"

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

Run: claude mcp add postquickai -e POSTQUICKAI_API_KEY=pq_live_your_key -- npx -y @postquickai/mcp. Keep the `--` separator: everything after it is the command and its arguments. Then restart Claude Code and verify with `claude mcp list`.

Claude Code persists MCP configs in ~/.claude.json under the per-project `mcpServers` key. You can edit it directly as JSON, or use the `claude mcp add` CLI (recommended).

Inside Claude Code, run /plugin marketplace add kodenark/postquickai-agent-skills, then /plugin install <skill-name>. Skills available: schedule-post, weekly-content-batch, analyze-post-performance, onboard-brand, reply-thread, daily-digest.

Yes. Claude Code loads MCP servers at startup, so exit it fully and open it again. Closing the window is not enough.

Run `claude mcp list` and check that postquickai shows as Connected. Or run /mcp inside Claude Code. If it shows "Failed to connect", check that `command` is `npx` (not the whole string) and your API key is set.

Yes. Each developer installs their own MCP config with their own PostQuickAI API key. The Skills marketplace is a shared GitHub repo so everyone on the team uses the same workflows.

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.

Claude Code 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.

Automate social media from your terminal

Start a plan to get your API key, then run the setup command above.

Start free trial