MCP NetSuite Practice

Python MCP server that exposes read-only NetSuite tools for agents such as Claude Desktop or Claude Code. It lets an LLM query warehouse stock and order status without putting API keys in the client.

Tool	Arguments	Description
get_stock_level	sku: str	Available units for a SKU in warehouse
get_order_status	order_id: str	Current status of an order

NetSuite access goes through a stable client interface. Local development uses a mock with sample data (A-SAFE barriers); the same interface can later target a real sandbox via environment variables.

Product specification: project.md.

Stack

• Python 3.12+
• uv
• Official mcp SDK (stdio transport; HTTP/SSE planned)
• Pydantic for request/response schemas
• FastAPI + Docker / K8s / Terraform for remote deployment
• Langfuse / Sentry and an audit trail for observability

Architecture

flowchart TD
    Agent[Agent: Claude Desktop / Claude Code]
    MCP[MCP Server]
    Tools[Tools: get_stock_level / get_order_status]
    Schemas[Pydantic schemas]
    Client[NetSuite client interface]
    Mock[Mock data]
    Sandbox[NetSuite sandbox]

    Agent -->|MCP stdio or HTTP/SSE| MCP
    MCP --> Tools
    MCP --> Schemas
    Tools --> Client
    Client --> Mock
    Client -.-> Sandbox

The MCP server exposes typed tools to the agent. Tools call a NetSuite client interface so the protocol layer stays decoupled from the ERP. Locally the client uses mock data; the same interface can target a real sandbox later.

How to use

Requirements: Python 3.12+, uv.

uv sync
uv run python -m mcp_netsuite_practice

The process speaks MCP over stdin/stdout. An MCP host consumes it (it is not a plain HTTP API).

Claude Desktop — add to claude_desktop_config.json (adjust --directory):

{
  "mcpServers": {
    "netsuite-practice": {
      "command": "uv",
      "args": [
        "--directory",
        "C:/Users/antonio/Desktop/MCP-netsuite-practice",
        "run",
        "python",
        "-m",
        "mcp_netsuite_practice"
      ]
    }
  }
}

Example prompts:

• “How much stock do we have for SKU ASAFE-BARRIER-01?”
• “What is the status of order SO-10042?”

Variable	Purpose
NETSUITE_MODE	mock (default) or sandbox once a real client exists
NETSUITE_*	Sandbox credentials (local .env only; never commit)

uv run pytest