KosmoKrator

other

Netsuite MCP Integration for OpenAI Agents SDK

Connect Netsuite to OpenAI Agents SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

7 functions 6 read 1 write Manual OAuth token auth
Submit Netsuite feedback View package source

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

Netsuite MCP Config for OpenAI Agents SDK

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

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

Run the Gateway Manually

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

Why Use KosmoKrator Here

Scoped tools

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

Netsuite Tools Visible to OpenAI Agents

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

MCP toolSource functionTypeDescription
integration__netsuite__netsuite_list_customers netsuite.netsuite_list_customers Read List customers from NetSuite ERP. Returns customer records with names, IDs, and basic details. Use limit and offset for pagination.
integration__netsuite__netsuite_get_customer netsuite.netsuite_get_customer Read Get detailed information for a single NetSuite customer by internal ID. Returns full customer record including contact details, addresses, and financial information.
integration__netsuite__netsuite_create_customer netsuite.netsuite_create_customer Write Create a new customer in NetSuite ERP. Provide at minimum the company name or first/last name. Additional fields like email, phone, subsidiary, and address can be included.
integration__netsuite__netsuite_list_invoices netsuite.netsuite_list_invoices Read List invoices from NetSuite ERP. Returns invoice records with amounts, statuses, customer references, and dates. Use limit and offset for pagination.
integration__netsuite__netsuite_list_sales_orders netsuite.netsuite_list_sales_orders Read List sales orders from NetSuite ERP. Returns sales order records with order details, line items, customer references, and statuses. Use limit and offset for pagination.
integration__netsuite__netsuite_list_items netsuite.netsuite_list_items Read List items (products and services) from NetSuite ERP. Returns item records with names, IDs, types, and pricing. Use limit and offset for pagination.
integration__netsuite__netsuite_get_current_user netsuite.netsuite_get_current_user Read Get the profile of the currently authenticated NetSuite user. Returns user details like name, email, role, and subsidiary.

Related Netsuite Pages

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