Skip to main content
Glama
Sign In

Joe Speaking

by io.github.hubeiqiao
OverviewDiscussionsAdmin

Saved-goal speaking coach and Part 2 planner

open_joe_speaking
Read-onlyIdempotent

Shows the signed-in learner's saved speaking goal, exam-scoped practice overview, available saved scores and exact selected feedback, with a coach interface on supported hosts. It provides bounded saved corrections, expressions and story references for IELTS Part 2 planning, CELPIP Tasks 1–8 and general speaking review. IELTS next-focus evidence is available when recent scored mocks support it. Read-only; this view does not start practice or Voice. Practice and recording happen in Joe Speaking through available verified links. Use when the learner asks how to get a steady 7, which one to practise first today, how to reuse stories already told, or wants to discuss saved feedback and plan the next practice. Speaking practice, recording, scoring and mock tests take place in Joe Speaking. Onboarding goals outside IELTS/CELPIP use general speaking coaching from saved answers, feedback and Collections; an explicitly named exam overrides that mode for this view. Supports whole-season IELTS Part 2 planning. The coach's professional, respectful teacher tone also covers progress commentary before data reads, without jokes, mocking metaphors or editorial asides.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "open_joe_speaking"
  }
}

Input Schema

NameRequiredDescriptionDefault
refNoExact returned question, recording-practice or live-conversation URI to review.
examNoExam explicitly named by the learner in this conversation. With no value, the selected source or saved Joe Speaking goal applies; chat memory is not an exam input.
modeNoPlanning/review view: voice_teacher is the general coach entry, part2_outline plans IELTS topics. Neither starts practice or Voice.
taskNoCELPIP task for planning or review, matching the selected question.
localeNoRequested conversation language for the coach interface; it may differ from the host language.
marketNoRegional IELTS bank selection, when available.
seasonIdNoExisting IELTS question-bank season identifier.
recordingIdNoExact saved attempt ID within the referenced recording-practice session.
feedbackScopeNoWhole-session saved feedback rather than a single attempt; mutually exclusive with recordingId.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changed
    • changedInput schema / properties / exam / description
      Previous value: -"Only when the learner names an exam in this conversation; never infer it from memory or earlier chats. Omit it so the saved Joe Speaking goal (IELTS or CELPIP) or the selected source applies."New value: +"Exam explicitly named by the learner in this conversation. With no value, the selected source or saved Joe Speaking goal applies; chat memory is not an exam input."
    • changedInput schema / properties / feedbackScope / description
      Previous value: -"Read whole-session feedback instead of a single saved attempt; cannot combine with recordingId."New value: +"Whole-session saved feedback rather than a single attempt; mutually exclusive with recordingId."
    • changedInput schema / properties / locale / description
      Previous value: -"Use the learner’s requested conversation language for the coach interface; it can differ from the host language."New value: +"Requested conversation language for the coach interface; it may differ from the host language."
    • changedInput schema / properties / task / description
      Previous value: -"CELPIP task to plan or review; must agree with the selected question."New value: +"CELPIP task for planning or review, matching the selected question."
  2. First observed

TDQS

A4.1/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare read-only, idempotent, non-destructive and closed-world, so the bar is lower, yet the description still adds real behavior: it does not start practice or Voice, the coach interface only renders on supported hosts, IELTS next-focus evidence is conditional on recent scored mocks, and onboarding goals outside IELTS/CELPIP fall back to general coaching. It does not describe the shape of returned data, which is the main remaining gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The core purpose and when-to-use guidance are front-loaded, but the text sprawls across repeated restatements that practice happens in Joe Speaking and closes with tone/style rules (no jokes, no mocking metaphors) that read as policy rather than tool selection guidance. Several sentences could be merged without losing selection signal.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 9-parameter, enum-heavy tool with no output schema, the description covers mode selection, exam precedence, scope limits and the fact that no practice or Voice is started. What is missing is any indication of what the returned view contains or how the saved-goal, scores and feedback pieces relate to each other.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so a baseline of 3 applies, but the description adds precedence semantics the schema alone does not: an explicitly named exam overrides general-speaking mode, and saved-goal/selected-source defaults apply when no exam is given. It adds little about ref, seasonId or recordingId beyond what the schema already documents.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific resource set: saved speaking goal, exam-scoped practice overview, saved scores and selected feedback, plus a Part 2 planning/coaching view. It implicitly separates itself from practice siblings by stating practice and recording happen in Joe Speaking through verified links, though it never names get_joe_speaking_practice_link or get_coach_selection directly.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives concrete triggering utterances (how to get a steady 7, which one to practise first today, how to reuse stories already told) and explicit exclusions: this view does not start practice or Voice, and scoring/mock tests live elsewhere. It also states the exam-precedence rule so the agent knows when an explicitly named exam overrides general coaching.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Joe Speaking toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources