Connect an AI agent (MCP)

https://postninja.app/api/mcp

{
  "mcpServers": {
    "postninja": {
      "command": "npx",
      "args": ["mcp-remote", "https://postninja.app/api/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer pn_YOUR_KEY" }
    }
  }
}

https://postninja.app/api/mcp

claude mcp add --transport http postninja https://postninja.app/api/mcp \
  --header "Authorization: Bearer pn_YOUR_KEY"

{
  "mcpServers": {
    "postninja": {
      "type": "http",
      "url": "https://postninja.app/api/mcp",
      "headers": { "Authorization": "Bearer ${POSTNINJA_API_KEY}" }
    }
  }
}

{
  "mcpServers": {
    "postninja": {
      "url": "https://postninja.app/api/mcp",
      "headers": { "Authorization": "Bearer ${env:POSTNINJA_API_KEY}" }
    }
  }
}

export POSTNINJA_API_KEY=pn_YOUR_KEY
codex mcp add postninja --url https://postninja.app/api/mcp --bearer-token-env-var POSTNINJA_API_KEY

[mcp_servers.postninja]
url = "https://postninja.app/api/mcp"
bearer_token_env_var = "POSTNINJA_API_KEY"

{
  "inputs": [
    { "type": "promptString", "id": "postninja-key", "description": "PostNinja API key (pn_…)", "password": true }
  ],
  "servers": {
    "postninja": {
      "type": "http",
      "url": "https://postninja.app/api/mcp",
      "headers": { "Authorization": "Bearer ${input:postninja-key}" }
    }
  }
}

{
  "mcpServers": {
    "postninja": {
      "serverUrl": "https://postninja.app/api/mcp",
      "headers": { "Authorization": "Bearer ${env:POSTNINJA_API_KEY}" }
    }
  }
}

https://postninja.app/api/mcp

curl "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "agent": "antigravity-preview-09-2026",
    "environment": "remote",
    "input": "Schedule a post about our launch for tomorrow 9am on X and Threads",
    "tools": [{
      "type": "mcp_server",
      "name": "postninja",
      "url": "https://postninja.app/api/mcp",
      "headers": { "Authorization": "Bearer pn_YOUR_KEY" }
    }]
  }'

import asyncio, os
from google import genai
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

client = genai.Client()

async def main():
    headers = {"Authorization": f"Bearer {os.environ['POSTNINJA_API_KEY']}"}
    async with streamablehttp_client("https://postninja.app/api/mcp", headers=headers) as (read, write, _):
        async with ClientSession(read, write) as session:
            await session.initialize()
            response = await client.aio.models.generate_content(
                model="gemini-flash-latest",
                contents="Schedule a post about our launch for tomorrow 9am on X",
                config=genai.types.GenerateContentConfig(tools=[session]),
            )
            print(response.text)

asyncio.run(main())

gemini mcp add --transport http --header "Authorization: Bearer pn_YOUR_KEY" postninja https://postninja.app/api/mcp

{
  "mcpServers": {
    "postninja": {
      "httpUrl": "https://postninja.app/api/mcp",
      "headers": { "Authorization": "Bearer pn_YOUR_KEY" }
    }
  }
}

https://postninja.app/api/mcp

Name:     postninja
URL:      https://postninja.app/api/mcp
Header:   Authorization: Bearer pn_YOUR_KEY

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "input": "List my scheduled posts for this week",
    "tools": [{
      "type": "mcp",
      "server_url": "https://postninja.app/api/mcp",
      "server_label": "postninja",
      "authorization": "pn_YOUR_KEY"
    }]
  }'

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=YOUR_DEEPSEEK_KEY
export ANTHROPIC_MODEL=deepseek-flash

claude mcp add --transport http postninja https://postninja.app/api/mcp \
  --header "Authorization: Bearer pn_YOUR_KEY"

openclaw mcp set postninja '{"url":"https://postninja.app/api/mcp","transport":"streamable-http","headers":{"Authorization":"Bearer pn_YOUR_KEY"}}'
openclaw mcp probe postninja

{
  "mcp": {
    "servers": {
      "postninja": {
        "url": "https://postninja.app/api/mcp",
        "transport": "streamable-http",
        "headers": { "Authorization": "Bearer pn_YOUR_KEY" }
      }
    }
  }
}

{
  "mcpServers": {
    "postninja": {
      "type": "streamableHttp",
      "url": "https://postninja.app/api/mcp",
      "headers": { "Authorization": "Bearer pn_YOUR_KEY" },
      "disabled": false
    }
  }
}

{
  "context_servers": {
    "postninja": {
      "url": "https://postninja.app/api/mcp",
      "headers": { "Authorization": "Bearer pn_YOUR_KEY" }
    }
  }
}

Endpoint:          https://postninja.app/api/mcp
Server Transport:  HTTP Streamable
Authentication:    Bearer Auth
  Token:           pn_YOUR_KEY
Tools to Include:  All

import os
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async with MCPServerStreamableHttp(
    name="PostNinja",
    params={
        "url": "https://postninja.app/api/mcp",
        "headers": {"Authorization": f"Bearer {os.environ['POSTNINJA_API_KEY']}"},
    },
    cache_tools_list=True,
) as postninja:
    agent = Agent(name="Social", instructions="You schedule social posts.", mcp_servers=[postninja])
    result = await Runner.run(agent, "Schedule a post about our launch for tomorrow 9am on X.")

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);
}

extensions:
  postninja:
    type: streamable_http
    name: postninja
    enabled: true
    uri: https://postninja.app/api/mcp
    headers:
      Authorization: "Bearer pn_YOUR_KEY"
    timeout: 300

Endpoint:   https://postninja.app/api/mcp
Transport:  Streamable HTTP (stateless)
Auth:       OAuth 2.1 sign-in, or Authorization: Bearer pn_YOUR_KEY

{
  "mcpServers": {
    "postninja": {
      "type": "http",
      "url": "https://postninja.app/api/mcp",
      "headers": { "Authorization": "Bearer pn_YOUR_KEY" }
    }
  }
}

PostNinja schedules posts to X, Instagram, Threads, Facebook Pages, TikTok, YouTube Shorts and Pinterest. Call list_accounts first to get account ids. Instagram, TikTok, YouTube and Pinterest posts need media (upload_image); YouTube needs exactly one video. Use platformContent to give a platform its own text, e.g. a shorter version for X (280 characters) or hashtags for Instagram. For an X thread, put the follow-up posts in xThread (each costs credits). For an Instagram Story, set instagramFormat to "story" and attach exactly one photo or video. For TikTok, ask the user who can see the post (tiktok.privacy) and whether it's commercial content (tiktok.yourBrand / tiktok.brandedContent). Times are ISO 8601 with a time zone. get_workspace gives the brand voice to write in and whether members' posts need approval; accounts may belong to profiles (list_profiles, e.g. one per client or brand), each with its own brand voice, which wins for that profile's accounts. Posts with status awaiting_approval wait for an owner or admin: approve_post schedules them, request_changes sends them back to the author with a note. list_templates has ready-made posts with {blanks} you can fill in before create_post. Set queue: true on create_post to use the next free slot of the posting queue (get_queue shows the weekly slots) instead of a time. firstComment adds a first comment under the post; youtubeTitle sets a YouTube video's title. get_analytics reports impressions, engagements, follower growth and top posts for a date range; list_comments and reply_to_comment read and answer comments on Instagram, Facebook, Threads and YouTube posts; list_messages and reply_to_message read and answer Instagram and Facebook Page direct messages (replies only within 24 hours of the person's last message).