GitHub - actionbook/postagent: Let your AI agent call thousands of APIs — correctly.

2 min read Original article ↗

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 intentpostagent 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

Quickstart

Postagent is meant to be driven by an agent, not by you. After installing, just tell your agent it has postagent available, then send it a task — for example:

"Use CLI postagent to list my documents on notion"

The agent will discover, read, auth, and call the API on its own:

Postagent demo

send mirrors curl, so agents already know how to drive it. The $POSTAGENT.NOTION.API_KEY placeholder is resolved from local storage at send time — your credentials never enter the model context. Add --dry-run to any send to let the agent preview the resolved request (with sensitive headers redacted) before firing.

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.

star-postagent-original

Development

pnpm install
pnpm dev:watch

License

Apache-2.0