KosmoKrator

productivity

Karbon MCP Integration for Vercel AI SDK

Connect Karbon to Vercel AI 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 Vercel AI SDK

Use KosmoKrator as a local integration gateway for Vercel AI SDK agents and scripts.

Create an MCP client that starts or connects to the KosmoKrator gateway for the selected integration. The gateway is local, scoped to this integration, and starts with --write=deny so Vercel AI SDK can inspect read-capable tools without receiving write access by default.

Karbon MCP Config for Vercel AI SDK

Prefer CLI JSON calls when a workflow only needs one deterministic integration operation.

{
  "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 Vercel AI SDK

Vercel AI 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 Vercel AI SDKClient-level gateway setup.