mcp-servicenex-v2

A Model Context Protocol (MCP) server for the ServiceNEX REST API. It exposes tickets, knowledge articles, services, users, and MCP resources to AI clients such as Claude Desktop.

Install

Requires Python 3.10+.

pip install mcp-servicenex-v2

Set credentials, then start the stdio server:

export SERVICENEX_API_BASE="https://your-tenant.servicenex.io"
export SERVICENEX_API_KEY="your-api-key"
mcp-servicenex-v2

Or with uvx (no global install):

uvx mcp-servicenex-v2

You can also run the module directly:

python -m mcp_servicenex_v2

Copy .env.example to .env for local development. Host environment variables still take precedence.

Claude Desktop

{
  "mcpServers": {
    "servicenex": {
      "command": "uvx",
      "args": ["mcp-servicenex-v2"],
      "env": {
        "SERVICENEX_API_BASE": "https://your-tenant.servicenex.io",
        "SERVICENEX_API_KEY": "your-api-key"
      }
    }
  }
}

If installed with pip, use "command": "mcp-servicenex-v2" and omit args.

Environment

Publish

Tokens are read from the repo-root .env (never committed). Copy the publish keys from .env.example if they are missing.

./scripts/package.sh
./scripts/publish.sh testpypi
./scripts/publish.sh pypi

publish.sh pypi asks you to type the package name unless you pass --yes. Build tools are installed into .venv-build/ so the runtime .venv is unchanged.

License

MIT