All tools are read-only. Start with ask_spradley for open questions; the others are faster for one theme or its quotes.
| Tool | What it returns |
|---|
ask_spradley | One open question, answered and checked against your reports, with the reports it rests on and a link that opens it in Spradley Brain. Takes up to a minute. |
list_reports | Every completed report you can see, with its interview, scope and date. |
list_themes | The themes of one report, the newest by default, each with how widely it was raised. |
get_theme | One theme in depth: its summary, quotes and the codes under it. |
search_reports | Themes, codes and quotes that match a phrase. An empty result means nobody raised it. |
list_patterns | What people said, grouped, under a theme or a code. |
list_codes | The most specific level, closest to what was said. |
trace | One step up or down from any theme or code. |
compare_groups | One theme across the department reports of the same interview, beside the company. |
get_quotes | Published quotes, word for word, from one theme or matching a phrase. |
Limits
| What | Limit |
|---|
| All tools | 240 calls an hour per person |
ask_spradley | 30 questions an hour per person, because each one is a full research run |
| Privacy floor | Reports and themes held by fewer than five people are left out entirely |
Technical details
| Server URL | https://app.spradley.io/api/mcp |
| Protocol | Model Context Protocol, versions 2025-06-18, 2025-03-26 and 2024-11-05 |
| Transport | Streamable HTTP, stateless, JSON responses. One request per POST; batches are refused. |
| Auth | OAuth 2.1 with dynamic client registration and PKCE. Consent is asked every time. |
| Server name | spradley-research, version 1.0.0 |
