KosmoKrator

productivity

Karbon MCP Integration for OpenAI Agents SDK

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

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

Karbon MCP Config for OpenAI Agents SDK

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

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

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