MCP server

Connect an AI assistant or your own code to your workspace through the Model Context Protocol with a scoped token.

One endpoint, POST /api/mcp on https://backoffice.noxtica.com (production), authenticated with an MCP token (Authorization: Bearer mcp_...) created under Integrations & API, MCP tokens. The token’s scopes decide which tools it can call; call tools/list for the current catalogue.

Credential: McpTokenAuth. See Authentication.

Send one MCP JSON-RPC request

POST /api/mcp

Sends one JSON-RPC 2.0 request and returns one JSON-RPC 2.0 response. Set Content-Type: application/json. Notifications and batches are not supported: send one request object with a method and, for calls that expect an answer, an id.

The HTTP status is 200 for every JSON-RPC outcome, including errors, except for the transport failures 401, 404, 429 and 500.

Authentication: Bearer token (McpTokenAuth).

Request body

Content type application/json, required.

Responses

Response headers

Response fields (200, application/json)

Response example (200)

{
  "jsonrpc": "2.0",
  "id": null,
  "error": {
    "code": -32700,
    "message": "Parse error"
  }
}

Example request

curl

curl -X POST "https://backoffice.noxtica.com/api/mcp" \
  -H "Authorization: Bearer $NOXTICA_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "list_alerts",
    "arguments": {
      "limit": 25
    }
  }
}'

Node.js (global fetch, Node 18 or later)

const response = await fetch('https://backoffice.noxtica.com/api/mcp', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.NOXTICA_MCP_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 2,
    method: 'tools/call',
    params: {
      name: 'list_alerts',
      arguments: {
        limit: 25,
      },
    },
  }),
});
console.log(response.status, await response.text());

Python (standard library)

import json
import os
import urllib.request

request = urllib.request.Request(
    "https://backoffice.noxtica.com/api/mcp",
    data=json.dumps({
        "jsonrpc": "2.0",
        "id": 2,
        "method": "tools/call",
        "params": {
            "name": "list_alerts",
            "arguments": {
                "limit": 25,
            },
        },
    }).encode(),
    headers={
        "Authorization": f"Bearer {os.environ['NOXTICA_MCP_TOKEN']}",
        "Content-Type": "application/json",
    },
    method="POST",
)
with urllib.request.urlopen(request) as response:
    print(response.status, response.read().decode())

This page is generated from the Noxtica OpenAPI specification release v0.4.0: mcp.yaml version 0.1.0-2026-10-27 (SHA-256 1a4875efa736). Do not edit it by hand.