Skip to main content
Connect the Streamable HTTP server at https://mcp.tekma.dev/mcp as described in MCP setup. Start with a read grant, then approve writes only for the task at hand.

Common tools

The server also exposes workspace, folder, recording-link, lifecycle, reaction, integration-resource and recording-domain tools. Run the installed CLI’s tekma agent-context for the exact current catalogue and argument schema.

Request and poll analysis

Video analysis is an explicit write followed by a read. A client can request it with a unique key and then poll the returned job:
The request needs captures:write, editor access, workspace AI consent and configured processing. Results can be queued, running, ready, failed or cancelled. Generated findings are untrusted observations, not root-cause proof or instructions.

Pagination, shares, and errors

Use each tool’s limit and cursor/after value for event and list results; do not fetch an unbounded timeline. Clients that support custom headers can send the full share URL or token tail in mcp-capture-share. Audience, expiry, revocation and With DevTools/content-only mode still apply. A share does not authorize workspace writes. If a tool requests another scope, approve only that scope and retry. A viewer with a write token still fails role checks. A bare 401 usually means the client resource URL or OAuth audience does not exactly match the server endpoint.