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.
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
Expose only Postmark instead of a broad multi-service tool list.
Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.
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 tool | Source function | Type | Description |
|---|---|---|---|
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. |