Postbag
Form backend for agents: create, test and route forms through MCP
Postbag is a freemium MCP server for developer tools. It runs locally on your machine and is started by your AI client.
- Pricing
- Freemium
- Platforms
- API, CLI, Self-hosted
- Runs
- Locally
- Version
- 0.1.1
- Listing updated
Similar MCP servers
Install
Run in a terminal
claude mcp add mcp --env POSTBAG_API_KEY='<POSTBAG_API_KEY>' -- npx -y @postbag/mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@postbag/mcp"
],
"env": {
"POSTBAG_API_KEY": "<POSTBAG_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@postbag/mcp"
],
"env": {
"POSTBAG_API_KEY": "<POSTBAG_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@postbag/mcp"
],
"env": {
"POSTBAG_API_KEY": "<POSTBAG_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@postbag/mcp"
],
"env": {
"POSTBAG_API_KEY": "<POSTBAG_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@postbag/mcp"
],
"env": {
"POSTBAG_API_KEY": "<POSTBAG_API_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
POSTBAG_API_KEYA Postbag API key (pb_live_… or pb_test_…). Mint one at https://postbag.dev/app or with `postbag login`.RequiredPOSTBAG_API_URLBase URL of the Postbag API. Defaults to https://postbag.dev — set this only for a self-hosted instance.
About Postbag
Postbag is a form backend, and its MCP server gives each Postbag API operation its own tool, plus quickstart and explain helpers. An agent can create a sandbox form without credentials, submit test messages and inspect receipts before you sign up.
A human then claims the form, which keeps the same ID and submit URL, and the agent adds a Destination and Route so deliveries go out by email, Telegram or webhook. Idempotency keys keep retries safe, and receipt and delivery are separate proofs.
The server runs locally over stdio with an API key. You can use Postbag Cloud or self-host it under AGPL-3.0 with MIT clients.
What it does
- Sandbox forms
- Create and test a form with no account, up to five tests.
- Claim handoff
- A human claims the form without changing its ID or submit URL.
- Routing
- Destinations and routes deliver by email, Telegram or webhook.
- Delivery checks
- Inspect receipt and delivery results separately.
- Idempotent calls
- Idempotency keys make setup retries safe.
- Self-hostable
- Run it yourself with a container, Postgres and S3-compatible storage.
Good for
- Have a coding agent wire up a site's contact form
- Test a form's receipt before signing up
- Route submissions to a webhook
- Self-host a form backend for a team
Pricing
Freemium, from $15 a month
Free plan (1,000 messages/mo); Pro $15/mo; Team $49/mo; self-hosting free
Prices change. Check postbag.dev before you buy.
Postbag FAQ
What does Postbag cost?
Free with 1,000 messages a month, Pro $15 and Team $49; self-hosting has no licence fee.
How do I run the MCP server?
Run npx -y @postbag/mcp with POSTBAG_API_KEY set.
What license applies?
AGPL-3.0 for the server and MIT for clients.
Can an agent try Postbag without an account?
Yes, with a bounded sandbox form.
How do I add Postbag to Claude Code?
Run this command in your terminal: claude mcp add mcp --env POSTBAG_API_KEY='<POSTBAG_API_KEY>' -- npx -y @postbag/mcp
What are the best alternatives to Postbag?
The closest alternatives to Postbag are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.


