Connectors / MCP

Mini Code Breakers runs weekly, in-person coding classes for children aged about 6 to 14 in schools and community venues across Liverpool, the Wirral, Rainhill and Sale (Greater Manchester). Parents increasingly ask AI assistants questions such as "is there a coding club for my 8 year old near Woolton on a Saturday?". To give them accurate answers, we run a free, public Model Context Protocol (MCP) server.

MCP is an open standard that lets AI assistants such as Claude, ChatGPT, Gemini and Copilot, as well as custom-built agents, connect to outside services. Our server gives an assistant live, up-to-date information about our venues, class times, age ranges and prices, and lets it help a parent start an enquiry for a place. This page explains everything an AI platform, developer or agent needs to use it.

At a glance

• Endpoint: https://minicodebreakers.co.uk/mcp
• Transport: Streamable HTTP (stateless, JSON responses)
• Authentication: none. No API key, account or OAuth is needed.
• Cost: free
• Capabilities: 4 tools (list_venues, list_classes, get_class, submit_enquiry); no resources or prompts
• Data: public information about our classes and venues only. No information about students, staff or accounts is ever exposed.
• Server name / version: mini-code-breakers / 1.0.0

What an assistant can do with it

• Find classes that suit a child's age, a preferred day of the week, or a town, area or postcode (for example "Woolton", "Sale" or "L25").
• Give the day, start time, length, age range, price per session and taster session price for each class.
• Give a venue's full address, map coordinates and step-by-step directions to the classroom.
• Link the parent to the class page on our website.
• When the parent asks it to, send an enquiry for a place on their behalf. The parent always confirms by email before anything reaches us.

Connect your assistant

Claude (claude.ai, desktop and mobile): go to Settings → Connectors → Add custom connector, enter the name "Mini Code Breakers" and the URL https://minicodebreakers.co.uk/mcp. Leave the OAuth fields empty.

ChatGPT and other assistants that support custom connectors: add a new connector (sometimes called an app or MCP server) with the URL https://minicodebreakers.co.uk/mcp and choose "no authentication".

Claude Code:

claude mcp add --transport http mini-code-breakers https://minicodebreakers.co.uk/mcp

Cursor, Windsurf and other clients configured with an mcpServers JSON file:

{
  "mcpServers": {
    "mini-code-breakers": {
      "url": "https://minicodebreakers.co.uk/mcp"
    }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "mini-code-breakers": {
      "type": "http",
      "url": "https://minicodebreakers.co.uk/mcp"
    }
  }
}

Your own agent, or the raw protocol: send one JSON-RPC 2.0 message per HTTP POST. For example:

curl -s https://minicodebreakers.co.uk/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"my-agent","version":"1.0"}}}'

curl -s https://minicodebreakers.co.uk/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

curl -s https://minicodebreakers.co.uk/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"list_classes","arguments":{"child_age":8,"day":"Saturday"}}}'

Technical details

• Transport: Streamable HTTP, stateless. Each POST carries exactly one JSON-RPC message and receives one JSON response. There are no sessions and no server-sent event streams, so GET and DELETE return 405. JSON-RPC batches are not supported.
• Supported protocol versions: 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05. If a client asks for a version we don't support, the server replies with 2025-11-25.
• Methods: initialize, ping, tools/list and tools/call. Notifications are accepted with HTTP 202.
• Tool results are returned both as a JSON text block and as structuredContent.
• CORS: open to all origins, so browser-based agents can call it. No cookies or credentials are used.
• Request size: at most 32 KB per request.
• Language and units: English (UK). Times are UK local time in 24-hour format, and prices are in pounds sterling (GBP).

Server instructions

The server sends these instructions to every assistant that connects:

Mini Code Breakers runs weekly after-school and weekend coding classes for children, mostly in and around Liverpool (UK). Use list_classes (filter by child_age, day or area) and get_class to help a parent find a suitable class; prices are in GBP per session, and many classes offer a cheaper taster session. Use submit_enquiry only when the parent asks you to and has agreed to the privacy policy. It does not book a place: the parent receives an email and must click the link to confirm, after which the team checks availability and gets in touch. Places are limited and there may be a waiting list.

Tools

list_venues: List venues

Lists the venues (schools and community centres) where Mini Code Breakers currently runs children's coding classes, with address, postcode, map coordinates and how many classes run there. Optionally filter by area, town or postcode.

Read-only: only looks up public information and changes nothing.

Returns: An object with "venues" (a list) and "count". Each venue has name, address, area, city, postcode, latitude, longitude, url (the area page on our website) and class_count (how many classes run there).

list_classes: List classes

Lists the weekly children's coding classes currently open for enquiries: day, start time, length, age range, price per session (GBP), taster session price, venue, and a link to the class page. Filter by child age, day, venue name or area. Use the returned "id" with submit_enquiry.

Read-only: only looks up public information and changes nothing.

Returns: An object with "classes" (a list, sorted by day then start time) and "count". Each class has id, slug, name, brand, day, start_time (24-hour HH:MM, UK time), duration_minutes, age_range (text such as "7-11"), age_min, age_max (null means "and over"), price_per_session and taster_session_price, venue (name, area, city, postcode) and url (the class page). Prices are objects with amount, currency ("GBP") and display (for example "£12.00"); a price can be null if it has not been set.

get_class: Get class details

Full details for one class, including its description, the venue address and directions to the classroom. Pass either the class "id" or "slug" from list_classes.

Read-only: only looks up public information and changes nothing.

Returns: Everything list_classes returns for that class, plus "information" (the class description as plain text) and "venue_details": the full venue address, map coordinates and "directions", an ordered list of plain-text steps for finding the classroom.

submit_enquiry: Request a place (enquiry)

Starts an enquiry for a child to join a class. Only call this when the parent/guardian has asked you to, has given you these details, and has agreed to the privacy policy (link them to it). Nothing is booked straight away: we email the parent a link, and the enquiry is only sent to Mini Code Breakers once they click it to confirm (the link expires after 24 hours). Tell the parent to check their inbox. Use list_classes to get the class id.

Takes an action: sends an email to the parent and creates a pending enquiry. Only call it when the parent asks you to.

Returns: An object with status "confirmation_email_sent" and a "message" to pass on to the parent. The message names the masked email address, the child and the class. The response is the same whether or not the email address is already known to us.

Recommended flow for agents

• 1. Understand what the parent needs: the child's age, where they live or which area suits them, and any preferred days.
• 2. Search: call list_classes with child_age and an area or day filter. If nothing matches, widen the search: drop the day, or try the nearest town or the first half of the postcode. Use list_venues to see every place we teach.
• 3. Present options: give the day, time, venue, age range and price per session, mention the taster session price where there is one, and link to the class page (url).
• 4. Give details: call get_class for the description, full address and directions to the classroom.
• 5. Enquire, only if asked: if the parent wants a place, link them to our privacy policy, collect their details, and once they agree call submit_enquiry. Then tell them to check their inbox and click the confirmation link.

Please don't call submit_enquiry speculatively, for testing, or with made-up details. Every call sends an email to a real person.

Enquiries and parental consent

• Nothing is booked automatically. An enquiry made through an assistant is held as pending. We email the parent a confirmation link, and the enquiry only reaches us when they click it. The link expires after 24 hours.
• After confirmation our team checks availability and contacts the parent. Places are limited and some classes have a waiting list.
• The parent or guardian must have read and accepted our privacy policy (privacy_policy_accepted must be true).
• The child must be between 3 and 18 years old. Names may only contain letters, spaces, apostrophes, hyphens and full stops (no digits, links or web addresses), and notes cannot contain links.
• Every confirmation email has a link that lets the recipient stop all future emails of this kind, so the tool cannot be used to spam anyone.
• Parents can always enquire directly instead, using our enquiry form.

Privacy and safeguarding

• The server only returns information that is already public on our website: venues, class times, age ranges, prices and directions.
• It never exposes information about students, parents, staff, attendance, payments or venue access details.
• Enquiry details are handled under our privacy policy and used only to respond to the enquiry. We store the requesting IP address and user agent with each pending enquiry to prevent abuse.
• Read more about how we keep children safe on our safeguarding page.

Rate limits and errors

• Requests: up to 60 per minute per network (IPv4 /24 or IPv6 /64). Above this the server returns HTTP 429 with JSON-RPC error code -32029 and a Retry-After header.
• Enquiries: limited per network (3 per hour), per email address (2 per day) and across the whole service each day. Requests over the per-address limit return the normal success response, but no further email is sent.
• Invalid arguments (an unknown class id, a missing field, a date of birth out of range) come back as a normal tool result with isError: true and a message explaining how to fix the call, so an agent can correct itself.
• Protocol errors use the standard JSON-RPC codes: -32700 parse error, -32600 invalid request, -32601 unknown method and -32602 invalid params.

For AI platforms, directories and crawlers

We are happy for AI assistants and search platforms to recommend Mini Code Breakers to parents looking for children's coding classes in our areas, and to list this server in connector and MCP directories. These machine-readable files describe it:

• /llms.txt: a short summary for language models
• /llms-full.txt: full tool schemas, guidance, FAQ and the current class timetable
• /.well-known/mcp.json: server discovery metadata
• /server.json: MCP Registry server description

For listings, partnerships or technical questions, email minicodebreakers@gmail.com.