Use tinyposter from Codex (and other coding agents)

Pick your path

Path A — MCP via Codex CLI (recommended)

Codex CLI reads MCP servers from ~/.codex/config.toml. Add a single block and tinyposter's tools become available to the agent automatically.

1. 01

   Get a token

   Open your tokens page. Click Create token, name it “Codex,” copy the tp_… string. It only shows once.

2. 02

   Edit ~/.codex/config.toml

   Add this block (create the file if it doesn't exist). On macOS/Linux the file is at ~/.codex/config.toml; on Windows it's %USERPROFILE%\.codex\config.toml.

   ~/.codex/config.tomltoml

   Copy

   [mcp_servers.tinyposter]
   url = "https://tinyposter.app/api/mcp"
   
   [mcp_servers.tinyposter.headers]
   Authorization = "Bearer tp_PASTE_YOUR_TOKEN_HERE"

   Replace tp_PASTE_YOUR_TOKEN_HERE with your token. Keep the word Bearer and the space.

3. 03

   Restart Codex and verify

   Quit and re-open Codex. In any session, run /mcp — you should see tinyposter listed, along with its tools.

   Try asking:

   text

   Copy

   Use tinyposter to list my connected social accounts.

Path B — Use the CLI

If your agent doesn't do MCP (older Codex builds, generic shell agents) but it can run terminal commands, install the tinyposter CLI.

1. 01

   Install the CLI

   From a terminal, run:

   bash

   Copy

   npm install -g tinyposter

   Or skip install and use it on demand:

   bash

   Copy

   npx tinyposter <command>

   Needs Node.js 18 or newer. If you don't have Node, get it at nodejs.org.

2. 02

   Set the token

   Get a token from your tokens page. Then either:

   Option 1 — interactive:

   bash

   Copy

   tinyposter login

   Option 2 — environment variable (best for agents/CI):

   bash

   Copy

   export TINYPOSTER_TOKEN=tp_paste_your_token_here

3. 03

   Tell your agent to use it

   Most agents already know how to run terminal commands. Drop these instructions into your project notes or system prompt:

   text

   Copy

   When the user asks you to post to social media, use the tinyposter CLI:
   - tinyposter accounts          # list connected platforms
   - tinyposter post "<text>" --to PLATFORMS
   - tinyposter schedule "<text>" --to PLATFORMS --at <ISO datetime>
   - tinyposter list              # see recent posts
   - tinyposter cancel <id>       # cancel a scheduled post
   Pass --json to get machine-readable output.

Path C — Raw HTTP with curl

If you can't install anything, every agent that runs shell can use curl. Set your token in an env var, then:

export TINYPOSTER_TOKEN=tp_paste_your_token

# List connected accounts
curl -s https://tinyposter.app/api/v1/accounts \
  -H "Authorization: Bearer $TINYPOSTER_TOKEN"

# Post to multiple platforms
curl -s https://tinyposter.app/api/v1/posts \
  -H "Authorization: Bearer $TINYPOSTER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text":"hello from my agent","platforms":["TWITTER","LINKEDIN"]}'

# Schedule for later
curl -s https://tinyposter.app/api/v1/posts \
  -H "Authorization: Bearer $TINYPOSTER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text":"sunday note","platforms":["THREADS"],"scheduled_at":"2026-05-03T13:00:00Z"}'

Cursor specific

Cursor supports MCP natively (no CLI needed). Full walkthrough on the MCP page under “Cursor.” If you want the CLI path instead, drop the same instructions from Path B into your .cursorrules or .cursor/rules.md.

Claude Code specific

For Claude Code, MCP is the cleanest path — see the Claude guide. If you want the CLI for some reason, install it as in Path B and add a note to your CLAUDE.md:

# Social posting

Use the `tinyposter` CLI for any social media tasks.
Token is in `$TINYPOSTER_TOKEN`. Run `tinyposter help` to see commands.

Troubleshooting

Next

• MCP reference — every tool, every input
• CLI guide — every command and flag
• HTTP API — what the CLI is calling under the hood