Skip to content
SocialHelper
Get API key

MCP client

Codex CLI + SocialHelper

Add the SocialHelper MCP server to Codex CLI and your agent can list your accounts, check each platform’s rules, publish posts and run data tools, asking you before it posts.

Get a free API key About the MCP server
Checked against Codex CLI’s docs on October 10, 2026

Setup

Set it up in Codex CLI.

Replace YOUR_API_KEY with your key, or keep the key in an environment variable as shown.

Source: Codex CLI documentation ↗

  1. 1

    Create an API key

    In the SocialHelper dashboard, open Developers and create a key. It starts with sh_ and is shown once, so copy it somewhere safe.

  2. 2

    Add the server

    Add this to ~/.codex/config.toml. Codex reads the key from the environment variable you name.

    [mcp_servers.socialhelper]
url = "https://socialhelper.app/mcp"
bearer_token_env_var = "SOCIALHELPER_API_KEY"
  3. 3

    Set the key

    Export SOCIALHELPER_API_KEY in the shell you run Codex from.

    export SOCIALHELPER_API_KEY="YOUR_API_KEY"
  4. 4

    Try it

    Ask: “List my SocialHelper accounts.” Codex CLI calls list_accounts and shows the accounts you connected.

What your agent gets

9 tools.

Every tool runs with your API key and is limited to your workspace.

list_accounts

List the accounts connected to this workspace. Accounts with can_publish receive posts: use their IDs as `accounts` in create_post. Accounts with tools (Search Console, Analytics, Ads…) offer reports and lookups: see list_account_tools. Only accounts with status "active" can be used.

get_platform_rules

Get the rules posts must fit on each platform: text limit and how it is counted, how many images/videos, accepted file types and sizes, and platform-specific options you can pass in create_post overrides.

upload_media

Import an image or video from a public URL so it can be attached to a post. Returns a media ID for create_post. Accepts JPEG, PNG, WebP, GIF, MP4 and MOV up to 60 MB.

create_post

Publish a post to one or more connected accounts, now or at scheduled_at. The content is checked against every target platform first: if anything does not fit, nothing is posted and all problems are returned. Posting is public — confirm the text and accounts with the user first.

get_post

Get a post and the status of each target account: scheduled, queued, publishing, confirming, published (with its live URL), failed (with the reason) or cancelled.

list_posts

List recent posts, newest first, optionally filtered by status. Useful for finding scheduled posts or recent failures.

cancel_post

Cancel a scheduled post on every account where it has not started publishing. Already-published targets are not removed from the platform.

list_account_tools

List the tools a connected account offers, such as Search Console queries, Analytics reports or Google Ads searches, with each tool's input schema. Run them with run_account_tool. Accounts that only receive posts have no tools.

run_account_tool

Run one of a connected account's tools (see list_account_tools) and get its result. Pass the tool's input as `input`, matching its input schema.

Ship it from Codex CLI.

Create a free account, connect an account and send your first post in a few minutes.

Get a free API key Read the docs