How do you connect any MCP agent to PlatPost?

What can the agent do in PlatPost?

MCP is the open standard that lets an AI agent use a tool. Any agent or script that speaks MCP over Streamable HTTP can use PlatPost, including the Claude API MCP connector and the OpenAI Responses API mcp tool.

PlatPost gives it a small set of tools through MCP, and each tool does one job.

• Read your Business Brain: what you sell, who your customer is, your voice and your goal.
• List your connected channels, so it knows where you post.
• Read your recent posts with their status, text, schedule and live link, so it can match how you write.
• Write a post as a draft. You review it in PlatPost as you would your own.
• Upload an image, a GIF, a video or music that it made with its own tools. The file appears in the composer under From your agent.
• Send you a message in the agent chat on every page, and read your replies.
• With the schedule right on, schedule a post for a time up to one year ahead. With the publish right on, post at once.

How do I connect Any other MCP client, or your own script to PlatPost?

Streamable HTTP. The Claude API (MCP connector) and the OpenAI Responses API (mcp tool) both take this address and header. Your script gets the same tools and the same limits as any agent: it acts for you in your own workspace only. It cannot see or change the PlatPost code, database, keys or any other account, and nothing it sends runs as code.

1. Open the Agents page in PlatPost and make a key. Leave schedule and publish off for now.
2. Copy the key. PlatPost shows it once.
3. Put the key in the environment variable PLATPOST_KEY on your computer. On Windows PowerShell, the variable is $env:PLATPOST_KEY.
4. Add the setup below in the place this section names.
5. Ask the agent: "Read my PlatPost Business Brain and draft three posts about this week."

URL:    https://platpost.com/api/mcp
Header: Authorization: Bearer <your key>

Can the agent post without my approval?

Not with a new key. A new key can read and write drafts only, and every draft waits for you in PlatPost.

You can turn on two more rights for one key: schedule posts, and publish posts at once. Each right is a separate choice, because an agent that posts skips your approval. On the Free plan, the agent can read and draft, but it cannot schedule or publish until you choose a plan.

Is it safe to give the agent a PlatPost key?

An agent runs in a loop and does not get tired, so every limit is a number in the code.

• PlatPost stores only a one-way hash of the key. Nobody can read the key back, PlatPost included.
• The agent acts only in your own workspace. It cannot see another account.
• The tools have no file, code, database or shell access, and nothing the agent sends runs as code.
• A workspace takes at most 100 agent drafts and 20 agent posts in 24 hours, so a runaway loop stops at a number.
• You can remove a key on the Agents page at any time. The agent loses access at once.

What should I ask the agent to do?

An agent works best with one clear job. These requests use only the tools above.

• "Call get_business_brain and list_channels, then write three drafts with create_post."
• "Call list_posts with status scheduled and report the empty days next week."

What if the agent cannot connect?

Each line below names a case, and then what to do about it.

• The agent says the key is missing. Set PLATPOST_KEY in the same terminal or app that runs it, then start it again.
• The agent says the key is refused. The key was removed or copied wrong. Make a new key on the Agents page, because an old key cannot be shown again.
• The agent cannot schedule a post. The key has no schedule right, or the workspace is on the Free plan.
• The agent stops making drafts. The workspace reached 100 agent drafts in 24 hours. The count frees up as the day moves on.

Questions people ask

What is MCP?

The Model Context Protocol, an open standard that lets an AI agent use a tool. PlatPost runs a remote MCP server, so any agent that speaks MCP can connect to it.

Can my own script use PlatPost without an AI agent?

Yes. Any MCP client can call the PlatPost tools with your key. It gets the same tools and the same limits as an agent, in your own workspace only.

Does the agent need a paid PlatPost plan?

Not to read and draft. The agent can read your Business Brain and write drafts on any plan. Scheduling and publishing need a paid plan.

Does the agent write in my voice?

The agent can read your Business Brain and your recent posts before it writes, so its drafts can follow your voice. You still edit and approve every draft.

Can the agent see my passwords or my other accounts?

No. A key reaches only your own workspace, and the tools have no file, code, database or shell access.

How do I stop the agent?

Remove its key on the Agents page. The agent loses access at once, and the drafts it already wrote stay in PlatPost.

Does a post on X from the agent cost the same as my own?

Yes. A post on X that the agent schedules or publishes takes the same X price from your wallet as a post you make yourself.