Skip to content
MCP server

Postbag

Form backend for agents: create, test and route forms through MCP

Runs locally
Install

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/mcp

Add 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`.Required
  • POSTBAG_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.

How AIPoweredBot checks servers