METODIC
by metodic.io · remote · no sign-in to list tools · v1.0.0 · published by io.metodic
Design workshops from chat: 750+ facilitation methods, timed agendas, worksheets, slide decks.
20 tools: 1 can delete or cancel things, 11 change things and 8 only read.
Scanned Oct 21, 2026
- Deletes or cancels1Claude Code: deny: see these tools
- Can't be undone0Claude Code: ask
- Changes things11Claude Code: ask: see these tools
- Only reads8Claude Code: allow: see these tools
1 check matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.
claude mcp add --transport http metodic https://www.metodic.io/mcpFindings
Matches of fixed checks, with the text they matched.
The server marks "find_session_format" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "find_session_format" says "find": a word for reading.
Tools
Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.
20 tools
Deletes or cancels 1Claude Code: deny
refine_sessionModify an existing session's agenda IN PLACE without leaving the chat: retime, rename, move, remove or update activities, or add new ones.No findings
Why it is in this group
- The description's first verb is "modify": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Modify an existing session's agenda IN PLACE without leaving the chat: retime, rename, move, remove or update activities, or add new ones. Put EVERY change the user asked for in ONE call — a second call paints a second full session brief and the user sees the agenda twice. Give a list of operations; they apply in order, and activity numbers are 1-based positions in the agenda AS IT STANDS after any earlier operations in the same call. Start/end times are recomputed automatically and newly added activities get full step-by-step method details. Returns the updated, branded session brief in full, shown right in the chat — so a change looks the same as the original design. Prefer this over sending the user to Metodic for an edit. This edits the same session Metodic Studio shows.
Annotations the server declares
- title: Refine session agenda
- readOnlyHint: false
- destructiveHint: true
- idempotentHint: false
- openWorldHint: false
Changes things 11Claude Code: ask
add_debriefSave a post-session DEBRIEF onto the session in Metodic: how it went, what worked, what to improve, follow-ups.No findings
Why it is in this group
- The name "add_debrief" says "add": a word for a change.
Description, as the server wrote it Save a post-session DEBRIEF onto the session in Metodic: how it went, what worked, what to improve, follow-ups. Call after the user has run their workshop and tells you how it went (or after a debrief conversation) — synthesize first, then save. Debriefs accumulate on the session; nothing is overwritten.
Annotations the server declares
- title: Save session debrief
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: false
answer_from_libraryThe answer format for anything the user could pick up and use.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it The answer format for anything the user could pick up and use. ALWAYS use this — not generate_document, not prose, not a web search — for a question about WHAT TO USE OR READ — 'which energizer for a flat afternoon group', 'what learning formats could I run this session as', 'which framework fits a two-day programme', 'give me a case for this topic'. MATCH THE TOOL TO WHAT WAS ASKED. Asked which SESSIONS, programmes, formats or examples of sessions ('what could I run for an offsite with 30 people', 'show me examples of sessions like this') → find_session_format, and put the results in the formats field, plus list_my_sessions in my_sessions when they mean their own. Asked which ACTIVITY or working form → search_methods, into methods. Asked which METHODOLOGY → list_frameworks, into framework. Reading → search_articles, into reading. Answering a question about sessions with a list of methods is the wrong answer to the question. First call the matching lookup to see what exists, then call THIS with the few you picked and, for each, WHY it fits this user's situation. Metodic resolves every slug against the real library and renders one branded answer card; anything that does not exist is silently left out. Do not answer such questions in prose and do not dump a search result — a chosen shortlist with reasoning is the whole point. Free.
Annotations the server declares
- title: Answer from the Metodic library
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
design_sessionTurn the conversation into a REAL session in the user's Metodic account: a timed agenda built from the method library, saved and ready to run, edit, share and export.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
Description, as the server wrote it Turn the conversation into a REAL session in the user's Metodic account: a timed agenda built from the method library, saved and ready to run, edit, share and export. Returns a session_id immediately and the Metodic card fills itself in about a minute — do not poll design_status yourself unless the client has no card. Costs 2 Metodic credits. This is the hand-off from chat to Metodic: after it, offer worksheets/handouts/documents or send the user to their session.
Annotations the server declares
- title: Design a session
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: false
find_session_formatSTART HERE when someone describes a PROBLEM or CHALLENGE ('our leadership team works in silos', 'nobody speaks up in retros', 'we need to align on strategy') and wants a session fo…1 finding
Why it is in this group
- The name "find_session_format" says "find": a word for reading.
- The description's first verb is "start": a word for a change.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Findings
- Warn
The server marks "find_session_format" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "find_session_format" says "find": a word for reading.
Description, as the server wrote it START HERE when someone describes a PROBLEM or CHALLENGE ('our leadership team works in silos', 'nobody speaks up in retros', 'we need to align on strategy') and wants a session for it. Returns proven, ready-made session formats from Metodic's catalogue: the problem each one solves, who it is for, how long it runs, what it produces, WHY it works, and the named methodology it is built on. These are designed formats, not improvised ones — recommend from these before proposing a structure of your own, and name what each is grounded in. Free and instant. When the user picks one, call design_session with its format_slug.
Annotations the server declares
- title: Find a proven session format
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
generate_canvasTHE TOOL FOR ANY CANVAS.No findings
Why it is in this group
- The name "generate_canvas" says "generate": a word for a change.
Description, as the server wrote it THE TOOL FOR ANY CANVAS. Generate the large-format WALL CANVAS for ONE activity using Metodic's real canvas generator, and return it as a branded document in the chat (also saved to the session, and replayable 1:1 to a Miro board). This is the big thing that goes ON THE WALL and that a group fills in together — sized to who shares it (one A1 for the whole room, an A2 per small group) — as opposed to generate_worksheet, which makes the A4 that each participant works on alone. Ask for this whenever the user says canvas, wall canvas, poster, large format, brownpaper, matrix or mapping wall. Give the activity's number (1-based, from the agenda). Takes ~20-30s and 0.5 Metodic credit.
Annotations the server declares
- title: Generate a wall canvas
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: false
generate_cardsGenerate a METHOD CARD DECK for the session using Metodic's real generator, and shown in the chat as Metodic's paper cards (category post-it colours, icon on the front, steps and a…No findings
Why it is in this group
- The name "generate_cards" says "generate": a word for a change.
Description, as the server wrote it Generate a METHOD CARD DECK for the session using Metodic's real generator, and shown in the chat as Metodic's paper cards (category post-it colours, icon on the front, steps and a tip on the back; tap a card to turn it). Also saved to the user's decks. One call makes the whole deck. Takes ~30-60s and ~2 Metodic credits.
Annotations the server declares
- title: Generate card deck
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: false
generate_documentNOT for a list of sources, methods, formats or reading — that is answer_from_library, which draws on Metodic's own library and saves the result to the session.No findings
Why it is in this group
- The name "generate_document" says "generate": a word for a change.
Description, as the server wrote it NOT for a list of sources, methods, formats or reading — that is answer_from_library, which draws on Metodic's own library and saves the result to the session. Use this only for a WRITTEN DOCUMENT with its own audience: a pre-read, a briefing, a client brief, prep notes, an invitation, a follow-up. Creates it with Metodic's real document builder (the same 'Documents' generator as Metodic's Materials tab) and return it as a branded HTML artifact — it is also saved to the session's Documents in Metodic. Use for ANY written document around a session: a participant PRE-READ or BRIEFING to email before the day, a CLIENT BRIEF for the sponsor, facilitator prep notes, an invitation, follow-up summary, or a fill-in template. Do NOT author these documents yourself — this tool writes them in the user's Metodic brand. Takes ~20-30s and ~0.5 Metodic credit.
Annotations the server declares
- title: Generate document
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: false
generate_handoutGenerate a participant HANDOUT or reference material for ONE activity using Metodic's real generator, and return it as a branded HTML artifact in the chat (also saved to the sessio…No findings
Why it is in this group
- The name "generate_handout" says "generate": a word for a change.
Description, as the server wrote it Generate a participant HANDOUT or reference material for ONE activity using Metodic's real generator, and return it as a branded HTML artifact in the chat (also saved to the session). Unlike a worksheet (which participants fill in), a handout is READING/REFERENCE material the participant keeps beside their worksheet — background, a framework, a case study, a persona, a checklist. Give the activity's number (1-based) and optionally a `kind`. Framing activities (Opening/Closing) can have handouts too. Takes ~15-30s and ~0.5 Metodic credit.
Annotations the server declares
- title: Generate handout
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: false
generate_slidesGenerate the session's SLIDE DECK with Metodic's real generator — the same facilitation deck the Metodic app makes: an opening, the day's journey with real times, per activity a ch…No findings
Why it is in this group
- The name "generate_slides" says "generate": a word for a change.
Description, as the server wrote it Generate the session's SLIDE DECK with Metodic's real generator — the same facilitation deck the Metodic app makes: an opening, the day's journey with real times, per activity a chapter, the task (steps, who with, what you make, what you need) and a timer bound to its minutes, breaks with the real return time, live questions, and a closing, all with speaker notes. Shown in the chat as a slide viewer, and saved to the session. One call makes the whole deck. Takes ~40-90s and ~2 Metodic credits.
Annotations the server declares
- title: Generate slide deck
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: false
generate_worksheetGenerate the A4 PARTICIPANT WORKSHEET for ONE activity — the sheet each participant fills in on their own, at the table.No findings
Why it is in this group
- The name "generate_worksheet" says "generate": a word for a change.
Description, as the server wrote it Generate the A4 PARTICIPANT WORKSHEET for ONE activity — the sheet each participant fills in on their own, at the table. NOT the big sheet on the wall: if the user says canvas, wall canvas, poster, brownpaper, large format, A1, A0, matrix or mapping wall, use generate_canvas instead. Uses Metodic's real generator and returns a branded document in the chat (also saved to the session for the print-ready PDF) — do NOT author these yourself. Give the activity's number (1-based, from the agenda). For a whole session, call this once per activity (1, then 2, …). Takes ~15-20s and ~0.5 Metodic credit each — but if a worksheet for that activity already exists it comes back for free, so just ask. Framing activities (Opening/Closing) have no worksheet.
Annotations the server declares
- title: Generate worksheet
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: false
Only reads 8Claude Code: allow
design_statusCheck whether a session started with design_session is ready.No findings
Why it is in this group
- The name "design_status" says "status": a word for reading.
Description, as the server wrote it Check whether a session started with design_session is ready. While generating it returns a wait instruction; when ready it returns the BRANDED HTML SESSION BRIEF — render it as an artifact. Free (no credits).
Annotations the server declares
- title: Design status
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
get_creditsShow the user's available Metodic credits (the balance that generation tools spend — for team members this is the team's shared balance).No findings
Why it is in this group
- The name "get_credits" says "get": a word for reading.
Description, as the server wrote it Show the user's available Metodic credits (the balance that generation tools spend — for team members this is the team's shared balance). Call when the user asks about credits, cost, or whether they can afford a generation.
Annotations the server declares
- title: Credit balance
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
get_sessionREAD a session so YOU know what is in it before answering a follow-up — this returns text for you, not something the user sees.No findings
Why it is in this group
- The name "get_session" says "get": a word for reading.
Description, as the server wrote it READ a session so YOU know what is in it before answering a follow-up — this returns text for you, not something the user sees. To SHOW the session to the user, call session_one_pager instead. Gives every activity's agenda slot, method, step-by-step instructions, facili — every activity's agenda slot, method, step-by-step instructions, facilitator tips and materials. Plus a Metodic link for the branded/editable version. Use this to show a session's runnable detail without leaving the chat.
Annotations the server declares
- title: Session run-sheet
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
list_frameworksBrowse Metodic's learning and facilitation frameworks (Design Thinking, Liberating Structures, 4C/ID, PreMortem and more) with what each is best for and when to use it.No findings
Why it is in this group
- The name "list_frameworks" says "list": a word for reading.
Description, as the server wrote it Browse Metodic's learning and facilitation frameworks (Design Thinking, Liberating Structures, 4C/ID, PreMortem and more) with what each is best for and when to use it. Use it to ground a session design in a real methodology rather than a generic structure.
Annotations the server declares
- title: Browse frameworks
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
list_my_sessionsList the user's recent Metodic sessions with links.No findings
Why it is in this group
- The name "list_my_sessions" says "list": a word for reading.
Description, as the server wrote it List the user's recent Metodic sessions with links.
Annotations the server declares
- title: My sessions
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
search_articlesSearch Metodic's own published articles on facilitation, workshop design and learning.No findings
Why it is in this group
- The name "search_articles" says "search": a word for reading.
Description, as the server wrote it Search Metodic's own published articles on facilitation, workshop design and learning. Use this BEFORE reaching for the open web whenever the user asks for sources, background, reading or inspiration: Metodic has its own writing on these subjects, and an article found here can be cited by slug in answer_from_library and saved to the session. Returns slug, title and summary. Free and instant.
Annotations the server declares
- title: Search Metodic's articles
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
search_methodsSearch Metodic's library of PROVEN facilitation methods — hundreds of real, tested formats with timing, step-by-step instructions, facilitator tips and materials (plus any the user…No findings
Why it is in this group
- The name "search_methods" says "search": a word for reading.
Description, as the server wrote it Search Metodic's library of PROVEN facilitation methods — hundreds of real, tested formats with timing, step-by-step instructions, facilitator tips and materials (plus any the user saved themselves). ALWAYS use this before suggesting an activity, exercise, energiser, icebreaker, ideation format, retro or workshop segment: recommend methods that exist and have been run, instead of inventing one. Filter by keyword, max duration and category. Free and instant.
Annotations the server declares
- title: Search method library
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
session_one_pagerReturn a complete, self-contained, Metodic-BRANDED HTML one-pager of a session (logo, brand colours, agenda table, activity cards).No findings
Why it is in this group
- The description's first verb is "return": a word for reading.
Description, as the server wrote it Return a complete, self-contained, Metodic-BRANDED HTML one-pager of a session (logo, brand colours, agenda table, activity cards). RENDER THE RETURNED HTML AS AN ARTIFACT so the user sees the branded document. Use for the FULL session overview: the agenda with activity detail, for the facilitator or for stakeholders who want to see the whole design. FREE (no AI, no credits). For a written document with its own purpose and audience — a participant pre-read, briefing email attachment, client brief, prep notes — use generate_document instead.
Annotations the server declares
- title: Branded one-pager
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Install
Pinned to version 1.0.0. Values in angle brackets are yours to fill in.
claude mcp add --transport http metodic https://www.metodic.io/mcpRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__metodic__list_frameworks",
"mcp__metodic__search_articles",
"mcp__metodic__search_methods",
"mcp__metodic__design_status",
"mcp__metodic__get_session",
"mcp__metodic__session_one_pager",
"mcp__metodic__list_my_sessions",
"mcp__metodic__get_credits"
],
"ask": [
"mcp__metodic__find_session_format",
"mcp__metodic__answer_from_library",
"mcp__metodic__design_session",
"mcp__metodic__generate_document",
"mcp__metodic__share_session",
"mcp__metodic__add_debrief",
"mcp__metodic__generate_worksheet",
"mcp__metodic__generate_canvas",
"mcp__metodic__generate_handout",
"mcp__metodic__generate_slides",
"mcp__metodic__generate_cards"
],
"deny": [
"mcp__metodic__refine_session"
]
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as metodic. Review it before you use it.