MCP
MCP reference
For developers: transport, sign-in, tools and limits.
Transport
- Streamable HTTP at
https://mullo.app/mcp. Stateless: JSON-RPC over POST, JSON answers, no session id. GET answers 405. - Protocol versions: 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05.
- Tools only, all marked read-only.
Authentication
- OAuth 2.1 with PKCE and dynamic client registration. The authorization server is Mullo's account service; Mullo's own page asks the person to approve.
- A request without a valid token gets
401withWWW-Authenticate: Bearer resource_metadata="https://mullo.app/.well-known/oauth-protected-resource". - Protected resource metadata (RFC 9728):
https://mullo.app/.well-known/oauth-protected-resource. - Or a personal API key as a bearer token.
Tools
| Tool | Arguments | Returns |
|---|---|---|
search | query (text), limit 1 to 25, default 10 | Matching recordings with where the words matched |
recent_recordings | days 1 to 366 (default 7), or from / to as YYYY-MM-DD; limit 1 to 100, default 30 | Recordings, newest first, with a short overview |
get_recording | id, include_transcript (default false) | Title, date, length, summary, sections, tasks, the updates added later, and the transcript when asked |
list_tasks | status open, done or all (default open); limit 1 to 200, default 50 | Tasks with due date (and time, if set) and the recording they came from |
Results come as text and, for lists, as structured content too.
Limits
- 60 requests a minute per person, shared with the API. Over it: 429.
- A recording with its transcript is cut at 120,000 characters, with a note saying so.
- Search reads the transcripts of the newest recordings; titles, summaries and tasks of all of them.
Safety
- Reads go to the database as the person, with their own token. Row-level security applies exactly as in the app.
- Tokens from connected apps can't insert, change or delete anything, and can't read audio, enforced in the database.
- The same tokens are refused on AI, billing, admin and key routes.
- Mullo's server stores no OAuth tokens.