KosmoKrator

data

KeystoneJS MCP Integration for OpenAI Agents SDK

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

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

KeystoneJS MCP Config for OpenAI Agents SDK

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

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

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