Localgym Mcp Server

io.github.lo-nauPublished by GitHub account lo-nauv0.1.2Updated Oct 24, 2026

Read-only MCP server for UK gym search using the LocalGym Agent API.

VerifiedSTDIODesktop onlyLocation & Lifestyle

Server details

Identifier: io.github.lo-nau/localgym-mcp-server
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account lo-nau for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.lo-nau%2Flocalgym-mcp-server.svg)](https://sourceweft.com/mcp/io.github.lo-nau%2Flocalgym-mcp-server?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Lets an assistant search, compare, and get recommendations for UK gyms through the public LocalGym Agent API.

What you can do: A read-only MCP server that wraps the public LocalGym Agent API for UK gym discovery. It exposes four tools: search_gyms for finding gyms by name, keyword, location, or intent; get_gym_details for structured details on a gym slug; recommend_gyms for suggestions based on a goal and location; and compare_gyms for side-by-side comparison of several gyms by slug. It covers 18,000+ UK gyms and fitness centres.
When to use it: Useful when an assistant needs to answer questions about UK gyms, fitness centres, or training options, such as finding a gym in a city, comparing a few locations, or recommending options for a stated goal. It is aimed at read-only discovery rather than booking or account management.
Requirements: Runs locally as a stdio process, typically via npx localgym-mcp-server, so Node.js and network access are needed. No authentication is declared. Optional environment variables: LOCALGYM_API_BASE (defaults to LOCALGYM_MCP_RATE_LIMIT_MAX (default 60), and LOCALGYM_MCP_RATE_LIMIT_WINDOW_MS (default 60000).

Before you install

Read-only, so it does not book, pay, or change data. It sends search queries and gym slugs to the LocalGym API over the network. The public API enforces server-side rate limits, and the wrapper adds a local courtesy limiter; high-volume or commercial use is expected to be arranged with the provider first. Attribution to returned localgym_url values is requested for public answers.

Installation

In SourceWeft

Open Localgym Mcp Server in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

LocalGym MCP Server

Read-only MCP server for searching, comparing, and recommending UK gyms using the public LocalGym Agent API.

Website: https://localgym.uk
Agent/API docs: https://localgym.uk/agent
MCP setup page: https://localgym.uk/agent/mcp
OpenAPI schema: https://localgym.uk/api/openapi.json
LLM instructions: https://localgym.uk/llms.txt

Why this exists

LocalGym covers 18,000+ UK gyms and fitness centres. This MCP server gives AI assistants and agent workflows a small, attributable interface for local gym discovery without exposing the private LocalGym website codebase.

Tools

Tool	Description
`search_gyms`	Search UK gyms by name, keyword, location, or user intent.
`get_gym_details`	Return structured details for a LocalGym gym slug.
`recommend_gyms`	Recommend gyms for a user goal and location.
`compare_gyms`	Compare several gyms by LocalGym slug.

Quick start

Run directly from npm:

Or clone and run locally:

bash

git clone https://github.com/lo-nau/localgym-mcp-server.gitcd localgym-mcp-servernpm installnpm start

git clone https://github.com/lo-nau/localgym-mcp-server.gitcd localgym-mcp-servernpm installnpm start

The server uses https://localgym.uk by default. To override it:

MCP client config

Recommended npm-based config:

json

{  "mcpServers": {    "localgym": {      "command": "npx",      "args": ["-y", "localgym-mcp-server"],      "env": {        "LOCALGYM_API_BASE": "https://localgym.uk"      }    }  }}

{  "mcpServers": {    "localgym": {      "command": "npx",      "args": ["-y", "localgym-mcp-server"],      "env": {        "LOCALGYM_API_BASE": "https://localgym.uk"      }    }  }}

Local clone config:

json

{  "mcpServers": {    "localgym": {      "command": "node",      "args": ["/absolute/path/to/localgym-mcp-server/bin/localgym-mcp-server.cjs"],      "env": {        "LOCALGYM_API_BASE": "https://localgym.uk"      }    }  }}

{  "mcpServers": {    "localgym": {      "command": "node",      "args": ["/absolute/path/to/localgym-mcp-server/bin/localgym-mcp-server.cjs"],      "env": {        "LOCALGYM_API_BASE": "https://localgym.uk"      }    }  }}

Hermes Agent config

yaml

mcp_servers:  localgym:    command: "npx"    args: ["-y", "localgym-mcp-server"]    env:      LOCALGYM_API_BASE: "https://localgym.uk"

mcp_servers:  localgym:    command: "npx"    args: ["-y", "localgym-mcp-server"]    env:      LOCALGYM_API_BASE: "https://localgym.uk"

If you cloned the repo locally instead, use:

yaml

mcp_servers:  localgym:    command: "node"    args: ["/absolute/path/to/localgym-mcp-server/bin/localgym-mcp-server.cjs"]    env:      LOCALGYM_API_BASE: "https://localgym.uk"

mcp_servers:  localgym:    command: "node"    args: ["/absolute/path/to/localgym-mcp-server/bin/localgym-mcp-server.cjs"]    env:      LOCALGYM_API_BASE: "https://localgym.uk"

Example tool arguments

`search_gyms`

`get_gym_details`

`recommend_gyms`

`compare_gyms`

Test

You can also smoke-test tool discovery by sending MCP JSON-RPC frames over stdio from an MCP client.

Usage policy

V1 is free, read-only, and attribution-first. Please link back to returned localgym_url values when using LocalGym data in public answers.

The public LocalGym Agent API enforces server-side rate limits. This MCP wrapper also includes a local courtesy limiter, defaulting to 60 tool calls per 60 seconds per running MCP process. You can lower it with LOCALGYM_MCP_RATE_LIMIT_MAX or LOCALGYM_MCP_RATE_LIMIT_WINDOW_MS; high-volume/commercial use should be arranged first.

For high-volume, commercial, affiliate, or claimed-listing use, contact [email protected].

License

MIT

Source: README.md at commit b4f3e66

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v0.1.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts