Connect an MCP client
Lizzy exposes a stateless MCP Streamable HTTP server at https://lizzy.albinilabs.com/v1/mcp. Send every JSON-RPC request with POST andAuthorization: Bearer <token>. The server returnsapplication/json; it does not open an SSE stream or issue anMcp-Session-Id.
/v1/mcpSupports initialize, notifications/initialized,ping, tools/list, and tools/call with protocol versions 2025-03-26 and 2025-06-18.
Create an API token with the full_access scope athttps://lizzy.albinilabs.com/tokens. The workspace must also have Pilot enabled. Start with an lz_test_ token: its tools read and write test-mode data end to end. Use a separate lz_live_ token only when the client should act on live data.
claude mcp add --transport http lizzy https://lizzy.albinilabs.com/v1/mcp --header "Authorization: Bearer lz_test_your_token_here"
{
"mcpServers": {
"lizzy": {
"url": "https://lizzy.albinilabs.com/v1/mcp",
"headers": {
"Authorization": "Bearer lz_test_your_token_here"
}
}
}
}
curl https://api.anthropic.com/v1/messages -H "Content-Type: application/json" -H "X-Api-Key: $ANTHROPIC_API_KEY" -H "anthropic-version: 2023-06-01" -H "anthropic-beta: mcp-client-2025-11-20" --data '{
"model": "claude-opus-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Inspect my Lizzy workspace."}],
"mcp_servers": [{
"type": "url",
"url": "https://lizzy.albinilabs.com/v1/mcp",
"name": "lizzy",
"authorization_token": "lz_test_your_token_here"
}],
"tools": [{"type": "mcp_toolset", "mcp_server_name": "lizzy"}]
}'
curl --fail-with-body --silent --show-error -X POST "https://lizzy.albinilabs.com/v1/mcp" -H "Authorization: Bearer lz_test_your_token_here" -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'
curl --fail-with-body --silent --show-error -X POST "https://lizzy.albinilabs.com/v1/mcp" -H "Authorization: Bearer lz_test_your_token_here" -H "Content-Type: application/json" -H "MCP-Protocol-Version: 2025-06-18" --data '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'
Use the ten declared tools
Start workflow work with distill_workflow. Its actions start, inspect, resume, switch, or abandon one durable workflow. The six phase tools are valid only in their matching phase.
Follow the saved workflow phase
Distillation is one durable workflow with seven phases. Workflows are shared per workspace, so every MCP client and the Lizzy dashboard see the same saved workflows. Inspect and continue an existing workflow instead of recreating it in another client.
scope → data → rewards → plan → training → results → deployment
Every tool result uses the same envelope. next_actions names the tool or tools that may continue the recorded state.
{status, workflow_id, phase, summary, refs, blockers, next_actions}
Treat the token as full authority
The same policy layer as the Pilot copilot classifies every underlying write. The MCP agent still acts with the full authority of the supplied full_access API token. Connecting the token authorizes the agent to perform every action that the MCP tools expose in that token's test or live mode.
Account for service limits
mcp_calls bucket in GET /v1/rate_limits.