# Postbag

> Postbag is a freemium MCP server for developer tools. Form backend for agents: create, test and route forms through MCP. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $15 a month
- **Platforms:** API, CLI, Self-hosted, Web
- **Website:** https://postbag.dev/for-ai-agents/
- **Repository:** https://github.com/faahim/postbag
- **MCP Registry name:** dev.postbag/mcp
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [form backend](https://ai-powered.com/categories/form-backend)
- **Listing updated:** 2026-11-22

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp --env POSTBAG_API_KEY='<POSTBAG_API_KEY>' -- npx -y @postbag/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@postbag/mcp"
      ],
      "env": {
        "POSTBAG_API_KEY": "<POSTBAG_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@postbag/mcp"
      ],
      "env": {
        "POSTBAG_API_KEY": "<POSTBAG_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@postbag/mcp"
      ],
      "env": {
        "POSTBAG_API_KEY": "<POSTBAG_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@postbag/mcp"
      ],
      "env": {
        "POSTBAG_API_KEY": "<POSTBAG_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@postbag/mcp"
      ],
      "env": {
        "POSTBAG_API_KEY": "<POSTBAG_API_KEY>"
      }
    }
  }
}
```

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/postbag-2
