MCP for Authors

Add the MCP address to your AI client, sign in to Publicasta and choose channels and permissions. An API key is not required.

https://publicasta.com/mcp

Connect an AI Client

Menu names vary by application version. Custom MCP connections may require an eligible plan or administrator permission. These instructions do not mean every workflow has been tested in each client.

Codex CLI

Run this in a terminal with Codex CLI installed:

codex mcp add publicasta --url https://publicasta.com/mcp

Open the returned link and approve access in Publicasta. If sign-in did not start or you need to authenticate again, run the command below. Then start a new Codex session; /mcp lists connected servers.

codex mcp login publicasta

Client developer instructions

ChatGPT Desktop / Codex

In the app settings, open Settings > MCP servers > Add server. Name it publicasta, choose Streamable HTTP and paste the MCP address above.

Save the server, select Authenticate and finish signing in through your browser. Restart the app when prompted. The CLI and app share the connection for the same local Codex profile.

Client developer instructions

ChatGPT Web

Open ChatGPT Plugins using the link below. From the + button, choose Add custom MCP server, enter Publicasta and the MCP address above, and choose OAuth authentication. Review the warning and finish Create as a plugin.

Connect the created plugin, start a new chat and select it with @. If adding custom MCP is unavailable, check account or workspace permissions in the OpenAI instructions.

chatgpt.com/plugins

Client developer instructions

Grok (Web / iOS / Android)

Open grok.com/connectors, choose New Connector > Custom and paste the MCP address above. Complete OAuth sign-in to Publicasta; no xAI API key is needed.

In the Grok apps for iOS and Android, open Settings > Connectors. To add a custom MCP server, you can use grok.com/connectors in a browser.

In a new chat, ask Grok to use Publicasta and show your available channels. Then use the requests below. Business or Enterprise accounts may need an administrator to add the connector first.

The Publicasta owner successfully tested article work and image uploads with a free Grok account. Grok availability may change; Publicasta plan requirements and granted permissions apply separately.

grok.com/connectors · iOS / Android

Client developer instructions

Grok Build (CLI)

Run this in a terminal with Grok Build installed:

grok mcp add --transport http publicasta https://publicasta.com/mcp

Open Grok Build. OAuth prompts you to sign in to Publicasta automatically on first use; you can also select the server and authenticate in /mcps. Then ask it to use Publicasta. The command below diagnoses the connection.

grok mcp doctor publicasta

Client developer instructions

Claude / Claude Desktop

Open Customize > Connectors > + Add > Add custom connector. Enter Publicasta and the MCP address above. For OAuth, choose Register automatically and Sign in now; do not add permanent keys to headers.

Finish signing in to Publicasta and enable the connector under + > Connectors in your chat. A workspace administrator may need to add the connector first.

In the tested free Claude environment, direct upload of generated images was blocked by network restrictions, and chunked upload failed integrity checks. File transfer in that environment has not passed acceptance; this is not a conclusion about every Claude version.

Client developer instructions

Claude Code

Run this in a terminal with Claude Code installed. --scope user makes the connection available across your projects:

claude mcp add --transport http --scope user publicasta https://publicasta.com/mcp

Start Claude Code, enter /mcp, select publicasta and authenticate in the browser. In a new conversation, ask it to use the Publicasta tools.

Client developer instructions

Cursor

Add this server to ~/.cursor/mcp.json for all projects or .cursor/mcp.json for one project. If the file exists, merge the entries within mcpServers without replacing existing servers:

{
    "mcpServers": {
        "publicasta": {
            "url": "https://publicasta.com/mcp"
        }
    }
}

Enable publicasta in Cursor MCP settings and choose Connect to sign in. In Agent chat, allow the Publicasta tools.

Client developer instructions

VS Code / GitHub Copilot

Open the VS Code Command Palette and run MCP: Add Server. Choose HTTP, paste the MCP address above, name it publicasta and choose a personal or project configuration destination.

Review the trust prompt and finish signing in to Publicasta. Open Agent chat and enable the publicasta tools in the available tools list.

Client developer instructions

Sign in to Publicasta in the authorization window and choose channels and permissions. To get started, you can allow reading and drafts and choose Ask each time for publication. No manual API key, Client ID or Client Secret is needed.

What to Ask Your AI

Check the connection

Use Publicasta MCP to show my available channels and granted permissions. Do not change anything.

Save a draft

Save the text in this message as a new article in the selected Publicasta channel. Preserve its title and formatting. Do not publish.

Prepare translations

Prepare English and Spanish versions of this article and save them as Publicasta drafts. Preserve images, captions and the paid-content divider. Do not overwrite existing versions without my approval. Do not publish.

Add an image

Add the attached image to the Publicasta article draft and give it a caption. If you cannot access the file, tell me; do not substitute another image. Do not publish.

Check the schedule

Show the selected Publicasta channel schedule for the next week and days without publications. Do not change anything.

Prepare publication

Check this Publicasta article for publication and show issues and target languages. Only after my approval, submit it for normal review. Then check the final status; an accepted request does not mean it is published.

ChatGPT supports direct file input. Other clients can use scoped multipart transfer; an upload page remains available when the client cannot provide a file.

For an available public image link, pass image_url instead of image or upload_id. Publicasta retrieves the file through an isolated Cloudflare Worker and stores its own copy. The link must remain valid during transfer. Keep the same URL and idempotency_key when retrying; use a new key for a different URL. Local paths are not download links. Direct binary upload remains available.

Troubleshooting

If the server is connected but tools are missing, refresh its catalog in the client or start a new chat. You do not need to remove and recreate the existing connection.

If access is denied, check the selected channels and permissions in your Publicasta account MCP tab and the channel owner plan API entitlement. Approving a tool in the AI client does not replace Publicasta permissions.

Permissions

Not allowed blocks an action. Ask each time requires approval of the exact change through MCP elicitation or inline buttons in a compatible client; otherwise use the Publicasta page. A chat message does not answer the form. Allow independently needs no per-operation approval within granted permissions. New channels are not included automatically.

Editorial Capabilities

Use HTML or Markdown, one format per save. Read either or both formats. Lifecycle actions and free access in paid channels have separate permissions, initially denied. Cancel schedules, unpublish articles, change main languages, and delete channel links only with those permissions. Closing a paid channel first requires disabling monetization in Publicasta.

Prepared Images

ChatGPT can pass a selected file directly through its file picker, without downloading and uploading it manually. Clients with local file and HTTP access can use the scoped multipart transfer. The private file expires after 30 minutes; JPG, PNG and WebP up to 10 MiB and 24 MP are supported. Attachment follows the configured permission and confirmation policy. If a client cannot provide the file by either method, the upload page is a fallback.

For small images, an agent that can read the file but cannot use the normal transfer methods can try sending parts through MCP. This fallback uses more conversation capacity and has separate size limits. Compatibility depends on the client; a manual upload page remains available.

Publication and Privacy

Drafts do not change published text. Publication starts the normal review; check the operation outcome before reporting success. Publication uses Publicasta's normal moderation and email limits, just like the website and API. Selected content is shared with the external AI application. Revoking access stops new actions, but does not remove published content or cancel an already approved site schedule.

Publicasta encrypts operation payloads. Temporary image handles expire after 30 minutes. Technical call logs contain no article text or tokens and are eligible for operator cleanup after 30 days; expired plans can be redacted. Permission records remain for access auditing until account deletion. The external AI application's storage rules are separate: Publicasta cannot delete copies it has already received.

AI Connections (MCP)