Localgym Mcp Server

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

Quick start

Run directly from npm:

npx -y localgym-mcp-server

Or clone and run locally:

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:

LOCALGYM_API_BASE=https://localgym.uk npx -y localgym-mcp-server

MCP client config

Recommended npm-based config:

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

Local clone config:

{  "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

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:

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

{  "query": "personal training",  "location": "Manchester",  "limit": 5}

get_gym_details

{  "slug": "kent-sports-fitness"}

recommend_gyms

{  "intent": "beginner friendly gym with personal training",  "location": "Leeds",  "limit": 5}

compare_gyms

{  "slugs": [    "kent-sports-fitness",    "the-box-private-personal-training-studio"  ]}

Test

npm 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