KosmoKrator

marketing

Freshmarketer MCP Integration for Claude Agent SDK

Connect Freshmarketer to Claude Agent SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

7 functions 6 read 1 write Bearer token auth
Submit Freshmarketer feedback View package source

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

Freshmarketer MCP Config for Claude Agent SDK

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

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

Run the Gateway Manually

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

Why Use KosmoKrator Here

Scoped tools

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

Freshmarketer Tools Visible to Claude Agent SDK

Claude Agent SDK sees stable MCP tool names generated from the Freshmarketer integration catalog.

MCP toolSource functionTypeDescription
integration__freshmarketer__freshmarketer_list_campaigns freshmarketer.freshmarketer_list_campaigns Read List marketing campaigns from Freshmarketer. Supports pagination and filtering by status (e.g., "active", "completed", "draft").
integration__freshmarketer__freshmarketer_get_campaign freshmarketer.freshmarketer_get_campaign Read Get detailed information about a specific marketing campaign by its ID.
integration__freshmarketer__freshmarketer_create_campaign freshmarketer.freshmarketer_create_campaign Write Create a new marketing campaign in Freshmarketer. Specify the campaign name, channels (e.g., "email"), and an optional schedule.
integration__freshmarketer__freshmarketer_list_segments freshmarketer.freshmarketer_list_segments Read List contact segments in Freshmarketer. Supports pagination to browse through all segments.
integration__freshmarketer__freshmarketer_get_segment freshmarketer.freshmarketer_get_segment Read Get detailed information about a specific contact segment by its ID.
integration__freshmarketer__freshmarketer_list_users freshmarketer.freshmarketer_list_users Read List all users in the Freshmarketer account.
integration__freshmarketer__freshmarketer_get_current_user freshmarketer.freshmarketer_get_current_user Read Get the profile of the currently authenticated Freshmarketer user.

Related Freshmarketer Pages

Freshmarketer CLIUse direct JSON commands instead of MCP discovery. Freshmarketer MCPFull gateway reference and MCP tool names. KosmoKrator for Claude Agent SDKClient-level gateway setup.