PostDovo · AI Agents CLI

How to Connect Terminal AI Agents to PostDovo with MCP

Use your terminal-based AI agent to plan, write, schedule and publish social media posts through PostDovo.

For an agent without its own PostDovo guide, connect directly over streamable HTTP or use mcp-remote if it only supports local stdio programs. Both methods below use an access token, so no browser sign-in is needed.

Starter is $0/month and includes AI agents and full automation; Analytics is excluded.

Direct HTTPUse native remote MCP support.
Local BridgeConnect stdio-only agents with mcp-remote.
Token Sign-InSend a Bearer Authorization header.

Quick Setup: Pick One Method

Your agent supportsUse
Remote MCP with custom HTTP headersDirect URL and Authorization header
Only local MCP programs over stdionpx with the mcp-remote bridge
PostDovo MCP endpoint
https://app.postdovo.com/mcp

Use one method for the postdovo entry. PostDovo requires streamable HTTP, not SSE.

Before You Start

Install your AI agent and connect your social accounts in PostDovo. Check the agent’s documentation for its MCP settings, supported transports and secret-storage options.

The examples use a common JSON shape. Some agents use different field names, TOML or an MCP add command. Follow your client’s schema and merge the PostDovo entry with existing settings.

Different from PostDovo’s CLI: this guide connects an AI agent to PostDovo’s MCP tools. PostDovo’s own command-line tool is a separate interface.

If your agent has a dedicated guide, start there: ChatGPT, Claude, Cursor or Grok.

Connect Your AI Agent in Five Steps

01

Create a Dedicated Access Token

Open PostDovo Access tokens, create a token and copy it when shown. Use a separate token for this agent so you can revoke it later without affecting other connections.

Create an Access Token

Replace YOUR_TOKEN privately in the examples. Never publish real tokens in screenshots, shared files or repositories.

02

If Your Agent Supports Remote MCP

Open its MCP configuration file, such as mcp.json or settings.json, or use its MCP add command. Register postdovo with this URL and header:

Common remote MCP configuration
{
  "mcpServers": {
    "postdovo": {
      "url": "https://app.postdovo.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Keep Bearer, one space, then your token. Your client may call the URL serverUrl or httpUrl, or require “type”: “http” or “type”: “streamable-http”. Use its documented names.

If it supports a secret store or environment-variable reference, use that documented feature to keep the token out of the file. Variable expansion is client-specific; a literal variable reference is not automatically substituted by every agent.

With a direct connection, skip Step 3 and continue to Step 4.

03

If Your Agent Only Launches Local Programs

Use mcp-remote to bridge the agent’s stdio connection to PostDovo. Install a supported Node.js version and make sure the agent process can find npx.

Common local bridge configuration
{
  "mcpServers": {
    "postdovo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.postdovo.com/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer YOUR_TOKEN"
      }
    }
  }
}

The first run can download the bridge package. The http-only strategy selects HTTP without an SSE fallback.

Keep Authorization:${AUTH_HEADER} as shown, with no space after the colon. The bridge expands AUTH_HEADER from the environment. Its value is Bearer, one space and your token. This avoids argument-splitting problems in some clients.

The token is still saved in this JSON file, so keep it private. For a separate private credential file, use the header-file option below.

04

Restart the Agent and Check the Tools

Save the configuration and start a new agent session. Check its MCP server list; some clients offer /mcp or mcp list, but commands vary.

Confirm postdovo is connected with its tools, then ask:

Connection check prompt
Using PostDovo, which social accounts do I have connected?

Confirm that it retrieves your accounts. If the server fails or has no tools, review the agent’s logs and use the standalone token test below.

05

Choose Whether Agents May Schedule or Publish

PostDovo asks for a preview and clear approval before immediate publishing. If you only want assistants to prepare drafts, switch off these options in PostDovo’s AI Agents settings:

  • Let assistants publish posts right away
  • Let assistants schedule posts

These switches apply to every agent connected to your account. Review existing scheduled posts separately.

Open AI Agents Settings

Optional: Use a Private Header File with the Bridge

Instead of the inline-header bridge entry, put this line in a private file:

postdovo-headers.txt
Authorization: Bearer YOUR_TOKEN

Replace the placeholder token. Use an absolute path the agent can read, keep the file out of shared repositories and restrict access to its contents.

Bridge configuration using a header file
{
  "mcpServers": {
    "postdovo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.postdovo.com/mcp",
        "--transport",
        "http-only",
        "--header-file",
        "/absolute/path/to/postdovo-headers.txt"
      ]
    }
  }
}

Replace the example path. This keeps the token out of the bridge’s command-line arguments; the private file itself still holds the credential.

Test the Token Without Your Agent

This optional curl diagnostic checks authentication and MCP initialization. It does not publish a post or verify your agent’s configuration.

Set the token in your terminal. Choose the example matching your shell:

Bash / Zsh — macOS, Linux or WSL
export POSTDOVO_TOKEN="YOUR_TOKEN"
Windows PowerShell
$env:POSTDOVO_TOKEN = "YOUR_TOKEN"

The following request is for Bash / Zsh, including WSL. It shows HTTP headers and limits the request to 20 seconds:

MCP initialize diagnostic — Bash / Zsh
curl -i -sS --max-time 20 -X POST "https://app.postdovo.com/mcp" \
  -H "Authorization: Bearer ${POSTDOVO_TOKEN}" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"postdovo-check","version":"1"}}}'
ResponseMeaning
Successful response with serverInfoThe server accepted this authentication and initialization request. Check the agent’s configuration and logs next. Tool discovery and publishing still need their own checks.
401 UnauthorizedCheck for a missing, invalid, expired or revoked token, and incorrect Bearer formatting.
403 ForbiddenReview account access and assistant permissions.
Request or protocol errorRead the response body and check content headers and protocol compatibility before concluding the token is invalid.
Timeout, DNS or TLS errorCheck network access from the machine running the request.

A response may use JSON or event-stream framing. This initialize request is a diagnostic for servers supporting that handshake, not a complete MCP client session. If you use PowerShell, run the Bash example inside WSL or adapt the request to PowerShell’s quoting and HTTP tools.

Commands containing a literal token can remain in shell history. Keep local diagnostics private and redact credentials before sharing output.

Watch the Terminal Agent Setup Tutorial

AI Agents CLI + PostDovo Video Tutorial
AI Agents CLI + PostDovo

Try Your First Social Media Prompt

After checking your accounts, start with a draft:

Draft prompt
Using PostDovo, help me create a social media post for my business. Ask for my business details and target accounts, prepare a draft, and show it to me before scheduling or publishing.

Plan a Series of Posts

Campaign planning prompt
Using PostDovo, plan a seven-day social media campaign. Ask for my website, campaign goal, target accounts, start date and timezone. Prepare drafts and a media plan for my review before scheduling.

Review the drafts in PostDovo. When scheduling is enabled, include exact dates, times, a timezone and target accounts. Images and videos must meet each destination platform’s requirements.

PostDovo Starter Includes AI-Agent Automation

$0/ month — PostDovo Starter

Starter includes up to five connected social accounts in one workspace, unlimited Single Post scheduling and publishing, and AI-agent automation. Analytics is excluded.

PostDovo AI generation uses credits, and X publishing requires credits. Your AI agent or model provider may charge separately.

Prefer typing commands yourself? The PostDovo CLI does the same from your terminal.

Troubleshooting and FAQs

Which method should I use?

Use direct remote MCP when your agent supports streamable HTTP with custom headers. Use the bridge when it only supports local stdio programs.

Can every agent use this exact JSON?

No. It is a common example shape. Configuration paths, root keys, transport names and secret references vary by client.

Why is npx not found?

Install Node.js and confirm the agent’s PATH includes npx. A service, container or desktop-launched process may have a different PATH from your terminal.

Why does a browser sign-in window open?

These examples use token authentication. Check that the Authorization header is passed correctly and the token is accepted. An attempted OAuth flow can indicate that token authentication did not succeed.

Why can the agent connect but not publish?

Check PostDovo’s assistant publishing settings, agent-side permissions, required approvals and the selected platform’s post requirements.

How do I disconnect the agent?

Remove the postdovo MCP entry, restart the agent and revoke its dedicated token in PostDovo. Remove private token files when no longer needed.

Can I share diagnostic logs?

Review and redact them first. Logs, settings and headers can contain tokens or private account details.

Connect Your Terminal Agent to PostDovo

Choose a connection method, add a dedicated token and check your social accounts. Then prepare your first draft.