Getting Your API Key

1. Go to Settings > API Keys in your organization settings (requires admin access)
2. Click Create API Key and enter a name
3. Copy the key immediately - it's only shown once
4. Keys have a pstl_ prefix (e.g., pstl_abc123...)

The creation dialog also shows ready-to-copy MCP config snippets for different clients.

Alternatively, running the OAuth setup command below will open your browser and guide you through the authentication flow.

Setup Guides

General

Our MCP server supports Streamable HTTP transport with OAuth 2.1 and API key authentication:

Claude Code

With OAuth (recommended):

claude mcp add postel --transport http --url "https://www.postel.app/api/mcp"

Then run /mcp once you've opened a Claude Code session to go through the browser-based OAuth flow.

With API Key:

Add to your ~/.claude/settings.json or project .mcp.json:

{
  "mcpServers": {
    "postel": {
      "type": "url",
      "url": "https://www.postel.app/api/mcp",
      "headers": {
        "Authorization": "Bearer pstl_YOUR_API_KEY"
      }
    }
  }
}

Scope Options:

• --scope user - Available in all your projects
• --scope project - Shared with your team via .mcp.json
• Default (no flag) - Current project only

Cursor

To add the MCP to Cursor:

1. Open File > Preferences > Cursor Settings > MCP
2. Or press Cmd+Shift+P (Mac) / Ctrl+Shift+P (Windows/Linux) and type "View: Open MCP Settings"
3. Add the following configuration:

{
  "mcpServers": {
    "postel": {
      "type": "url",
      "url": "https://www.postel.app/api/mcp",
      "headers": {
        "Authorization": "Bearer pstl_YOUR_API_KEY"
      }
    }
  }
}

Visual Studio Code

Ctrl/Cmd+P and search for MCP: Add Server.

Select HTTP and enter the following configuration:

{
  "mcpServers": {
    "postel": {
      "type": "url",
      "url": "https://www.postel.app/api/mcp",
      "headers": {
        "Authorization": "Bearer pstl_YOUR_API_KEY"
      }
    }
  }
}

Activate the server using MCP: List Servers, selecting Postel, and selecting Start Server.

Windsurf

Open Windsurf Settings and navigate to Cascade > MCP.

Click Add Server and paste the following configuration:

{
  "mcpServers": {
    "postel": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.postel.app/api/mcp"],
      "env": {
        "MCP_API_KEY": "pstl_YOUR_API_KEY"
      }
    }
  }
}

Note: Windsurf uses mcp-remote to connect to HTTP MCP servers. The API key is passed via environment variable.

Others

Many other tools now support MCP servers. You can configure them to use Postel's MCP server with the following settings:

Capabilities

The Postel MCP server exposes 15 tools across three categories.

Post Management (7 tools)

AI Generation (3 tools)

Data and Context (5 tools)

FAQ