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.

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

Related MCP server: Constructoo MCP Server

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?”

uv run pytest