OverviewIntroduction
Overview

MCP Platform

Manage MCP servers, tools, API keys, and access control for the Mythic Analytics Model Context Protocol platform.

Overview

The MCP Platform API enables you to register and manage Model Context Protocol servers, discover and configure tools, control client-level access, and manage API keys for gateway authentication. The MCP gateway provides a JSON-RPC 2.0 interface for tool execution.

Base URL

All REST endpoints share the same base URL and version prefix.

https://api.mythic-analytics.com/api/v1

The MCP gateway uses a separate endpoint for JSON-RPC requests:

https://mcp-gateway.mythic-analytics.com/rpc

Response envelope

All REST endpoints return a JSON envelope.

successboolean
Required

Whether the request succeeded.

dataobject|array|null

Resource payload. Shape depends on the endpoint.

countinteger

Total number of matching resources. Present on list endpoints.

errorstring|null

Error message on failed requests.

Key concepts

ConceptDescription
MCP ServerA registered server that exposes tools via the Model Context Protocol
ToolA capability discovered on an MCP server, callable via the gateway
Access ControlPer-client, per-server, and per-tool permission rules
API KeyAuthentication credential for the MCP gateway
GatewayJSON-RPC 2.0 endpoint for executing tool calls

Error handling

StatusMeaning
400Invalid JSON, missing required fields, or validation error
401Admin key or API key missing or invalid
404Resource not found
409Conflict — duplicate server name
502Upstream MCP server unreachable
500Internal server error

Check both the HTTP status code and the error field in the response body for programmatic error handling.