Skip to content

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.

Deletes · 1Changes · 11

20 tools: 1 can delete or cancel things, 11 change things and 8 only read.

Scanned Oct 21, 2026

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/mcp

Findings

Matches of fixed checks, with the text they matched.

1 warn
  • The server marks "find_session_format" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "find_session_format" says "find": a word for reading.

    What this check looks for

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".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "find_session_format" says "find": a word for reading.

      What this check looks for
    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
  • share_sessionCreate a shareable link to a session so someone else can see it WITHOUT a Metodic account: a client or sponsor who has to approve the programme, a co-facilitator, or the participan…No findings

    Why it is in this group

    • The description's first verb is "create": a word for a change.
    Description, as the server wrote it
    Create a shareable link to a session so someone else can see it WITHOUT a Metodic account: a client or sponsor who has to approve the programme, a co-facilitator, or the participants. Optionally writes a client-facing brief first (audience 'client') and shares that alongside the plan. Returns the link. Reuses an existing link for the same session instead of making a second one. Free unless a brief is generated (~0.5 credit).

    Annotations the server declares

    • title: Share a session
    • 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/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.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.