yeetpostyeetpost

Post to social media from Codex

Add one table to Codex's config.toml, or run codex mcp add with --bearer-token-env-var, and Codex can post, schedule and queue through yeetpost. The key stays in an environment variable, not in the file.

Get an API keyMCP docs

Set it up

The server is a Streamable HTTP MCP endpoint at https://api.yeetpost.com/api/v2/mcp.

  1. Connect at least one account in the yeetpost console (https://app.yeetpost.com). Each connection gets a slug, such as linkedin or bluesky, which is how the agent addresses it.

  2. Create an API key on the API page of the yeetpost console (https://app.yeetpost.com/app/api). A key starting yp_test_ reaches sandbox connections only and publishes nothing, which is the one to use while you wire this up.

  3. Export the key in the shell Codex starts from:

    export YEETPOST_API_KEY=yp_secret_your_key_here

  4. Add the server to ~/.codex/config.toml:

    [mcp_servers.yeetpost]
url = "https://api.yeetpost.com/api/v2/mcp"
bearer_token_env_var = "YEETPOST_API_KEY"

  5. Or have the CLI write that table, with the key variable set as above:

    codex mcp add yeetpost --url https://api.yeetpost.com/api/v2/mcp --bearer-token-env-var YEETPOST_API_KEY

  6. Start Codex and ask it to post.

Three things to ask

  • Post this to my Mastodon account: new release is out, notes are on the blog.
  • Send a Telegram message to my channel: build 412 is live.
  • List my connections and say which ones can take a thread.

What Codex gets

All 37 tools of the yeetpost MCP server, including:

  • get_context: Start here. Who you act as, live or test mode, the plan, what is left of today's allowance, and what needs attention (failed posts, expired logins, connections with no slots), each with its fix.
  • create_post: Post to one or more connections now, at scheduledFor, into the queue, or as a draft, with images, a timezone and an idempotencyKey so a retry never posts twice.
  • list_posts: List posts, newest first, filtered by status, tag, connection, platform, profile, send group or time, with paging.
  • draw_card: Draw an image card for an existing post in its connection's look, to show the user and attach when they say yes.
  • get_post_metrics: A post's numbers over time, and whether yeetpost is collecting them for its connection.

The full list is on the MCP docs page.

FAQ

Which platforms can Codex post to through yeetpost?
LinkedIn, X, Bluesky, Discord, Telegram and Mastodon. Reddit, Facebook, Instagram, Threads, Google Business Profile, Slack, SMS and email are not live yet.
Can I try it without posting for real?
Yes. A test key (starts yp_test_) sees sandbox connections only: posts are validated and answered like a real platform's, and nothing is published.
Does it cost anything?
Posts are unlimited on every plan. Billing is per connected account, with the first 2 free. X is the one platform with a per-post fee, passed through at X's own cost: 1.5 cents a post, 20 cents when the post has a link.
Which tools does the agent get?
All 37 tools of the hosted MCP server: posting, scheduling and queues, drafts, brand voice and image cards, media, connections and sources. The full list is on the MCP docs page.

More

Other clients: Claude, Cursor, n8n, Windsurf, VS Code.

By platform: LinkedIn MCP server, X MCP server, Bluesky MCP server, Mastodon MCP server, Telegram MCP server, Discord MCP server.