Skip to content
OpenPostDocs
OpenPostDocs

Choose an agent connection

Compare MCP, the OpenPost CLI skill, and direct CLI commands.

MCP, the openpost-cli skill, and direct CLI commands can reach the same OpenPost account, but they fit different agent environments.

MCPopenpost-cli skillDirect CLI
The assistant needsMCP supportAgent Skills and terminal accessTerminal access
ConnectionRemote HTTP or local bridgeInstalled openpost CLIInstalled openpost CLI
GuidanceLive tool schemas from OpenPostPackaged OpenPost operating instructionsCLI help and your prompt
CredentialsMCP OAuth or tokenCLI profile or OPENPOST_TOKENCLI profile or OPENPOST_TOKEN
Best useInteractive account work in a chat or coding clientOpenPost work inside a coding-agent taskScripts, CI, and explicit command sequences

Choose MCP

Use MCP when the client supports it and you want OpenPost tools inside the conversation. The assistant receives current operation schemas from the server. You can grant read-only access or allow changes, and you can bind the connection to one workspace.

Do not use MCP when the client cannot reach your OpenPost instance and cannot launch the local bridge. Do not add the CLI skill to solve an MCP connection problem. The skill does not configure or authenticate MCP.

Learn how OpenPost MCP works

Choose the openpost-cli skill

Use the skill when a coding assistant supports Agent Skills and already has terminal access. The skill tells the assistant how to inspect its CLI context, choose the correct authoring command, avoid unsafe retries, and verify the result.

Do not use the skill when the assistant cannot run the openpost command. The skill contains instructions, not an API client or credentials. It is also unnecessary when the same assistant already has a working OpenPost MCP connection.

Install and use the skill

Choose direct CLI commands

Use the CLI without the skill for scripts, CI, and agents that do not support Agent Skills. Direct commands are also useful when you want an exact, repeatable command sequence and machine-readable JSON.

Do not use the direct CLI when the assistant has no terminal access. For a long-lived application, use the SDK or HTTP API instead of wrapping many shell commands.

Install and use the CLI

On this page