Skip to main content
Glama
site24x7-code-mode-mcp

site24x7-code-mode-mcp

by jmpijll

CI

Two tools, one API

This Model Context Protocol server exposes site24x7_search and site24x7_execute. The agent searches the API reference, then runs JavaScript inside a QuickJS WASM sandbox. API calls go through the host; credentials remain outside the sandbox.

  • Use one namespace. site24x7.* covers monitoring and account operations.

  • Refresh OAuth automatically. Credentials and the in-memory access-token cache stay on the host.

  • Scope customer calls. withCustomer(zaaid, fn) selects an MSP customer or Business Unit and restores the previous scope.

  • Search offline. The bundled specification is generated from the API documentation.

Related MCP server: Datadog MCP Server

Get started

Install from source and point your MCP client at the built dist/index.js.

Requirements

  • Node.js 22.19.0 or newer and npm. CI checks Node 22 and 24.

  • Zoho Self Client credentials and a refresh token for your Site24x7 data center.

Build from source

git clone https://github.com/jmpijll/site24x7-code-mode-mcp.git
cd site24x7-code-mode-mcp
npm ci
cp .env.example .env
# Edit .env: SITE24X7_CLIENT_ID, SITE24X7_CLIENT_SECRET, SITE24X7_REFRESH_TOKEN and SITE24X7_ZONE.
npm run build
npm start

The shell examples use Bash. In PowerShell, use Copy-Item .env.example .env and set variables with $env:NAME = 'value'.

Configure your MCP client with node /absolute/path/to/site24x7-code-mode-mcp/dist/index.js. Use an absolute path and supply credentials through the client's environment configuration when its working directory does not contain your .env file. See the client setup and usage guide.

For hosted use, set MCP_TRANSPORT=http and follow the per-request credential contract. Docker instructions are in docker-compose.yml.

Example session

After discovering the operation with the search tool, use the execute tool:

site24x7.request({ method: 'GET', path: '/api/current_status' });

See the usage guide for search recipes, configuration and additional call shapes.

Know the boundaries

Area

Current boundary

API reference

Bundled snapshot scraped from documentation; no live OpenAPI endpoint.

Live coverage

Real-tenant, MSP/BU, client and mutation verification remain pending.

Workers

Scaffold; the MCP transport adapter returns 501.

Sandbox

Resource limits bound each invocation; allowed API calls still act with the supplied account's permissions.

Verification status

Mocked unit/integration coverage and MCP Inspector CLI smoke are recorded. Real-tenant and LLM-client verification remain pending. See the setup and verification reference for the detailed historical evidence and remaining work. New verification reports should identify the server revision, client, upstream version and operations actually exercised.

Project status

Public beta · v0.1.0-beta.1. Install from source; the package remains private and is not published to npm.

Privacy

The host sends API requests to the service configured for this server. Tool results and captured sandbox logs are returned to your MCP client; that client may send them to its configured model provider. Spec caches may be written locally.

Keep .env files and credentials private. Redact account identifiers, IP addresses and service data before sharing logs or verification reports. See SECURITY.md for vulnerability reporting.

Development and contribution

npm run check

check runs lint, formatting, typecheck, mocked tests and the build. It also verifies the built MCP server version and its two tools without tenant credentials or upstream network access. npm run cf:check validates the Worker bundle without deploying it. See CONTRIBUTING.md for the repository layout and contribution checks, and AGENTS.md for architectural invariants. Live API tests require separate credentials and verification scope.

Documentation

License and acknowledgements

MIT. Built with TypeScript, the MCP SDK and QuickJS, following the Cloudflare Code Mode pattern.

Available Tools

2 tools
site24x7_executeExecute Site24x7 API callsA

Run Site24x7 API calls by writing JavaScript that uses the site24x7 namespace.

Surface:

  • site24x7.<tag>.<operationId>(args) — typed call. Args are auto-routed: keys matching path or query params from the spec are placed correctly; remaining keys form the JSON body for POST/PUT/PATCH. Override with { pathParams: {...}, query: {...}, body: {...}, version: '2.1', zaaid: '...' }.

  • site24x7.callOperation(operationId, args) — flat lookup by id.

  • site24x7.request({ method, path, query?, body?, version?, zaaid? }) — raw HTTP escape hatch (e.g. for endpoints not yet in the spec).

  • site24x7.spec — { title, sourceUrl, generatedAt, operationCount } for diagnostics.

  • site24x7.listCustomers() — MSP/BU customer enumeration (uses /api/short/msp/customers or /api/short/bu/business_units based on accountType).

  • site24x7.withCustomer(zaaid, async fn) — run fn(site24x7) with the closure scoped to a customer. Restores the previous zaaid on exit, even on throw. Must be awaited.

  • site24x7.zaaid — the currently active zaaid (or undefined).

Operations are async — use await. Top-level await is not supported; wrap in an async IIFE:

(async () => {
  const status = await site24x7.request({ method: 'GET', path: '/api/current_status' });
  return status;
})()

MSP recipe (fan out over customers)

(async () => {
  const customers = await site24x7.listCustomers();
  const out = [];
  for (const c of customers) {
    const status = await site24x7.withCustomer(c.zaaid, async (s) => {
      return s.request({ method: 'GET', path: '/api/current_status' });
    });
    out.push({ name: c.name, zaaid: c.zaaid, down: status?.monitors_status?.down ?? 0 });
  }
  return out;
})()

Errors

Errors are prefixed with a structured tag:

  • [site24x7.HttpError] HTTP 403 GET /api/users (operation requires scope(s) \Site24x7.Admin.Read` — confirm your refresh token grants them)`

  • [site24x7.MissingZaaidError] operation "..." requires a zaaid in scope (operation mspOnly=true). Hint: call site24x7.listCustomers() and wrap the call in site24x7.withCustomer(zaaid, ...).

  • [site24x7.MissingCredentialsError] ... when no Zoho OAuth credentials are configured

  • [site24x7.UnknownOperationError] ... when the operationId doesn't exist in the spec

Limits

  • Per-execute API call ceiling (default 50, configurable via SITE24X7_MAX_CALLS_PER_EXECUTE).

  • Sandbox memory + 30 s deadline.

  • Credentials never enter the sandbox.

  • Site24x7 enforces its own per-token rate limit (~10 req/s on most plans). 429 triggers one polite retry.

Inputs: code (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have clearly distinct purposes: one for discovering API operations via read-only search, and one for executing API calls. There is no functional overlap.

    Naming Consistency5/5

    Both tools follow a consistent 'site24x7_verb' pattern with snake_case, making them predictable and easy to parse.

    Tool Count2/5

    Two tools are too few for a full API surface; the design essentially reduces the interface to a generic code execution sandbox. This feels thin even if intended as a flexible escape hatch.

    Completeness1/5

    The tool set provides no specific CRUD or lifecycle operations; it relies entirely on writing custom code. This is severely incomplete for the stated scope of a Site24x7 API wrapper.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      A
      maintenance
      A Model Context Protocol server that enables natural language querying of Kaseya's Autotask PSA data through AI assistants, supporting contract analysis, ticket tracking, agent activities, and project status monitoring.
      98
      91 npm
      63
      Apache 2.0
    • A
      license
      B
      quality
      Not graded
      maintenance
      A Model Context Protocol server that enables AI assistants to interact with Datadog's observability platform through natural language.
      72
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that integrates AI assistants with Zoho CRM, enabling contact and deal management operations through natural language.
      3
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      A secure Model Context Protocol server that allows AI assistants and LLM applications to safely execute Python and JavaScript code snippets in containerized environments.
      2
      206
      MIT