Can I use Courier as a CLI?

Yes. KosmoKrator exposes a Courier CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Courier through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Courier tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Courier credentials stored?

Courier credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Courier MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

productivity

Courier MCP, CLI, and Lua Integration for AI Agents

Courier integration docs for AI agents: MCP gateway setup, Courier CLI commands, Lua API reference, credentials, and function schemas.

Courier for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Agent Surfaces

Courier CLIHeadless setup, JSON output, direct function calls. Courier MCPExpose selected tools to local MCP clients. Courier LuaAgent-facing namespace and Lua reference. FeedbackReport missing tools, auth issues, or bad metadata.

Machine-Readable Metadata

integration_slug: courier
route_slug: courier
package: courier
auth_strategy: api_key
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true

Function Catalog

Function	Type	Description
`courier.courier_audiences_delete`	Write `write`	Deletes the specified audience.
`courier.courier_audiences_get`	Read `read`	Returns the specified audience by id.
`courier.courier_audiences_list_audiences`	Read `read`	Get the audiences associated with the authorization token.
`courier.courier_audiences_list_members`	Read `read`	Get list of members of an audience.
`courier.courier_audiences_update`	Write `write`	Creates or updates audience.
`courier.courier_audit_events_get`	Read `read`	Fetch a specific audit event by ID.
`courier.courier_audit_events_list`	Read `read`	Fetch the list of audit events.
`courier.courier_auth_tokens_issue_token`	Write `write`	Returns a new access token.
`courier.courier_automations_invoke_ad_hoc_automation`	Write `write`	Invoke an ad hoc automation run.
`courier.courier_automations_invoke_automation_template`	Write `write`	Invoke an automation run from an automation template.
`courier.courier_automations_list`	Read `read`	Get the list of automations.
`courier.courier_brands_create`	Write `write`	Create a new brand.
`courier.courier_brands_delete`	Write `write`	Delete a brand by brand ID.
`courier.courier_brands_get`	Read `read`	Fetch a specific brand by brand ID.
`courier.courier_brands_list`	Read `read`	Get the list of brands.
`courier.courier_brands_replace`	Write `write`	Replace an existing brand with the supplied values.
`courier.courier_bulk_create_job`	Write `write`	Creates a new bulk job for sending messages to multiple recipients.
`courier.courier_bulk_get_job`	Read `read`	Get a bulk job.
`courier.courier_bulk_get_users`	Read `read`	Get Bulk Job Users.
`courier.courier_bulk_ingest_users`	Write `write`	Ingest user data into a Bulk Job.
`courier.courier_bulk_run_job`	Write `write`	Run a bulk job.
`courier.courier_inbound_track`	Write `write`	Courier Track Event.
`courier.courier_journeys_invoke`	Write `write`	Invoke a journey run from a journey template.
`courier.courier_journeys_list`	Read `read`	Get the list of journeys.
`courier.courier_lists_add_subscribers`	Write `write`	Subscribes additional users to the list, without modifying existing subscriptions.
`courier.courier_lists_delete`	Write `write`	Delete a list by list ID.
`courier.courier_lists_get`	Read `read`	Returns a list based on the list ID provided.
`courier.courier_lists_get_subscribers`	Read `read`	Get the list's subscriptions.
`courier.courier_lists_list`	Read `read`	Returns all of the lists, with the ability to filter based on a pattern.
`courier.courier_lists_restore`	Write `write`	Restore a previously deleted list.
`courier.courier_lists_subscribe`	Write `write`	Subscribe a user to an existing list (note: if the List does not exist, it will be automatically created).
`courier.courier_lists_unsubscribe`	Write `write`	Delete a subscription to a list by list ID and user ID.
`courier.courier_lists_update`	Write `write`	Create or replace an existing list with the supplied values.
`courier.courier_lists_update_subscribers`	Write `write`	Subscribes the users to the list, overwriting existing subscriptions.
`courier.courier_messages_archive`	Write `write`	Archive message.
`courier.courier_messages_cancel`	Write `write`	Cancel a message that is currently in the process of being delivered.
`courier.courier_messages_get`	Read `read`	Fetch the status of a message you've previously sent.
`courier.courier_messages_get_content`	Read `read`	Get message content.
`courier.courier_messages_get_history`	Read `read`	Fetch the array of events of a message you've previously sent.
`courier.courier_messages_list`	Read `read`	Fetch the statuses of messages you've previously sent.
`courier.courier_notifications_archive`	Write `write`	Archive a notification template.
`courier.courier_notifications_create`	Write `write`	Create a notification template.
`courier.courier_notifications_list`	Read `read`	List notification templates in your workspace.
`courier.courier_notifications_list_versions`	Read `read`	List versions of a notification template.
`courier.courier_notifications_publish`	Write `write`	Publish a notification template.
`courier.courier_notifications_replace`	Write `write`	Replace a notification template.
`courier.courier_notifications_retrieve`	Read `read`	Retrieve a notification template by ID.
`courier.courier_profiles_create`	Write `write`	Merge the supplied values with an existing profile or create a new profile if one doesn't already exist.
`courier.courier_profiles_delete`	Write `write`	Deletes the specified user profile.
`courier.courier_profiles_delete_list_subscription`	Write `write`	Removes all list subscriptions for given user.
`courier.courier_profiles_get`	Read `read`	Returns the specified user profile.
`courier.courier_profiles_get_list_subscriptions`	Read `read`	Returns the subscribed lists for a specified user.
`courier.courier_profiles_merge_profile`	Write `write`	Update a profile.
`courier.courier_profiles_replace`	Write `write`	When using PUT, be sure to include all the key-value pairs required by the recipient's profile.
`courier.courier_profiles_subscribe_to_list`	Write `write`	Subscribes the given user to one or more lists.
`courier.courier_routing_strategies_archive`	Write `write`	Archive a routing strategy.
`courier.courier_routing_strategies_create`	Write `write`	Create a routing strategy.
`courier.courier_routing_strategies_list`	Read `read`	List routing strategies in your workspace.
`courier.courier_routing_strategies_replace`	Write `write`	Replace a routing strategy.
`courier.courier_routing_strategies_retrieve`	Read `read`	Retrieve a routing strategy by ID.
`courier.courier_send`	Write `write`	Send a message to one or more recipients.
`courier.courier_tenants_create_or_replace`	Write `write`	Create or Replace a Tenant.
`courier.courier_tenants_create_or_replace_default_preferences_for_topic`	Write `write`	Create or Replace Default Preferences For Topic.
`courier.courier_tenants_delete`	Write `write`	Delete a Tenant.
`courier.courier_tenants_get`	Read `read`	Get a Tenant.
`courier.courier_tenants_get_template_by_tenant`	Read `read`	Get a Template in Tenant.
`courier.courier_tenants_get_template_list_by_tenant`	Read `read`	List Templates in Tenant.
`courier.courier_tenants_get_template_version`	Read `read`	Fetches a specific version of a tenant template.
`courier.courier_tenants_get_users_by_tenant`	Read `read`	Get Users in Tenant.
`courier.courier_tenants_list`	Read `read`	Get a List of Tenants.
`courier.courier_tenants_publish_template`	Write `write`	Publishes a specific version of a notification template for a tenant.
`courier.courier_tenants_remove_default_preferences_for_topic`	Write `write`	Remove Default Preferences For Topic.
`courier.courier_tenants_replace_template`	Write `write`	Creates or updates a notification template for a tenant.
`courier.courier_translations_get`	Read `read`	Get translations by locale.
`courier.courier_translations_update`	Write `write`	Update a translation.
`courier.courier_users_preferences_get`	Read `read`	Fetch user preferences for a specific subscription topic.
`courier.courier_users_preferences_list`	Read `read`	Fetch all user preferences.
`courier.courier_users_preferences_update`	Write `write`	Update or Create user preferences for a specific subscription topic.
`courier.courier_users_tenants_add`	Write `write`	This endpoint is used to add a single tenant.
`courier.courier_users_tenants_add_multiple`	Write `write`	This endpoint is used to add a user to multiple tenants in one call.
`courier.courier_users_tenants_list`	Read `read`	Returns a paginated list of user tenant associations.
`courier.courier_users_tenants_remove`	Write `write`	Removes a user from the supplied tenant.
`courier.courier_users_tenants_remove_all`	Write `write`	Removes a user from any tenants they may have been associated with.
`courier.courier_users_tokens_add`	Write `write`	Adds a single token to a user and overwrites a matching existing token.
`courier.courier_users_tokens_add_multiple`	Write `write`	Adds multiple tokens to a user and overwrites matching existing tokens.
`courier.courier_users_tokens_delete`	Write `write`	Delete User Token.
`courier.courier_users_tokens_get`	Read `read`	Get single token available for a :token.
`courier.courier_users_tokens_list`	Read `read`	Gets all tokens available for a :user_id.
`courier.courier_users_tokens_update`	Write `write`	Apply a JSON Patch (RFC 6902) to the specified token.