KosmoKrator

productivity

Copper CRM MCP Gateway for AI Agents

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

Copper CRM MCP Gateway

Expose Copper CRM to MCP clients with `kosmokrator mcp:serve --integration=copper`.

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=copper --write=deny --json
MCP configuration 
{
  "mcpServers": {
    "kosmokrator-copper": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=copper",
        "--write=deny"
      ]
    }
  }
}
Serve manually 
kosmokrator mcp:serve --integration=copper --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__copper__copper_list_contacts copper.copper_list_contacts Read read
integration__copper__copper_get_contact copper.copper_get_contact Read read
integration__copper__copper_get_contact_by_email copper.copper_get_contact_by_email Read read
integration__copper__copper_create_contact copper.copper_create_contact Write write
integration__copper__copper_update_contact copper.copper_update_contact Write write
integration__copper__copper_delete_contact copper.copper_delete_contact Write write
integration__copper__copper_list_companies copper.copper_list_companies Read read
integration__copper__copper_get_company copper.copper_get_company Read read
integration__copper__copper_create_company copper.copper_create_company Write write
integration__copper__copper_update_company copper.copper_update_company Write write
integration__copper__copper_delete_company copper.copper_delete_company Write write
integration__copper__copper_list_opportunities copper.copper_list_opportunities Read read
integration__copper__copper_get_opportunity copper.copper_get_opportunity Read read
integration__copper__copper_create_opportunity copper.copper_create_opportunity Write write
integration__copper__copper_update_opportunity copper.copper_update_opportunity Write write
integration__copper__copper_delete_opportunity copper.copper_delete_opportunity Write write
integration__copper__copper_list_leads copper.copper_list_leads Read read
integration__copper__copper_get_lead copper.copper_get_lead Read read
integration__copper__copper_create_lead copper.copper_create_lead Write write
integration__copper__copper_update_lead copper.copper_update_lead Write write
integration__copper__copper_delete_lead copper.copper_delete_lead Write write
integration__copper__copper_list_projects copper.copper_list_projects Read read
integration__copper__copper_get_project copper.copper_get_project Read read
integration__copper__copper_create_project copper.copper_create_project Write write
integration__copper__copper_update_project copper.copper_update_project Write write
integration__copper__copper_delete_project copper.copper_delete_project Write write
integration__copper__copper_list_tasks copper.copper_list_tasks Read read
integration__copper__copper_get_task copper.copper_get_task Read read
integration__copper__copper_create_task copper.copper_create_task Write write
integration__copper__copper_update_task copper.copper_update_task Write write
integration__copper__copper_delete_task copper.copper_delete_task Write write
integration__copper__copper_list_activities copper.copper_list_activities Read read
integration__copper__copper_get_activity copper.copper_get_activity Read read
integration__copper__copper_create_activity copper.copper_create_activity Write write
integration__copper__copper_update_activity copper.copper_update_activity Write write
integration__copper__copper_delete_activity copper.copper_delete_activity Write write
integration__copper__copper_list_activity_types copper.copper_list_activity_types Read read
integration__copper__copper_get_current_user copper.copper_get_current_user Read read
integration__copper__copper_list_users copper.copper_list_users Read read
integration__copper__copper_get_user copper.copper_get_user Read read
integration__copper__copper_get_account_details copper.copper_get_account_details Read read
integration__copper__copper_list_pipelines copper.copper_list_pipelines Read read
integration__copper__copper_list_pipeline_stages copper.copper_list_pipeline_stages Read read
integration__copper__copper_list_pipeline_stages_in_pipeline copper.copper_list_pipeline_stages_in_pipeline Read read
integration__copper__copper_list_lead_statuses copper.copper_list_lead_statuses Read read
integration__copper__copper_list_customer_sources copper.copper_list_customer_sources Read read
integration__copper__copper_list_loss_reasons copper.copper_list_loss_reasons Read read
integration__copper__copper_list_contact_types copper.copper_list_contact_types Read read
integration__copper__copper_list_tags copper.copper_list_tags Read read
integration__copper__copper_list_custom_field_definitions copper.copper_list_custom_field_definitions Read read
integration__copper__copper_list_webhooks copper.copper_list_webhooks Read read
integration__copper__copper_get_webhook copper.copper_get_webhook Read read
integration__copper__copper_create_webhook copper.copper_create_webhook Write write
integration__copper__copper_update_webhook copper.copper_update_webhook Write write
integration__copper__copper_delete_webhook copper.copper_delete_webhook 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.