MCP / AI Agents

New

VMaintain exposes a Model Context Protocol (MCP) server so that Claude, ChatGPT, Cursor, and any compatible AI agent can read and act on your workspace data as native tools.

MCP endpoint

PathDescription
POST /mcpMCP JSON-RPC endpoint (StreamableHTTP transport)
GET /mcp/toolsTool manifest listing available tools and their schemas
GET /mcp/schemaJSON Schema for all tool inputs

Connect from Claude Desktop

Add VMaintain as an MCP server in your claude_desktop_config.json:

{
"mcpServers": {
"vmaintain": {
"url": "https://your-domain.com/mcp",
"transport": "streamable-http",
"headers": {
"Authorization": "Bearer <your-api-token>"
}
}
}
}

Connect from Cursor or VS Code

// .cursor/mcp.json (or .vscode/mcp.json)
{
"servers": {
"vmaintain": {
"url": "https://your-domain.com/mcp",
"headers": { "Authorization": "Bearer <token>" }
}
}
}

Available tools

list_tickets

Fetch open tickets in a workspace, optionally filtered by status, assignee, or client.

get_ticket

Get full details for a single ticket by ID.

create_ticket

Open a new support ticket with subject, priority, assignee, and due date.

update_ticket

Change ticket status, priority, assignee, or other fields.

list_sites

List WordPress sites in a workspace with their health status.

get_site

Get site details including plugin versions, uptime, and last check.

list_monitors

List uptime monitors and their current status.

list_clients

List client accounts in a workspace.

list_tasks

List tasks with optional filters for status and assignee.

Authentication

The MCP server validates the same Bearer tokens as the REST API. Obtain a token from POST /api/v1/auth/login and pass it as the Authorization header. All tool calls are scoped to the authenticated user's workspaces.