MCP tool

hevy_account

The connected Hevy account: username and the all-time number of logged workouts.

Parameters

None. This tool takes no arguments.

Output

A markdown table rather than JSON — roughly a third of the tokens, and models reason over rows more reliably than nested objects.

Notes and gotchas

  • Requires a connected Hevy account. Connect it from your dashboard — no developer account needed.
  • Read-only: this tool cannot change anything in your account.

Call it directly

The endpoint is plain JSON-RPC, so you can test without any client:

curl
curl -s https://fitnesspeak.app/mcp \
  -H "Authorization: Bearer fp_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
       "jsonrpc": "2.0",
       "id": 1,
       "method": "tools/call",
       "params": {
         "name": "hevy_account",
         "arguments": {}
       }
     }'

Tool description the model sees

The connected Hevy account: username and the all-time number of logged workouts. Call this to confirm which Hevy account is connected, or when the user asks how many workouts they have ever logged.

Descriptions say when to call a tool, not just what it does — that trigger wording is what models actually route on.

Use hevy_account in your assistant

14-day free trial. Card required so there's no second signup at the end; cancel before day 14 and you're charged nothing.