KosmoKrator

marketing

SparkPost MCP Integration for OpenAI Agents SDK

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

7 functions 6 read 1 write API key auth
Submit SparkPost feedback View package source

Connect SparkPost 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.

SparkPost MCP Config for OpenAI Agents SDK

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

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

Run the Gateway Manually

kosmokrator mcp:serve --integration=spark-post --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only SparkPost 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.

SparkPost Tools Visible to OpenAI Agents

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

MCP toolSource functionTypeDescription
integration__spark_post__spark_post_list_sending_domains spark-post.spark_post_list_sending_domains Read List sending domains configured in SparkPost. Returns domain names along with verification and DKIM signing status.
integration__spark_post__spark_post_get_sending_domain spark-post.spark_post_get_sending_domain Read Get details for a specific sending domain in SparkPost. Returns verification status, DKIM signing info, and SPF records.
integration__spark_post__spark_post_list_templates spark-post.spark_post_list_templates Read List email templates in SparkPost. Returns template IDs, names, and published status.
integration__spark_post__spark_post_get_template spark-post.spark_post_get_template Read Get a specific email template by ID from SparkPost. Can retrieve the draft or published version.
integration__spark_post__spark_post_send_transmission spark-post.spark_post_send_transmission Write Send an email transmission via SparkPost. Provide sender address, subject, content (HTML and/or text), and a list of recipients.
integration__spark_post__spark_post_list_webhooks spark-post.spark_post_list_webhooks Read List webhooks configured in SparkPost. Returns webhook IDs, target URLs, and subscribed event types.
integration__spark_post__spark_post_get_current_user spark-post.spark_post_get_current_user Read Get current SparkPost account information. Returns account status, subscription plan, and usage details.

Related SparkPost Pages

SparkPost CLIUse direct JSON commands instead of MCP discovery. SparkPost MCPFull gateway reference and MCP tool names. KosmoKrator for OpenAI AgentsClient-level gateway setup.