Postagent

One CLI for every app your agent needs.

No more installing a new MCP server or CLI for each app your agent uses. Postagent connects your AI agent to any API — Notion, Linear, GitHub, Slack, and more.

• 🔌 No per-site setup — one npm install -g postagent covers every supported API
• 🔍 Discover by intent — postagent search "create a doc on Notion" instead of reading docs
• 🔐 Credentials stay local — API keys are injected at send time, never leaked into the LLM context

Install

npm install -g postagent

Quickstart

# Search related actions
postagent search "Create a document on Notion"

# Get detailed manual for an action
postagent manual notion pages create_page

# Auth and send request
postagent auth notion
postagent send -X POST https://api.notion.com/v1/pages \
  -H 'Authorization: Bearer $POSTAGENT.NOTION.API_KEY' \
  -H 'Notion-Version: 2022-06-28' \
  -H 'Content-Type: application/json' \
  -d '{"parent":{"page_id":"YOUR_PAGE_ID"},"properties":{"title":[{"text":{"content":"My Page"}}]}}'

The send command uses the same options as curl, so agents already know how to use it.

Postagent replaces the API_KEY placeholder with the actual key/token from local storage, keeping your credentials out of the LLM context entirely.

Add --dry-run to preview the resolved request (method, URL, headers, body) without making any outbound call. Sensitive headers are redacted in the preview:

postagent send https://api.github.com/user \
  -H 'Authorization: Bearer $POSTAGENT.GITHUB.TOKEN' \
  --dry-run

Usage with Agents

The easiest way is to just tell your agent to use it:

Configuration

You can try and test Postagent without setting an API key. However, the no API key mode is rate limited to 10 requests per minute.

If you need more requests, you can get a free API key from Actionbook and set it using the following command:

postagent config set apiKey ak_xxxxxxxxxxxx

Or via environment variables:

export POSTAGENT_API_KEY=ak_xxxxxxxxxxxx

Commands

postagent search <query>                    # Search for related actions by natural language
postagent auth <site>                       # Complete an auth flow for a site
postagent manual <site> [group] [action]    # Get detailed manual for an action
postagent send [options]                    # Send a request to a site, the options is same as curl

Supported sites

Visit https://api.postagent.dev/supported-sites.md to get the full list of supported sites. We are continually expanding it.

Stay tuned

We move fast. Star Postagent on Github to support and get latest information.

Development

pnpm install
pnpm dev:watch

License

Apache-2.0