KosmoKrator

other

Attio MCP Integration for OpenAI Agents SDK

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

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

Attio MCP Config for OpenAI Agents SDK

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

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

Run the Gateway Manually

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

Why Use KosmoKrator Here

Scoped tools

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

Attio Tools Visible to OpenAI Agents

OpenAI Agents sees stable MCP tool names generated from the Attio integration catalog.

MCP toolSource functionTypeDescription
integration__attio__attio_list_records attio.attio_list_records Read List records for an object type in Attio (e.g. people, companies, deals). Supports filtering, sorting, and pagination via a POST query endpoint. Use filters to narrow results by attribute values and sorts to control ordering.
integration__attio__attio_get_record attio.attio_get_record Read Get a single record from Attio by its object type and record ID. Returns full record details including all attribute values.
integration__attio__attio_create_record attio.attio_create_record Write Create a new record in Attio for a given object type. Pass attribute values keyed by their attribute slug in the data parameter.
integration__attio__attio_list_objects attio.attio_list_objects Read List all object types defined in the Attio workspace (e.g. people, companies, deals, custom objects). Useful for discovering available objects before querying records.
integration__attio__attio_get_object attio.attio_get_object Read Get details for a specific object type in Attio, including its attributes and their types. Useful for understanding what fields are available before creating or updating records.
integration__attio__attio_list_workspaces attio.attio_list_workspaces Read List all Attio workspaces accessible to the authenticated user. Returns workspace IDs and names useful for understanding the context of the current integration.
integration__attio__attio_get_current_user attio.attio_get_current_user Read Get the currently authenticated Attio user profile. Useful for verifying API connectivity and identifying which workspace the integration is connected to.

Related Attio Pages

Attio CLIUse direct JSON commands instead of MCP discovery. Attio MCPFull gateway reference and MCP tool names. KosmoKrator for OpenAI AgentsClient-level gateway setup.