FeaturesAcademyPricingDevelopersAboutLog inBook a demo
Developers/MCP
Model Context Protocol

Run your gym from an AI assistant.

The Model Context Protocol is an open standard that lets assistants like Claude call tools. We ship an open-source MCP server that wraps the Gym Seva API — so you can ask questions in plain language and get answers from your live gym data.

Who’s due for renewal this week, and how much revenue is at risk?
⚙ called renewals_due
14 members lapse this week — ₹1.9L at risk. The three largest are Rohan (Annual, ₹90k), Divya (Quarterly, ₹12k) and Amit (Monthly, ₹3.5k). Want me to draft reminders?
The toolset

Eleven read-only tools, out of the box.

Every tool is a thin wrapper over an API endpoint. Nothing writes or deletes — the starter is read-only by design. Add write tools when you’re ready.

whoami

The signed-in staff account and its roles.

gym_dashboard

The day’s headline numbers for the current gym.

list_members

Search members by term and status.

get_member

One member’s full profile — plan, payments, sessions.

renewals_due

Plans expiring soon or lapsed, with revenue at risk.

accounts_receivable

Subscriptions with an outstanding balance.

kpi_matrix

Month-wise sign-ups, revenue, renewals and sessions.

premium_members

Most valuable members by lifetime spend.

list_leads

The sales pipeline, optionally filtered by status.

pending_sessions

Sessions awaiting member PIN approval.

cash_on_hand

Current posted cash-drawer balance.

Setup

Three steps to connect it.

1 — Install

The server lives in mcp-server/ in your Gym Seva repo. It’s a standalone Node package — no build step, Node 18+.

Shell
git clone <your Gym Seva repo>
cd mcp-server
npm install

2 — Add your credentials

The server signs in with a staff account to get a session cookie — the API has no API keys, so use a manager or owner login for full report access. Need scoped programmatic access instead? [email protected].

3 — Point Claude at it

Add this to claude_desktop_config.json and restart. The same block works for Claude Code and any MCP client.

claude_desktop_config.json
{
  "mcpServers": {
    "gymseva": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/src/index.js"],
      "env": {
        "GYMSEVA_EMAIL": "[email protected]",
        "GYMSEVA_PASSWORD": "your-password"
      }
    }
  }
}

Build your own tools on it.

The MCP server is a thin, readable wrapper over the same REST API the whole product runs on. Extend it, or build a fresh integration straight from the reference.

View the API referenceTalk to us