Documentation

MCP Server

ZopNight provides a Model Context Protocol (MCP) server that lets AI assistants query your cloud infrastructure data directly. You can ask your AI tool about resources, costs, schedules, recommendations, and more — all through natural language.

What is MCP?

MCP (Model Context Protocol) is an open standard that allows AI tools to connect to external data sources. ZopNight's MCP server uses Streamable HTTP transport — your AI tool sends standard HTTP POST requests to the server. It is not SSE (Server-Sent Events) or WebSocket based.

Prerequisites

Before connecting, you need:

  • A ZopNight account with at least one organisation
  • Admin or Editor role in the organisation
  • MCP Server enabled for your organisation
  • A Personal Access Token (PAT)

Follow the How to Connect guide to enable MCP and create your token.

How It Works

  1. Your AI tool sends a POST request to the MCP server URL with your PAT token
  2. The gateway validates the token and identifies your email
  3. The AI tool calls list_organisations to discover your organisations
  4. The server checks that MCP is enabled for the requested organisation
  5. The server verifies you are a member of that organisation
  6. Results are returned as JSON to the AI tool

Protocol Details

The MCP server speaks JSON-RPC 2.0 over HTTP POST. It supports the initialize, tools/list, and tools/call methods. All responses are application/json. There is no streaming or SSE — each request gets a single JSON response.

Connect Your AI Tool

After completing the setup, connect your preferred AI tool:

What Can You Do?

The MCP server exposes 43 read-only tools covering resources, costs, schedules, recommendations, cloud accounts, teams, budgets, metrics, billing, and audit logs. See the full list in Available Tools.

Read-Only Access

Currently, all MCP tools are read-only. You cannot create, update, delete, start, or stop resources through MCP. Use the ZopNight web UI for write operations. Write support is planned for a future release.

Having issues? See the Troubleshooting guide for common problems and solutions.