KosmoKrator

other

Netsuite MCP Integration for Claude Agent SDK

Connect Netsuite to Claude Agent 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 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.

Netsuite MCP Config for Claude Agent SDK

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

{
  "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 Claude Agent SDK

Claude Agent SDK 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 Claude Agent SDKClient-level gateway setup.