KosmoKrator

marketing

SparkPost MCP Integration for Claude Agent SDK

Connect SparkPost to Claude Agent 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 Claude Agent SDK

Give Claude Agent SDK workflows access to KosmoKrator integrations through a local MCP server.

Add a KosmoKrator stdio MCP server to the Claude Agent SDK options. The gateway is local, scoped to this integration, and starts with --write=deny so Claude Agent SDK can inspect read-capable tools without receiving write access by default.

SparkPost MCP Config for Claude Agent SDK

Use a narrow integration list so the agent does not load unrelated tools.

{
  "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 Claude Agent SDK

Claude Agent SDK 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 Claude Agent SDKClient-level gateway setup.