Any MCP client + PostNinja

A Social Media MCP Server for Any AI Agent

PostNinja runs a remote MCP server that gives any MCP-compatible agent seven tools for social media: list accounts, create, change and delete posts, check results and upload images. One connection covers eight platforms.

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

Get started How to connect

Setup

How do I connect PostNinja to Any MCP client?

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
Add PostNinja to Any MCP client
Point your client at the endpoint below. Apps that sign in with OAuth only need the URL; everything else sends an API key as a Bearer token:
Connection details
```
Endpoint:   https://postninja.app/api/mcp
Transport:  Streamable HTTP (stateless)
Auth:       OAuth 2.1 sign-in, or Authorization: Bearer pn_YOUR_KEY
```
Typical JSON config
```
{
  "mcpServers": {
    "postninja": {
      "type": "http",
      "url": "https://postninja.app/api/mcp",
      "headers": { "Authorization": "Bearer pn_YOUR_KEY" }
    }
  }
}
```
Replace pn_YOUR_KEY with a key from Settings → API.
Apps that sign in (ChatGPT, Claude.ai, the Gemini and Grok apps) use OAuth 2.1 instead of a key: discovery starts at /.well-known/oauth-protected-resource, with dynamic client registration, client ID metadata documents and PKCE.
3
Just ask
Any MCP client finds the PostNinja tools on its own. Try:
- “Schedule a post to all my accounts for tomorrow at 9am.”
- “Turn this announcement into an X thread.”
- “Post this photo as an Instagram Story tonight at 7pm.”

Tools

What can Any MCP client 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 Any MCP client can post to any of them, and PostNinja publishes at the time you set.

FAQ

Any MCP client and PostNinja questions

Which tools does the server expose?

list_accounts, list_posts, get_post, create_post, update_post, delete_post and upload_image. create_post handles per-platform text, X threads and Instagram Stories.

Is there a REST API too?

Yes. The same operations are available at /api/v1 with the same API keys. See the API docs.

Does Any MCP client post without asking me?

That depends on Any MCP client'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 Any MCP client 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 Any MCP client run your social media.

Connect Any MCP client to PostNinja in a couple of minutes. Plans from $15 a month.

Choose your plan Log in