io.github.LouisVanh/tutoring

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Find and book verified 1-on-1 online tutors: search by subject, price and rating, then book.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "tutoring": {
      "url": "https://itutoronline.com/api/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (7)

• search_tutors read-only

  Search iTutorOnline's verified tutor directory. Filter by subject/keyword, country, spoken language, max hourly price (EUR), and minimum rating. Returns ranked tutor cards with rates, ratings, and profile links.

  Parameters:

  • limit — integer — How many tutors to return (1-25, default 8).
  • country — string — Filter by tutor country, e.g. "Germany", "Netherlands", "Belgium".
  • subject — string — Subject or keyword, e.g. "Mathematics", "IELTS", "Python". Synonyms and NL/FR/DE translations are matched. See list_subjects.
  • language — string — Filter by a language the tutor speaks, e.g. "English", "Dutch", "French".
  • minRating — number — Only tutors with an average review score at or above this (0-5).
  • maxPriceEuros — number — Only tutors at or below this hourly rate in euros.

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• get_tutor read-only

  Get the full public profile for one tutor: headline, description, subjects, academic levels, rate, rating, credentials, languages, and how to book. Identify the tutor by the id from a search_tutors result, or by the last part of their profile URL.

  Parameters:

  • tutorUserId (required) — string — The tutor's user id from a search_tutors result, or their profile handle — the last part of the profile URL, e.g. "ada-47256" from /tutor-profile/ada-47256. Either form works.

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• get_tutor_reviews read-only

  Get recent written reviews and the average score for a tutor.

  Parameters:

  • tutorUserId (required) — string — The tutor's user id from a search_tutors result, or their profile handle from the profile URL. Either form works.
  • limit — integer — How many reviews to return (1-25, default 10).

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• list_subjects read-only

  List the subjects tutors teach, with the search terms and synonyms that match each. Use before search_tutors to pick a good subject term.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_platform_info read-only

  Explain how iTutorOnline works: pricing, the free first 30 minutes, hour packages, languages of instruction, how booking works, and the live count of verified tutors.

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• prepare_booking read-only

  Assemble a real tutoring booking for a parent/student to finish in one tap. Give the tutor id, how long, who it is for, and optionally a preferred time. Returns a price estimate, a booking brief, and the link the human opens to confirm and pay. Creates nothing and charges nothing itself.

  Parameters:

  • tutorUserId (required) — string — The tutor's user id from a search_tutors result, or their profile handle from the profile URL. Either form works.
  • note — string — A note to pass to the tutor about what the student needs.
  • forWhom — string — Who the lesson is for, e.g. "my 15-year-old daughter".
  • subject — string — Subject for the lesson, e.g. "A-level Chemistry".
  • durationMinutes — integer — Lesson length in minutes (30-180, default 60).
  • preferredStartTime — string — Optional ISO 8601 start time, e.g. "2026-07-20T16:00:00Z". Must be in the future.

  Hints: read-only yes · destructive no · idempotent not declared · open-world yes

• request_human_tutor

  Hand a tutoring request to the iTutorOnline team so they can line up a human tutor. Requires the subject AND an email address the team can reply to — ask the student for one before calling this, because there is no other way to reach them afterwards. If they will not share an email, use search_tutors instead and give them a profile link. Also returns tutors the student can book immediately.

  Parameters:

  • subject (required) — string — What the student needs help with, e.g. "A-level Chemistry, organic reactions".
  • contactEmail (required) — string — The student's (or parent's) email address, so the team can reply. Required — ask them for it rather than guessing or leaving it out.
  • details — string — Any extra context: goals, deadline, availability, current struggles.
  • studentLevel — string — The student's level, e.g. "Year 11", "university".
  • preferredLanguage — string — Preferred language of instruction.

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.