KosmoKrator

productivity

Courier MCP Gateway for AI Agents

Expose Courier tools to Claude Code, Cursor, Codex, and other MCP clients through the local KosmoKrator MCP gateway.

Courier MCP Gateway

Expose Courier to MCP clients with `kosmokrator mcp:serve --integration=courier`.

If the client has never used KosmoKrator before, install it first, then register this integration as a stdio MCP server.

Install KosmoKrator 
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash
Install gateway entry 
kosmokrator mcp:gateway:install --integration=courier --write=deny --json
MCP configuration 
{
  "mcpServers": {
    "kosmokrator-courier": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=courier",
        "--write=deny"
      ]
    }
  }
}
Serve manually 
kosmokrator mcp:serve --integration=courier --write=deny

Client Notes

Use one scoped MCP gateway entry, then adapt the config location to the client or framework.

Claude Code Connect local KosmoKrator integrations to Claude Code through one scoped MCP gateway entry. Claude Code can launch the local kosmo binary directly from the project MCP config.
Cursor Expose selected local integrations to Cursor through KosmoKrator without configuring each service as its own MCP server. Use the same KosmoKrator install and integration credentials that power terminal and headless runs.
Codex Use KosmoKrator as a local MCP proxy for Codex so coding sessions can reach selected integrations with explicit write policy. Keep write access denied or ask-based unless the workspace is trusted.
OpenAI Agents SDK Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway. Use headless JSON commands for CI-style execution and MCP for agent tool discovery.
Claude Agent SDK Give Claude Agent SDK workflows access to KosmoKrator integrations through a local MCP server. Use a narrow integration list so the agent does not load unrelated tools.
Vercel AI SDK Use KosmoKrator as a local integration gateway for Vercel AI SDK agents and scripts. Prefer CLI JSON calls when a workflow only needs one deterministic integration operation.
LangChain Bridge LangChain agents to local KosmoKrator integration tools through MCP or headless CLI calls. Keep the gateway scoped to the integration and operation class needed by the chain.
LangGraph Run KosmoKrator integration calls from LangGraph nodes while preserving local credentials and permissions. Headless CLI calls fit repeatable graph edges; MCP fits exploratory agent nodes.
CrewAI Expose KosmoKrator integrations to CrewAI workers as scoped local tools. Use per-worker integration scopes to avoid giving every worker every tool.
Generic MCP Clients Connect any stdio-compatible MCP client to local KosmoKrator integration tools. Start with read-only write policy and expand only for trusted projects.

MCP Tool Names

KosmoKrator exposes integration tools through the gateway with stable names.

MCP toolSource functionType
integration__courier__courier_audiences_delete courier.courier_audiences_delete Write write
integration__courier__courier_audiences_get courier.courier_audiences_get Read read
integration__courier__courier_audiences_list_audiences courier.courier_audiences_list_audiences Read read
integration__courier__courier_audiences_list_members courier.courier_audiences_list_members Read read
integration__courier__courier_audiences_update courier.courier_audiences_update Write write
integration__courier__courier_audit_events_get courier.courier_audit_events_get Read read
integration__courier__courier_audit_events_list courier.courier_audit_events_list Read read
integration__courier__courier_auth_tokens_issue_token courier.courier_auth_tokens_issue_token Write write
integration__courier__courier_automations_invoke_ad_hoc_automation courier.courier_automations_invoke_ad_hoc_automation Write write
integration__courier__courier_automations_invoke_automation_template courier.courier_automations_invoke_automation_template Write write
integration__courier__courier_automations_list courier.courier_automations_list Read read
integration__courier__courier_brands_create courier.courier_brands_create Write write
integration__courier__courier_brands_delete courier.courier_brands_delete Write write
integration__courier__courier_brands_get courier.courier_brands_get Read read
integration__courier__courier_brands_list courier.courier_brands_list Read read
integration__courier__courier_brands_replace courier.courier_brands_replace Write write
integration__courier__courier_bulk_create_job courier.courier_bulk_create_job Write write
integration__courier__courier_bulk_get_job courier.courier_bulk_get_job Read read
integration__courier__courier_bulk_get_users courier.courier_bulk_get_users Read read
integration__courier__courier_bulk_ingest_users courier.courier_bulk_ingest_users Write write
integration__courier__courier_bulk_run_job courier.courier_bulk_run_job Write write
integration__courier__courier_inbound_track courier.courier_inbound_track Write write
integration__courier__courier_journeys_invoke courier.courier_journeys_invoke Write write
integration__courier__courier_journeys_list courier.courier_journeys_list Read read
integration__courier__courier_lists_add_subscribers courier.courier_lists_add_subscribers Write write
integration__courier__courier_lists_delete courier.courier_lists_delete Write write
integration__courier__courier_lists_get courier.courier_lists_get Read read
integration__courier__courier_lists_get_subscribers courier.courier_lists_get_subscribers Read read
integration__courier__courier_lists_list courier.courier_lists_list Read read
integration__courier__courier_lists_restore courier.courier_lists_restore Write write
integration__courier__courier_lists_subscribe courier.courier_lists_subscribe Write write
integration__courier__courier_lists_unsubscribe courier.courier_lists_unsubscribe Write write
integration__courier__courier_lists_update courier.courier_lists_update Write write
integration__courier__courier_lists_update_subscribers courier.courier_lists_update_subscribers Write write
integration__courier__courier_messages_archive courier.courier_messages_archive Write write
integration__courier__courier_messages_cancel courier.courier_messages_cancel Write write
integration__courier__courier_messages_get courier.courier_messages_get Read read
integration__courier__courier_messages_get_content courier.courier_messages_get_content Read read
integration__courier__courier_messages_get_history courier.courier_messages_get_history Read read
integration__courier__courier_messages_list courier.courier_messages_list Read read
integration__courier__courier_notifications_archive courier.courier_notifications_archive Write write
integration__courier__courier_notifications_create courier.courier_notifications_create Write write
integration__courier__courier_notifications_list courier.courier_notifications_list Read read
integration__courier__courier_notifications_list_versions courier.courier_notifications_list_versions Read read
integration__courier__courier_notifications_publish courier.courier_notifications_publish Write write
integration__courier__courier_notifications_replace courier.courier_notifications_replace Write write
integration__courier__courier_notifications_retrieve courier.courier_notifications_retrieve Read read
integration__courier__courier_profiles_create courier.courier_profiles_create Write write
integration__courier__courier_profiles_delete courier.courier_profiles_delete Write write
integration__courier__courier_profiles_delete_list_subscription courier.courier_profiles_delete_list_subscription Write write
integration__courier__courier_profiles_get courier.courier_profiles_get Read read
integration__courier__courier_profiles_get_list_subscriptions courier.courier_profiles_get_list_subscriptions Read read
integration__courier__courier_profiles_merge_profile courier.courier_profiles_merge_profile Write write
integration__courier__courier_profiles_replace courier.courier_profiles_replace Write write
integration__courier__courier_profiles_subscribe_to_list courier.courier_profiles_subscribe_to_list Write write
integration__courier__courier_routing_strategies_archive courier.courier_routing_strategies_archive Write write
integration__courier__courier_routing_strategies_create courier.courier_routing_strategies_create Write write
integration__courier__courier_routing_strategies_list courier.courier_routing_strategies_list Read read
integration__courier__courier_routing_strategies_replace courier.courier_routing_strategies_replace Write write
integration__courier__courier_routing_strategies_retrieve courier.courier_routing_strategies_retrieve Read read
integration__courier__courier_send courier.courier_send Write write
integration__courier__courier_tenants_create_or_replace courier.courier_tenants_create_or_replace Write write
integration__courier__courier_tenants_create_or_replace_default_preferences_for_topic courier.courier_tenants_create_or_replace_default_preferences_for_topic Write write
integration__courier__courier_tenants_delete courier.courier_tenants_delete Write write
integration__courier__courier_tenants_get courier.courier_tenants_get Read read
integration__courier__courier_tenants_get_template_by_tenant courier.courier_tenants_get_template_by_tenant Read read
integration__courier__courier_tenants_get_template_list_by_tenant courier.courier_tenants_get_template_list_by_tenant Read read
integration__courier__courier_tenants_get_template_version courier.courier_tenants_get_template_version Read read
integration__courier__courier_tenants_get_users_by_tenant courier.courier_tenants_get_users_by_tenant Read read
integration__courier__courier_tenants_list courier.courier_tenants_list Read read
integration__courier__courier_tenants_publish_template courier.courier_tenants_publish_template Write write
integration__courier__courier_tenants_remove_default_preferences_for_topic courier.courier_tenants_remove_default_preferences_for_topic Write write
integration__courier__courier_tenants_replace_template courier.courier_tenants_replace_template Write write
integration__courier__courier_translations_get courier.courier_translations_get Read read
integration__courier__courier_translations_update courier.courier_translations_update Write write
integration__courier__courier_users_preferences_get courier.courier_users_preferences_get Read read
integration__courier__courier_users_preferences_list courier.courier_users_preferences_list Read read
integration__courier__courier_users_preferences_update courier.courier_users_preferences_update Write write
integration__courier__courier_users_tenants_add courier.courier_users_tenants_add Write write
integration__courier__courier_users_tenants_add_multiple courier.courier_users_tenants_add_multiple Write write
integration__courier__courier_users_tenants_list courier.courier_users_tenants_list Read read
integration__courier__courier_users_tenants_remove courier.courier_users_tenants_remove Write write
integration__courier__courier_users_tenants_remove_all courier.courier_users_tenants_remove_all Write write
integration__courier__courier_users_tokens_add courier.courier_users_tokens_add Write write
integration__courier__courier_users_tokens_add_multiple courier.courier_users_tokens_add_multiple Write write
integration__courier__courier_users_tokens_delete courier.courier_users_tokens_delete Write write
integration__courier__courier_users_tokens_get courier.courier_users_tokens_get Read read
integration__courier__courier_users_tokens_list courier.courier_users_tokens_list Read read
integration__courier__courier_users_tokens_update courier.courier_users_tokens_update Write write

Write Access

Start with --write=deny for read-only MCP clients. Use --write=ask or --write=allow only when the client and workspace are trusted.