Letti MCP Server

Connect Claude, ChatGPT, Cursor and any other Model-Context-Protocol capable AI client to your Letivo PMS data. Read-only, RBAC-enforced.

🔑 Get your API key first.
The MCP server authenticates with the same key used by the REST API. To generate one, log in to pms.letivo.co.uk and go to Settings → API key → Rotate. The key is shown once (starts with letivo_).

Endpoint

Streamable HTTP (JSON-RPC 2.0), protocol version 2025-03-26:

POST https://mcp.letivo.co.uk/mcp
X-API-Key: letivo_...
Content-Type: application/json

Available tools (all read-only)

get_me— authenticated user + company summary
list_properties— properties in the caller's company / branch
list_tenants— tenants, with optional property filter or free-text search
list_leases— active / expired / upcoming leases
list_maintenance_tickets— repair tickets by status
get_arrears_summary— total arrears + per-tenant breakdown
list_recent_calls— Letti Voice call log for the last 30 days
search_documents— full-text search across uploaded tenancy documents

Add to Claude Desktop

Open ~/Library/Application Support/Claude/claude_desktop_config.json and add:

{
  "mcpServers": {
    "letivo": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.letivo.co.uk/mcp"],
      "env": {
        "MCP_HEADER_X_API_KEY": "letivo_YOUR_KEY_HERE"
      }
    }
  }
}

Restart Claude Desktop. You'll see a letivo connector in the tools tray.

Add to ChatGPT (custom connector)

Only available on ChatGPT Team / Enterprise / Pro plans with connector support enabled.

Settings → Connectors → Add custom connector
URL: https://mcp.letivo.co.uk/mcp
Auth: Custom header — Name X-API-Key, Value your letivo_... key
Save. Enable the connector in a new chat.

Add to Cursor

Cursor Settings → MCP tab → paste the same JSON block as Claude Desktop above.

Quick test with curl

# List available tools
curl -s https://mcp.letivo.co.uk/mcp \
  -H "X-API-Key: letivo_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# Call get_arrears_summary
curl -s https://mcp.letivo.co.uk/mcp \
  -H "X-API-Key: letivo_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"get_arrears_summary","arguments":{}}}'

Security model

Every tool call runs under the identity of the API key's owner — the same RBAC + branch scope as the REST API applies.
The MCP server is read-only. No tool mutates data.
Keys are revocable at any time from Settings → API key → Revoke. Once revoked, all connected AI clients immediately lose access.