KosmoKrator

data

KeystoneJS MCP Integration for Claude Agent SDK

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

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

KeystoneJS MCP Config for Claude Agent SDK

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

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

Run the Gateway Manually

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

Why Use KosmoKrator Here

Scoped tools

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

KeystoneJS Tools Visible to Claude Agent SDK

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

MCP toolSource functionTypeDescription
integration__keystone__keystone_list_lists keystone.keystone_list_lists Read List all available lists (collections) in the KeystoneJS instance. Returns list keys, labels, and metadata.
integration__keystone__keystone_get_list keystone.keystone_get_list Read Get metadata and field schema for a specific KeystoneJS list. Returns field definitions, access control, and display configuration.
integration__keystone__keystone_list_items keystone.keystone_list_items Read List items in a KeystoneJS list with optional filtering, sorting, and pagination. Returns an array of items from the specified list.
integration__keystone__keystone_get_item keystone.keystone_get_item Read Retrieve a single item from a KeystoneJS list by its ID.
integration__keystone__keystone_create_item keystone.keystone_create_item Write Create a new item in a KeystoneJS list with the provided field values.
integration__keystone__keystone_list_users keystone.keystone_list_users Read List users in the KeystoneJS instance with optional filtering, sorting, and pagination.
integration__keystone__keystone_get_current_user keystone.keystone_get_current_user Read Get the profile of the currently authenticated KeystoneJS user. Useful for verifying the connection and understanding user permissions.

Related KeystoneJS Pages

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