KosmoKrator

productivity

Karbon MCP Integration for Claude Agent SDK

Connect Karbon 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 Karbon feedback View package source

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

Karbon MCP Config for Claude Agent SDK

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

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

Run the Gateway Manually

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

Why Use KosmoKrator Here

Scoped tools

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

Karbon Tools Visible to Claude Agent SDK

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

MCP toolSource functionTypeDescription
integration__karbon__karbon_list_contacts karbon.karbon_list_contacts Read List contacts in Karbon. Returns a paginated list of contacts with their names, emails, companies, and other details.
integration__karbon__karbon_get_contact karbon.karbon_get_contact Read Get a single contact from Karbon by its unique identifier. Returns full contact details including name, email, phone, company, and any associated notes.
integration__karbon__karbon_create_contact karbon.karbon_create_contact Write Create a new contact in Karbon. Provide at least a first name and last name. Optionally include email, company, and phone number.
integration__karbon__karbon_list_work_items karbon.karbon_list_work_items Read List work items in Karbon. Returns a paginated list of work items. Optionally filter by status (e.g., "Open", "InProgress", "Completed") or by assignee.
integration__karbon__karbon_get_work_item karbon.karbon_get_work_item Read Get a single work item from Karbon by its unique identifier. Returns full details including title, description, status, assignee, due date, and any associated notes.
integration__karbon__karbon_list_users karbon.karbon_list_users Read List users in the Karbon account. Returns user details including names, emails, and roles. Use this to find assignees for work items.
integration__karbon__karbon_get_current_user karbon.karbon_get_current_user Read Get the currently authenticated Karbon user. Returns the profile of the user whose access token is configured for this integration.

Related Karbon Pages

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