KosmoKrator

marketing

Freshmarketer MCP Integration for OpenAI Agents SDK

Connect Freshmarketer to OpenAI Agents 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 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.

Freshmarketer MCP Config for OpenAI Agents SDK

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

{
  "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 OpenAI Agents

OpenAI Agents 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 OpenAI AgentsClient-level gateway setup.