Form Guide

Official5 tools

by GoodTurnStudio · JavaScript

Football form, fixtures, results and tables for six top European leagues.

MCP Server: io.github.GoodTurnStudio/formguide

The MCP server io.github.GoodTurnStudio/formguide provides football data including form, fixtures, results, and tables for six top European leagues. Its description is “Football form, fixtures, results and tables for six top European leagues,” indicating the scope and content it serves.

🛠️ Key Features

Football form
Fixtures
Results
Tables
Coverage for six top European leagues

🚀 Use Cases

Retrieve league tables for the six supported European leagues
Check recent team form
Access fixtures and upcoming match schedules
View match results

⚡ Developer Benefits

Clear, league-focused dataset scope (six top European leagues)
Structured categories aligned to common football data needs (form, fixtures, results, tables)

⚠️ Limitations

Limited to football data for six top European leagues (per description)
No additional capabilities beyond form, fixtures, results, and tables are specified in the provided data

Captured live from the server via tools/list.

get_team

A club's league position, recent form and next games. For requests like "how are Arsenal doing?", "what's Spurs' form?", "when do Birmingham play next?"

Parameters4

team	string	required	Club name as the user said it, up to 80 characters. Nicknames and small typos are fine.
league	string	optional	One of: premier league, championship, la liga, bundesliga, serie a, ligue 1 (common variants like EPL or German Bundesliga work too). Any other league returns 404. Only needed if two clubs share a name.
q	string	optional	Older name for team, kept for existing callers; team is the current name.
country	string	optional	Two-letter country code for the shirt link (US, GB and IE get local Amazon links). Default from the request. When passed as US or CA, the say line also gives the next kick-off in US Eastern time.

Raw schema

{
  "type": "object",
  "properties": {
    "team": {
      "type": "string",
      "description": "Club name as the user said it, up to 80 characters. Nicknames and small typos are fine."
    },
    "league": {
      "type": "string",
      "description": "One of: premier league, championship, la liga, bundesliga, serie a, ligue 1 (common variants like EPL or German Bundesliga work too). Any other league returns 404. Only needed if two clubs share a name."
    },
    "q": {
      "type": "string",
      "description": "Older name for team, kept for existing callers; team is the current name."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code for the shirt link (US, GB and IE get local Amazon links). Default from the request. When passed as US or CA, the say line also gives the next kick-off in US Eastern time."
    }
  },
  "required": [
    "team"
  ],
  "additionalProperties": false
}

get_fixtures

Upcoming fixtures for a club or a league. For requests like "who do Liverpool play next?" or "what's on in La Liga this weekend?". Without team or league, gives the Premier League.

Parameters4

team	string	optional	A club name, for example Liverpool or Real Madrid.
league	string	optional	One of: premier league, championship, la liga, bundesliga, serie a, ligue 1 (common variants like EPL or German Bundesliga work too). Any other league returns 404.
days	integer	optional	How far ahead, a whole number from 1 to 60. Default 21. If nothing falls in the window (an international break), the next fixtures are returned anyway.
country	string	optional	US or CA adds US Eastern kick-off times to the say line (and to each fixture's us_eastern, which is always there when a time is known).

Raw schema

{
  "type": "object",
  "properties": {
    "team": {
      "type": "string",
      "description": "A club name, for example Liverpool or Real Madrid."
    },
    "league": {
      "type": "string",
      "description": "One of: premier league, championship, la liga, bundesliga, serie a, ligue 1 (common variants like EPL or German Bundesliga work too). Any other league returns 404."
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 60,
      "description": "How far ahead, a whole number from 1 to 60. Default 21. If nothing falls in the window (an international break), the next fixtures are returned anyway."
    },
    "country": {
      "type": "string",
      "description": "US or CA adds US Eastern kick-off times to the say line (and to each fixture's us_eastern, which is always there when a time is known)."
    }
  },
  "required": [],
  "additionalProperties": false
}

get_results

Latest results for a club, or the last round of a league. For requests like "how did Chelsea get on?" or "what were the Serie A results?". Without team or league, gives the Premier League.

Parameters3

team	string	optional	A club name, for example Liverpool or Real Madrid.
league	string	optional	One of: premier league, championship, la liga, bundesliga, serie a, ligue 1 (common variants like EPL or German Bundesliga work too). Any other league returns 404.
n	integer	optional	How many of the club's results, a whole number from 1 to 20. Default 5.

Raw schema

{
  "type": "object",
  "properties": {
    "team": {
      "type": "string",
      "description": "A club name, for example Liverpool or Real Madrid."
    },
    "league": {
      "type": "string",
      "description": "One of: premier league, championship, la liga, bundesliga, serie a, ligue 1 (common variants like EPL or German Bundesliga work too). Any other league returns 404."
    },
    "n": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "How many of the club's results, a whole number from 1 to 20. Default 5."
    }
  },
  "required": [],
  "additionalProperties": false
}

get_table

League table. For requests like "show me the Championship table" or "who is top of La Liga?". Points include official deductions; a deducted club's row has points_deducted.

Parameters1

league

string

optional

One of: premier league, championship, la liga, bundesliga, serie a, ligue 1 (common variants like EPL or German Bundesliga work too). Any other league returns 404. Default premier league.

Raw schema

{
  "type": "object",
  "properties": {
    "league": {
      "type": "string",
      "description": "One of: premier league, championship, la liga, bundesliga, serie a, ligue 1 (common variants like EPL or German Bundesliga work too). Any other league returns 404. Default premier league."
    }
  },
  "required": [],
  "additionalProperties": false
}

compare_teams

Two clubs side by side before they meet. For requests like "Arsenal v Leeds, how do they compare?". Gives positions, form, goals, this season's meeting and the next date they play. Stats only, not betting advice.

Parameters5

home	string	required	The home club, for example Arsenal.
away	string	required	A different club from home.
team1	string	optional	Older name for home, kept for existing callers; home is the current name.
team2	string	optional	Older name for away, kept for existing callers; away is the current name.
country	string	optional	US or CA adds US Eastern kick-off times to the say line (and to each fixture's us_eastern, which is always there when a time is known).

Raw schema

{
  "type": "object",
  "properties": {
    "home": {
      "type": "string",
      "description": "The home club, for example Arsenal."
    },
    "away": {
      "type": "string",
      "description": "A different club from home."
    },
    "team1": {
      "type": "string",
      "description": "Older name for home, kept for existing callers; home is the current name."
    },
    "team2": {
      "type": "string",
      "description": "Older name for away, kept for existing callers; away is the current name."
    },
    "country": {
      "type": "string",
      "description": "US or CA adds US Eastern kick-off times to the say line (and to each fixture's us_eastern, which is always there when a time is known)."
    }
  },
  "required": [
    "home",
    "away"
  ],
  "additionalProperties": false
}

README.md4 KBView on GitHub

goodturn-mcp

Remote MCP servers for 25 free, read-only everyday helpers by Good Turn Studio: money, health, jobs, travel, shopping, halal checks, football and scripture reading. One Cloudflare Worker turns each product's public OpenAPI spec into an MCP server, so any assistant that speaks MCP (Claude, ChatGPT, Alexa+, Cursor, VS Code and others) can use them.

One server per product: https://goodturn-mcp.pages.dev/<slug>/mcp
All products in one: https://goodturn-mcp.pages.dev/all/mcp (tool names start with the product slug)
Streamable HTTP, stateless JSON, MCP 2025-11-25 (and 2025-06-18, 2025-03-26), no sign-in
Every tool is read-only, with a title and annotations (readOnlyHint: true, destructiveHint: false, idempotentHint: true)
Nothing about the user is stored. Privacy: https://goodturn-mcp.pages.dev/privacy

Products

Product	Slug	What it does
Mizan	`mizan`	Shariah screening of US stocks under four standards, halal alternatives, purification, zakat
Halal or Not	`halalornot`	Halal checks for food, ingredients, medicines, stocks, funds and crypto
Fare Deals	`faredeals`	Cheap flights from any city, and the cheapest days to fly
Cheapest Price	`cheapestprice`	The lowest current price for a product, checked live
Spin My Day	`spinmyday`	A whole day out in any city, matched to weather, mood and diet
Cancel My Sub	`cancelmysub`	How to cancel US and UK subscriptions, and what a card charge is
Lower My Bill	`lowermybill`	Call scripts and low-cost plans to lower household bills
Price Drop Back	`pricedropback`	Store price-adjustment rules, deadlines and a claim message
Find My Money	`findmymoney`	Official unclaimed money searches in the US and UK
Supplement Check	`supplementcheck`	Supplement labels and doses against official upper limits
Plate Pal	`platepal`	Calories and nutrition for foods, chain meals and barcodes
Plan My Workout	`planmyworkout`	Workout plans and how to do any exercise
Med Bill Check	`medbillcheck`	US medical bills against Medicare rates, with dispute letters
Appeal My Claim	`appealmyclaim`	US health insurance denials, rights, deadlines and appeal letters
Job Spotter	`jobspotter`	Current US and UK job listings
Sync My Cycle	`syncmycycle`	Likely cycle phase today, with food and workout ideas
Wardrobe Connect	`wardrobeconnect`	Clothes that match a description or a picture
Form Guide	`formguide`	Football form, fixtures, results and tables
Books Like This	`bookslikethis`	Books like one you enjoyed, and screen adaptations
Talmud Scroller	`talmud`	Daily Talmud with Daf Yomi, and tractates in English
Scroll the Gurbani	`gurbani`	Daily Gurbani with English, any Ang or shabad
Gita Scroller	`gita`	Daily Bhagavad Gita verses with English
Scroll the Lore	`lore`	Greek and Norse myth, Homer, Hesiod and the Poetic Edda
Stoic Scroller	`stoics`	Marcus Aurelius, Epictetus and Seneca
Bible Swipe	`bible`	Daily Bible readings and any passage

How it works

build.py reads each product's live openapi.json and writes products.js: one tool per GET operation, named from its operationId, with inputs from its parameters. Descriptions are tidied into plain tool descriptions.
worker.mjs is the MCP server: initialize, tools/list and tools/call, which calls the product's own API and returns its answer. Answers with a say field carry a ready-made summary.
servers.json lists every server for the official MCP Registry (as io.github.GoodTurnStudio/<slug>). The Publish to the MCP Registry workflow logs in with GitHub OIDC and runs publish.py; publish.ps1 does the same from Windows.

Build and test

code

npm install
npm run build          # python3 build.py, then bundle to deploy/_worker.js
npm test               # every product through the worker, against the live APIs
npm run test:live      # every tool through the deployed servers with the MCP SDK client

Deploy deploy/ as a Cloudflare Pages project in advanced mode (_worker.js).

Licence

MIT for this code. Each product's API, data and answers belong to that product and are served under its own terms, linked from its page at https://goodturn-mcp.pages.dev/<slug>.

Install

Tools (5)

get_teamget_fixturesget_resultsget_tablecompare_teams

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://goodturn-mcp.pages.dev/formguide/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "formguide": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://goodturn-mcp.pages.dev/formguide/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

MCP Server: io.github.GoodTurnStudio/formguide

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

get_team

get_fixtures

get_results

get_table

compare_teams

goodturn-mcp

Products

How it works

Build and test

Licence

Install

Remote endpoint

Related servers