Developers

Build agents and integrations on PostNow

An MCP server for AI agents, a versioned REST API for traditional integrations, and webhooks for everything else.

MCP server

First-class tools for AI agents

npx @postnow/mcp-server --api-key $POSTNOW_KEY

Install via npm and run. The MCP server auto-discovers tools and connects to your workspace.

PostNow exposes a native Model Context Protocol server. Plug it into Claude, GPT, or any MCP-compatible agent and your AI can draft, schedule, and analyze — with the same voice profile your team uses.

Self-host the reference server or use our hosted endpoint
Stream tools over stdio, SSE, or WebSocket
Open spec, MIT-licensed reference implementation

mcp-client.ts

// Install: npm install @postnow/mcp
import { PostNowMCP } from "@postnow/mcp";

const client = new PostNowMCP({ apiKey: process.env.POSTNOW_KEY });

const drafts = await client.listDrafts({ status: "ready" });
console.log(drafts);

Available tools

list_drafts

List drafts in a workspace, optionally filtered by status or author.

create_draft

Create a new draft with voice-aware suggestions returned in the same call.

update_draft

Edit an existing draft body, schedule, or metadata.

schedule_post

Schedule a published post at a specific time or using best-time suggestions.

fetch_analytics

Pull post performance, audience insights, and Content DNA evolution.

submit_for_approval

Push a draft into an approval workflow, optionally tagging reviewers.

curl — schedule a post

POST https://api.postnow.io/v1/posts
Authorization: Bearer <token>
Content-Type: application/json

{
  "workspace_id": "ws_123",
  "body": "Shipped something today...",
  "schedule_at": "2026-09-04T14:30:00Z",
  "voice_profile_id": "dna_abc"
}

REST API

Versioned, predictable, documented

A REST API with predictable resource names, idempotent writes, cursor pagination, and SDKs for TypeScript, Python, and Go.

OAuth 2.0 with refresh tokens for end-user integrations
API keys with scoped permissions for server integrations
Per-workspace rate limits and a single /v1 versioning policy

Webhooks

Subscribe to what matters

Fire events into your own systems when something happens. Verifiable signatures, automatic retries with exponential backoff, and a delivery dashboard.

post.published

post.failed

draft.submitted

approval.requested

approval.completed

analytics.weekly_ready

workspace.member_added

Authentication

Three ways to authenticate, depending on your use case:

Personal access tokens

For scripts and personal integrations. Scoped to your account.

OAuth apps

Build integrations that members authorize. Refresh tokens, per-installation scopes.

Workspace keys

Server-to-server. Long-lived, scoped to one workspace.

Ready to build?

Get an API key, read the docs, and ship your first integration.

Create an account Talk to the API team

First-class tools for AI agents

npx @postnow/mcp-server --api-key $POSTNOW_KEY

Install via npm and run. The MCP server auto-discovers tools and connects to your workspace.

Self-host the reference server or use our hosted endpoint

Stream tools over stdio, SSE, or WebSocket

Open spec, MIT-licensed reference implementation

// Install: npm install @postnow/mcp import { PostNowMCP } from "@postnow/mcp"; const client = new PostNowMCP({ apiKey: process.env.POSTNOW_KEY }); const drafts = await client.listDrafts({ status: "ready" }); console.log(drafts);

POST https://api.postnow.io/v1/posts Authorization: Bearer <token> Content-Type: application/json { "workspace_id": "ws_123", "body": "Shipped something today...", "schedule_at": "2026-09-04T14:30:00Z", "voice_profile_id": "dna_abc" }