PostNinja
Get started

Claude Agent SDK + PostNinja

Add Social Media Posting to Agents Built with the Claude Agent SDK

Give your Claude-powered agent a social media team. Add PostNinja as an HTTP MCP server and allow its tools, and the agent can plan, write and schedule posts on every platform you've connected.

  • Connect once with an API key
  • Draft, schedule and publish by asking
  • 7 platforms: X, Instagram, TikTok, Facebook and more
Get startedHow to connect

Setup

How do I connect PostNinja to Claude Agent SDK?

  1. 1

    Create an API key

    In PostNinja, go to Settings → API and create a key. It starts with pn_ and is shown once, so copy it somewhere safe.

  2. 2

    Add PostNinja to Claude Agent SDK

    Add the server to your query options and allow its tools:

    TypeScript
    import { query } from "@anthropic-ai/claude-agent-sdk";

for await (const message of query({
  prompt: "Schedule tomorrow's launch post on X and Threads at 9am",
  options: {
    mcpServers: {
      postninja: {
        type: "http",
        url: "https://postninja.app/api/mcp",
        headers: { Authorization: `Bearer ${process.env.POSTNINJA_API_KEY}` },
      },
    },
    allowedTools: ["mcp__postninja__*"],
  },
})) {
  if (message.type === "result") console.log(message.result);
}

    Without allowedTools: ["mcp__postninja__*"], the agent sees the tools but isn't allowed to call them.

  3. 3

    Just ask

    Claude Agent SDK finds the PostNinja tools on its own. Try:

    • “Schedule tomorrow's launch post on X and Threads at 9am.”
    • “Write a week of daily tips and save them as drafts.”
    • “What did we post last week, and where did it fail?”

Tools

What can Claude Agent SDK do with PostNinja?

Write and schedule

Drafts posts, gives each platform its own text, and schedules them for any date and time.

Threads and Stories

Builds multi-post X threads and posts photos or videos as Instagram Stories.

Check what's planned

Lists upcoming posts, drafts and what went out, with links to the live posts.

Fix and reschedule

Moves, edits or deletes drafts and scheduled posts when plans change.

Add images

Uploads images to attach to posts. Larger files and video go through the REST API.

Spot failures

Reads each account's status and error, so it can tell you what didn't go out and why.

One connection, seven platforms

Connect your accounts in PostNinja once. From then on Claude Agent SDK can post to any of them, and PostNinja publishes at the time you set.

FAQ

Claude Agent SDK and PostNinja questions

Can I limit what the agent may do?

Yes. Allow only the tools you want, e.g. ["mcp__postninja__list_accounts", "mcp__postninja__create_post"], or have it save drafts for a human to schedule.

Does Claude Agent SDK post without asking me?

That depends on Claude Agent SDK's own settings; most ask before each tool call. If you'd rather review everything, ask it to save posts as drafts, then schedule them from the PostNinja calendar.

Is my API key safe?

PostNinja only stores a hash of each key and shows its first characters so you can tell keys apart. A key works for one workspace, and you can revoke it any time under Settings → API.

Which platforms can Claude Agent SDK post to?

Every account you've connected: X, Instagram, Threads, Facebook Pages, TikTok, YouTube Shorts and Pinterest.

Do posts scheduled by an AI agent cost extra?

No. They're ordinary posts on your plan. As always, X posts use credits (10 each, 80 with a link) because X charges for every post; other platforms are unlimited.

Works with other AI agents too

Let Claude Agent SDK run your social media.

Connect Claude Agent SDK to PostNinja in a couple of minutes. Plans from $15 a month.

Choose your planLog in