KosmoKrator

communication

Postmark MCP Integration for OpenAI Agents SDK

Connect Postmark to OpenAI Agents SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

9 functions 7 read 2 write API token auth

Connect Postmark to OpenAI Agents SDK

Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway.

Start the KosmoKrator MCP gateway locally and point the OpenAI Agents SDK MCP tool at that process or wrapper. The gateway is local, scoped to this integration, and starts with --write=deny so OpenAI Agents can inspect read-capable tools without receiving write access by default.

Postmark MCP Config for OpenAI Agents SDK

Use headless JSON commands for CI-style execution and MCP for agent tool discovery.

{
  "mcpServers": {
    "kosmokrator-postmark": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=postmark",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=postmark --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Postmark instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Postmark Tools Visible to OpenAI Agents

OpenAI Agents sees stable MCP tool names generated from the Postmark integration catalog.

MCP toolSource functionTypeDescription
integration__postmark__postmark_list_messages postmark.postmark_list_messages Read List outbound messages from Postmark. Supports filtering by recipient, sender, subject, status, and tag.
integration__postmark__postmark_get_message postmark.postmark_get_message Read Get details for a specific Postmark outbound message including body, recipients, and delivery status.
integration__postmark__postmark_send_email postmark.postmark_send_email Write Send an email through Postmark. Requires To, From, and Subject. Provide either TextBody or HtmlBody.
integration__postmark__postmark_send_template postmark.postmark_send_template Write Send an email using a Postmark template. Provide either a TemplateId or TemplateAlias along with the template model data.
integration__postmark__postmark_get_delivery_stats postmark.postmark_get_delivery_stats Read Get email delivery statistics for your Postmark server, including counts of sent, bounced, and spam complaints.
integration__postmark__postmark_list_templates postmark.postmark_list_templates Read List all email templates in Postmark. Supports pagination.
integration__postmark__postmark_get_template postmark.postmark_get_template Read Get details for a Postmark email template including subject, HTML body, and text body.
integration__postmark__postmark_list_servers postmark.postmark_list_servers Read List servers in the Postmark account. Supports filtering by name and pagination.
integration__postmark__postmark_get_current_user postmark.postmark_get_current_user Read Get the current Postmark server info including name, settings, and delivery stats. Useful as a health check.

Related Postmark Pages