Log inStart free

Add Postmaxx to your agent

Give your agent a Postmaxx key once. It connects itself, then you ask it to post.

  1. Create an API key in Postmaxx under Integrations › Your agent.
  2. Copy this, put your key in place of pmx_…, and paste it into your agent. It adds Postmaxx itself.
  3. Ask it: “Draft a post for all my accounts and show me before you schedule it.”
Paste into your agent
Add Postmaxx, my social media scheduler, to your MCP servers.
Name: postmaxx
URL: https://postmaxx.io/mcp (streamable HTTP)
Header: Authorization: Bearer pmx_…
Use your own way to add a remote MCP server, then list my Postmaxx accounts to check that it works.

Your agent never sees your passwords, and you can revoke its key at any time.

See every tool and the REST API

What your agent can do

Eight tools over MCP, with the same checks and plan limits as the app.

  • See your accounts

    Every connected account with its platform, brand and limits, and whether it needs reconnecting.

    list_accounts

  • Save a draft

    One post for one or more accounts, with its own text or media on any platform. Anything to fix comes back with it.

    create_post

  • Change a post

    New text, accounts or media for a post that hasn’t gone out, without making a second one.

    update_post

  • Schedule it

    At a time in your time zone, at the next free time in your queue, or right away when you ask for that.

    schedule_post

  • Check results

    Drafts and scheduled, posted or failed posts, with each account’s link or the reason it failed.

    list_posts

  • Delete a post

    Removes a draft or a scheduled post. Anything already posted stays on the platforms.

    delete_post

  • Add pictures and videos

    From a public link, or as a file of up to 5 MB, ready to attach to a post.

    upload_media

  • Read analytics

    What went out and what failed in the last 7, 30 or 90 days, for one brand or all of them. Creator and Pro add likes, reposts and replies from Bluesky, Mastodon, Instagram, TikTok and YouTube.

    get_analytics

Keys and safety

Your agent gets a Postmaxx key, never your passwords. You can see what it did and take the key away at any time.

  • Owners and admins create keys in Integrations › Your agent. A key is shown once, when it’s made.
  • Each key works for one workspace and shows when it was last used.
  • Revoke a key and it stops working at once.
  • Your agent’s posts stay drafts until they’re scheduled. None goes out right away unless your agent asks for that.
  • Settings › Activity lists what each key did, under the key’s name.
  • A key pasted into a post’s text is revoked at once, and that post can’t be scheduled.

The REST API

The same rules as the app, under /api/v1, with the same key. Every route is in the OpenAPI file.

  • Send an Idempotency-Key and a retry never makes a second post.
  • Each account’s result comes back with its link, or the reason it failed.
  • Errors come back as JSON, with a code, a plain message and a request ID.
OpenAPI file
List accounts, import a picture, queue a post
KEY=pmx_…
HOST=https://postmaxx.io

curl -s $HOST/api/v1/accounts \
  -H "Authorization: Bearer $KEY"

curl -s -X POST $HOST/api/v1/media/import \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: import-launch-1" \
  -d '{"url":"https://example.com/launch.jpg","altText":"Launch day"}'

curl -s -X POST $HOST/api/v1/posts \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: launch-post-1" \
  -d '{"text":"We launched.","mediaIds":["med_…"],
       "targets":[{"accountId":"acc_…"}],"schedule":{"mode":"queue"}}'

Questions

Something else? Write to us.

Which AI agents can I connect?

Claude Code, Codex (ChatGPT’s agent), Cursor, Hermes Agent, Grok Build and Gemini CLI, or any MCP client that can send an API key. Anything that can call a web API works too. The ChatGPT and Claude chat apps don’t work yet, because they connect through a sign-in that Postmaxx doesn’t offer.

Should my agent use MCP or the REST API?

MCP, if your agent supports it: it gets eight tools it calls by name, with notes on when to use each. The REST API is for your own code and scripts, and every route is in the OpenAPI file. Both take the same key and follow the same rules.

Can I check posts before they go out?

Yes. Ask your agent for drafts, and nothing goes out until you or your agent schedules them. Until its time, you can change any post in the calendar, move it or delete it.

Can my agent connect accounts on its own?

No. The owner or an admin connects accounts in Postmaxx. Your agent sees a new account in its list as soon as it’s connected.

Do the API and MCP cost extra?

No. API keys, the REST API and the MCP server come with every plan, from $29 a month after the free 7-day trial.