Skip to main content
Glama
Sign In
garminconnect-js

garminconnect-js

by DynamicsNinja
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

get_badge_challenges

Read-only

Fetches paginated lists of completed Garmin badge challenges. Always pass start >= 1, as Garmin's API rejects start=0.

Instructions

Completed badge challenges. Garmin rejects start=0; start at 1. GETs /badgechallenge-service/badgeChallenge/completed; same start/limit validation as getAdhocChallenges; returns an ARRAY, verified live. Live discovery: Garmin's server rejects start=0 with a 400 ("start should > 0.") on this endpoint even though the client-side check allows it (non-negative); the 400 is Garmin's server, not a wrong URL; call with start>=1 in practice.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "start": "<start>",
      "limit": "<limit>"
    },
    "name": "get_badge_challenges"
  }
}

Input Schema

NameRequiredDescriptionDefault
limitYes
startYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.6/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover the safety profile (readOnlyHint, openWorldHint), and the description adds real behavioral context beyond them: Garmin's server rejects start=0 with a 400 'start should > 0.' despite a permissive client-side check, the URL is correct, and the response is an ARRAY verified live. This is exactly the kind of operational quirk that saves an agent failed calls, though auth needs and pagination/return details remain unstated.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The purpose is front-loaded, but the start=0 rejection is stated twice (once tersely, once in the 'Live discovery' paragraph), which is redundant. The second statement adds the actual error message and reasoning, so it is not pure duplication, but the content could be compressed considerably.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple two-parameter read tool with annotations and no output schema, the description is close to complete: it covers purpose, endpoint, return shape, and the critical start constraint. The only meaningful gap is limit semantics and any when-not-to-use guidance relative to the other badge endpoints.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description carries the full burden. It explains the start constraint in depth (must be >=1, start=0 causes a 400), which is valuable, but it says nothing about limit (range, default, max) and never clarifies that both are required numbers.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The opening fragment 'Completed badge challenges' names the resource and the completed subset, which lets an agent distinguish it from get_non_completed_badge_challenges and get_available_badge_challenges. The endpoint path is also stated, but the purpose is never phrased as a proper verb+object statement and no sibling is named explicitly.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives practical invocation guidance ('start at 1', start>=1 in practice) and cross-references getAdhocChallenges for validation behavior, which is genuinely useful. However, it never states when to choose this tool over the closely related badge tools (non-completed, available, earned, in-progress), so routing is left to inference from the word 'Completed'.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools