{
  "markdown": "# LocalGym MCP Server\n\nRead-only MCP server for searching, comparing, and recommending UK gyms using the public LocalGym Agent API.\n\n- Website: https://localgym.uk\n- Agent/API docs: https://localgym.uk/agent\n- MCP setup page: https://localgym.uk/agent/mcp\n- OpenAPI schema: https://localgym.uk/api/openapi.json\n- LLM instructions: https://localgym.uk/llms.txt\n\n## Why this exists\n\nLocalGym 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.\n\n## Tools\n\n| Tool | Description |\n| --- | --- |\n| `search_gyms` | Search UK gyms by name, keyword, location, or user intent. |\n| `get_gym_details` | Return structured details for a LocalGym gym slug. |\n| `recommend_gyms` | Recommend gyms for a user goal and location. |\n| `compare_gyms` | Compare several gyms by LocalGym slug. |\n\n## Quick start\n\nRun directly from npm:\n\n```bash\nnpx -y localgym-mcp-server\n```\n\nOr clone and run locally:\n\n```bash\ngit clone https://github.com/lo-nau/localgym-mcp-server.git\ncd localgym-mcp-server\nnpm install\nnpm start\n```\n\nThe server uses `https://localgym.uk` by default. To override it:\n\n```bash\nLOCALGYM_API_BASE=https://localgym.uk npx -y localgym-mcp-server\n```\n\n## MCP client config\n\nRecommended npm-based config:\n\n```json\n{\n  \"mcpServers\": {\n    \"localgym\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"localgym-mcp-server\"],\n      \"env\": {\n        \"LOCALGYM_API_BASE\": \"https://localgym.uk\"\n      }\n    }\n  }\n}\n```\n\nLocal clone config:\n\n```json\n{\n  \"mcpServers\": {\n    \"localgym\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/localgym-mcp-server/bin/localgym-mcp-server.cjs\"],\n      \"env\": {\n        \"LOCALGYM_API_BASE\": \"https://localgym.uk\"\n      }\n    }\n  }\n}\n```\n\n## Hermes Agent config\n\n```yaml\nmcp_servers:\n  localgym:\n    command: \"npx\"\n    args: [\"-y\", \"localgym-mcp-server\"]\n    env:\n      LOCALGYM_API_BASE: \"https://localgym.uk\"\n```\n\nIf you cloned the repo locally instead, use:\n\n```yaml\nmcp_servers:\n  localgym:\n    command: \"node\"\n    args: [\"/absolute/path/to/localgym-mcp-server/bin/localgym-mcp-server.cjs\"]\n    env:\n      LOCALGYM_API_BASE: \"https://localgym.uk\"\n```\n\n## Example tool arguments\n\n### `search_gyms`\n\n```json\n{\n  \"query\": \"personal training\",\n  \"location\": \"Manchester\",\n  \"limit\": 5\n}\n```\n\n### `get_gym_details`\n\n```json\n{\n  \"slug\": \"kent-sports-fitness\"\n}\n```\n\n### `recommend_gyms`\n\n```json\n{\n  \"intent\": \"beginner friendly gym with personal training\",\n  \"location\": \"Leeds\",\n  \"limit\": 5\n}\n```\n\n### `compare_gyms`\n\n```json\n{\n  \"slugs\": [\n    \"kent-sports-fitness\",\n    \"the-box-private-personal-training-studio\"\n  ]\n}\n```\n\n## Test\n\n```bash\nnpm test\n```\n\nYou can also smoke-test tool discovery by sending MCP JSON-RPC frames over stdio from an MCP client.\n\n## Usage policy\n\nV1 is free, read-only, and attribution-first. Please link back to returned `localgym_url` values when using LocalGym data in public answers.\n\nThe 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.\n\nFor high-volume, commercial, affiliate, or claimed-listing use, contact enquiries@localgym.uk.\n\n## License\n\nMIT\n",
  "bytes": 3457,
  "sha": "9534d6ccaec78a50942b7d367f8684c45e96a4e7d460dcd65fc9e096bf737f37",
  "repo_slug": "lo-nau/localgym-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_lo_nau_localgym_mcp_server_f68994a0/readme"
}