Let AI agents start video calls and verify webhooks via the Model Context Protocol.
The Model Context Protocol lets AI assistants (Claude Desktop, Cursor, Continue, etc.) call external services in a standardized way. This server exposes the LIQAA Public API as MCP tools, so an agent can:
"Set up a video call between alice@example.com and bob@example.com for 3pm tomorrow."
…and the agent will actually create the room, return the join URLs, and (if you wired webhooks) wait for call.started events.
| Tool | Description |
|---|---|
liqaa_create_room |
Create or reuse a persistent room between two users. |
liqaa_get_room |
Look up the state of a room by external_conversation_id. |
liqaa_end_room |
End an active call. |
liqaa_issue_sdk_token |
Issue a 1-hour browser-safe JWT for a given identity. |
liqaa_list_webhooks |
Inspect your webhook subscriptions. |
liqaa_create_webhook |
Subscribe to events (returns one-time signing secret). |
| URI | Returns |
|---|---|
liqaa://docs/quickstart |
Quickstart guide as markdown. |
liqaa://docs/api |
OpenAPI 3.1 spec (live). |
liqaa://docs/security |
Security policy. |
liqaa://status |
Live status of LIQAA Cloud (uptime, latency). |
Add to your ~/.config/claude/claude_desktop_config.json:
{
"mcpServers": {
"liqaa": {
"command": "npx",
"args": ["-y", "@liqaa/mcp"],
"env": {
"LIQAA_PK": "pk_live_…",
"LIQAA_SK": "sk_live_…"
}
}
}
}Settings → MCP → Add new server:
{
"name": "liqaa",
"command": "npx -y @liqaa/mcp",
"env": { "LIQAA_PK": "...", "LIQAA_SK": "..." }
}npx @liqaa/mcp
# or
npm install -g @liqaa/mcp && liqaa-mcpOnce connected, just ask in natural language:
- "Start a video meeting with sarah@acme.com about ticket-1284."
- "What's our LIQAA uptime over the last 30 days?"
- "Subscribe https://my-app.com/hooks/liqaa to call.started and call.ended events."
- "End the active call with the room name room-abc123."
MCP (stdio/JSON-RPC) HTTPS+JWT
AI agent liqaa-mcp LIQAA API
(Claude…) server
The agent invokes a tool → MCP server translates to a REST call → response flows back as structured content.
The MCP server is run locally by the host (Claude Desktop, Cursor). Your sk_live_* never leaves your machine. The server refuses tools that would leak the secret key.
MIT © TKAWEN — LIQAA Cloud.