Sport Health MCP
This server is a read-only MCP toolset for analyzing Huawei Health export data to produce post-activity sport reports.
Inspect the configured Huawei Health export and verify available source files.
List imported activities with optional filtering and pagination.
Retrieve normalized summary metrics for a single activity.
Get paginated GPS tracks with timestamps and altitude.
Get paginated heart rate, cadence, speed, altitude, or pace samples.
Get daily health context around an activity: sleep, HRV, stress, heart rate, SpO2, and resting heart rate.
Fetch and cache historical weather and air-quality data from Open-Meteo for an activity.
Generate a deterministic evidence pack containing facts, context, flags, and guidance for writing a report.
Obtain a fixed report contract with structure, section lengths, and writing constraints.
Supports local, privacy-first analysis without modifying raw health data.
Analyzes Huawei Health personal data exports, providing tools for inspecting sports summaries, GPS tracks, heart rate, pace, speed, altitude, training load, and surrounding health context.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Sport Health MCP帮我分析最近一次跑步数据,并生成运动复盘报告"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Sport Health MCP
A local-first MCP server for Huawei Sport Health analysis. Once a user provides their HUAWEI_HEALTH_* personal data export, the Agent can read exercise performance, in-workout physiological metrics, and health context before and after an activity, and supplement it with historical weather and air quality as needed.
This project is for workout review and does not provide medical diagnosis or treatment advice.
Current Capabilities
Reconize Huawei personal data export directories and their core JSON files.
Tolerantly parse non-standard numeric JSON keys from Huawei data.
Parse activity summaries, GPS tracks, heart rate, cadence, speed, altitude, and training load.
Aggregate heart rate, resting heart rate, HRV, stress, blood oxygen, and sleep stages for the day before, during, and after an activity.
Call the Open-Meteo historical weather and air quality API and cache responses locally.
Provide paginated data tools and a report evidence pack through MCP.
Related MCP server: mcp-takeout-googlefit
Installation
Python 3.11 or newer is recommended. Create a virtual environment in the project directory:
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -e ".[dev]"Huawei export packages are never packaged or committed; .gitignore ignores all HUAWEI_HEALTH_* directories by default.
Local Check
When the project directory contains exactly one HUAWEI_HEALTH_* folder, it is recognized automatically:
sport-health-inspect inspect
sport-health-inspect listYou can also specify it explicitly:
sport-health-inspect --export-dir "D:\HealthData\HUAWEI_HEALTH_xxx" listStarting the MCP Server
For local agents, stdio is recommended:
$env:SPORT_HEALTH_EXPORT_DIR="D:\HealthData\HUAWEI_HEALTH_xxx"
sport-health-mcpA minimal MCP client configuration looks like the following; the exact field names depend on the client:
{
"mcpServers": {
"sport-health": {
"command": "C:\\sport-health-mcp\\.venv\\Scripts\\sport-health-mcp.exe",
"env": {
"SPORT_HEALTH_EXPORT_DIR": "D:\\HealthData\\HUAWEI_HEALTH_xxx"
}
}
}
}Registering with an MCP Client
Add the command and env settings shown above to any client that supports MCP stdio, save, and restart the client. Different clients place configuration files in different locations and may use different outer field names, so always check the corresponding client documentation.
Using Different Agents
Same computer: any Agent that supports MCP
stdiocan launch the same Server, but it must be registered once using that Agent's configuration format.Another user's computer: install this project, export your own
HUAWEI_HEALTH_*data package, and replace thecommandand data directory in the configuration with your own absolute paths.Web or cloud agents: a local
stdioprocess on a user's computer is unreachable from such clients. To support them, you would need to provide a separate, authenticated Streamable HTTP deployment and handle encrypted uploads, user isolation, data deletion, and privacy compliance.
The project never shares the author's Huawei data. The MCP Server is a general-purpose program; every user keeps their data on their own machine.
MCP Tools
inspect_huawei_export: Check the integrity of the data export.list_activities: List activities.get_activity_summary: Get a single activity's summary.get_activity_track: Get GPS tracks with pagination.get_activity_samples: Get heart rate, cadence, speed, and altitude samples with pagination.get_health_context: Get the health context of the days around an activity.get_activity_environment: Fetch and cache historical environmental data.get_report_evidence_pack: Generate a deterministic evidence pack for report writing.get_report_contract: Get the fixed report sections, length, and writing constraints.
The recommended flow is to call list_activities first, then pick an activity_id, call get_report_evidence_pack, and generate the report strictly so chapters the returned report_contract. The fixed format keeps only the essential assessments, performance analysis, body response, and training recommendations, and avoids repeating all metrics the device app already displays. Only use the paginated detail tools when you need to inspect the underlying curves or tracks.
Testing
No testing framework needs to be installed to run the standard-library tests:
$env:PYTHONPATH="src"
python -m unittest discover -s tests -vTests use only synthetic activity records generated by code; they do not depend on or contain any personal export data.
Privacy Boundaries
Raw health data is only read locally by default.
Only the environment enhancer touches the network, and it sends only the route center point plus a date and hour range.
MCP tools are read-only; they do not modify Huawei export files.
Before sharing logs or issue reports, remove coordinates, timestamps, device identifiers, and health indicators.
When publishing code, do not zip the whole working directory; use a version-control export or publish build artifacts instead, to avoid including ignored personal data directories.
Open Source License
This project is released under the MIT License. Please read SECURITY.md before reporting a security issue, and do not upload real health data, GPS tracks, environment caches, or logs containing local paths to public issues.
Third-Party Services and Trademarks
Data is provided by Open-Meteo, licensed under CC BY 4.0. The source and license information must be retained whenever the data is shown.
The free Open-Meteo API is intended for non-commercial use and is subject to call quotas. For commercial use, use the commercial API or self-host under the official license. See Open-Meteo Terms.
This project is an independent community project; it is not affiliated with, authorized by, or otherwise endorsed by Huawei. All product names and trademarks belong to their respective owners.
Available Tools
9 toolsget_activity_environmentB
Fetch cached historical weather and air-quality context from Open-Meteo.
| Name | Required | Description | Default |
|---|---|---|---|
| activity_id | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full behavioral disclosure burden. It does usefully disclose that data is cached and historical, which implies it may be stale or not fetched live, but it does not describe cache-miss behavior, freshness limits, or whether any network call occurs.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence with no wasted words, and the core purpose is front-loaded. It is compact and easy to scan.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool is simple enough that the description is mostly adequate, but it omits any contextual bridge to the sibling tools and leaves the sole parameter unexplained. The presence of an output schema reduces the need to explain the return value, yet this still feels minimal rather than complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The description does not mention activity_id at all, and schema description coverage is 0%. The parameter name is reasonably interpretable, but the description adds no semantic guidance beyond the schema and does not compensate for the missing schema descriptions.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a clear verb and resource: 'Fetch cached historical weather and air-quality context from Open-Meteo.' It is specific enough to be understood as distinct from sibling tools like get_health_context, though it does not explicitly call out that distinction.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance about when to use this tool instead of alternatives. Given siblings like get_health_context and get_activity_summary, an agent receives no signal about which one fits a given need.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_activity_samplesA
Get paginated heart_rate, cadence, speed, altitude, or pace samples.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| metric | No | ||
| offset | No | ||
| activity_id | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the transparency burden. It usefully states that results are paginated, which indicates offset/limit-driven behavior, and 'Get' signals read-only usage. However, it does not disclose what happens when the optional 'metric' parameter is null, nor does it mention ordering, boundaries, or rate-limit behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single concise sentence with no jargon or required words. 'Get paginated' is front-loaded, and the metric list is compact. Every word earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
An output schema exists, so the response shape is not a concern. Yet the description still omits important invocation context: there is no statement about what null metric means, how pagination limits/offsets work, or any model limits on limit. This is likely to be usable in many cases but leaves crucial optionality unstated.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description must compensate. It does add semantic value for the metric parameter by listing possible sample types, but it does not explain the default null behavior, how limit/offset interact for pagination, or whether metric values are case/index-sensitive. The parameter list is therefore partially clarified but not fully covered.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description is specific and immediate: it uses the verb 'Get' with a clear resource ('paginated ... samples') and lists the exact metric types supported. This makes the purpose unmistakable and differentiates it from sibling tools like get_activity_summary and get_activity_track.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies when to use this tool—when you need paginated raw activity samples—but it never explicitly says when to prefer it over alternatives such as get_activity_summary or get_activity_track. The agent must infer routing from the tool name and sibling names rather than from direct guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_activity_summaryC
Get normalized summary metrics for one activity.
| Name | Required | Description | Default |
|---|---|---|---|
| activity_id | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must explain behavior. The word 'normalized' hints at data transformation, but it is undefined, and there is no mention of side effects, data source, permissions, or edge cases.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is one short sentence that immediately states the purpose. There no filler, redundancy, or repetition of the tool name.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite having an output schema, the description omits any context about how activity_id is used, what normalized metrics are, and how this tool fits among eight siblings. This is minimal for an agent deciding whether to call this tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0%, so the description must compensate for the activity_id parameter. It only says 'for one activity,' which confirms the parameter identifies a single activity, but it does not explain the format, source, or how to obtain it.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Describes a clear action (Get) on a specific resource (activity summary metrics) for a single activity. It differentiates from sibling tools like get_activity_track and get_activity_samples through the word 'summary', though it does not explicitly name those alternatives.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit guidance on when to use this tool versus its siblings. The description implies usage for obtaining summary metrics of one activity, but it does not state what to use for other needs or exclude alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_activity_trackA
Get a paginated GPS track with timestamps and altitude for one activity.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| offset | No | ||
| activity_id | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the behavioral burden. It does reveal that the result is paginated and scoped to one activity, which is meaningful. However, it does not describe error behavior, auth requirements, rate limits, or what happens when an activity_id is invalid.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single front-loaded sentence conveys the core resource, pagination behavior, and relevant data fields. There is no redundant information or filler.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool is simple and has an output schema, so the description does not need to enumerate return values. Still, it lacks usage guidance and explicit details about pagination behavior or error cases, which are left to inference.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema has 0% description coverage, so the description must help interpret parameters. 'Paginated' implies limit and offset are pagination controls, and 'one activity' matches activity_id. But the description does not explain ordering, maximum limit, or the exact units or format expected.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource: 'Get a paginated GPS track with timestamps and altitude for one activity.' This is unambiguous and clearly distinguishes the tool from siblings like list_activities and get_activity_summary.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is given about when to choose this tool over alternatives such as get_activity_samples or get_activity_environment. There are no conditions, exclusions, or known alternatives mentioned.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_health_contextA
Get daily health summaries around an activity, including sleep, HRV, stress, heart rate, and SpO2.
| Name | Required | Description | Default |
|---|---|---|---|
| days_after | No | ||
| activity_id | Yes | ||
| days_before | No |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden for behavioral context. The verb 'get' and the word 'summaries' indicate a read-only operation and the scope of data, but the description does not disclose behavior around missing health data, the meaning of the surrounding window, or any rate/consistency expectations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single compact sentence that leads with the action and resource, and adds a relevant list of health metrics without unnecessary elaboration. Every word contributes to the tool's purpose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple three-parameter tool with an output schema available, the description covers the central intent and the health metrics reasonably well. It still leaves the exact day-range behavior and data-availability edge cases to inference, but these are not severe omissions given the schemas and defaults.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0% and the description does not explicitly explain activity_id, days_before, or days_after. However, 'around an activity' adds some meaning to the before/after window and the default values in the schema are reasonably self-explanatory, so it is more than a tautology but still not a full parameter explanation.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'get' and the specific resource: 'daily health summaries around an activity', and lists the included health indicators (sleep, HRV, stress, heart rate, SpO2). This makes it distinct from several siblings like get_activity_track or get_activity_environment, though it does not explicitly name a sibling within the text.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The phrase 'around an activity' provides a plausible context for when to use the tool, but no explicit when-to-use or when-not-to-use guidance is present. There is no mention of when to choose this over get_activity_summary or get_activity_samples, so the decision is left to inference.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_report_contractA
Return the stable structure and writing rules for end-user activity reports.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
There are no annotations, so the description carries the full responsibility. It clearly says the tool 'returns' a structure and rules, which implies a non-mutating retrieval. However, it doesn't disclose any details about the return format, version, caching behavior, or permissions required, though this is less critical for a 0-parameter read-like tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is one sentence of 11 words, front-loaded, with no filler or repeated information. It captures the essential behavior as precisely as possible for a simple contract-retrieval tool.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given zero parameters and the presence of an output schema, the description is complete enough for a simple contract lookup. The main gap is that it doesn't frame the relation to sibling tools such as get_report_evidence_pack, but that's a usage-guidance concern rather than a core completeness failure.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool has no parameters with an empty schema, so the description cannot need to add anything beyond what the schema already states. The baseline of 4 for 0-parameter tools is appropriate; nothing is unfilled.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses a specific verb ('Return') with a concrete resource ('stable structure and writing rules for end-user activity reports'), which strongly communicates the tool's deliverable. It distinguishes itself from all siblings (activity data, evidence packs) by focusing on the report contract itself.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No usage context or when-to-use/when-not-to-use guidance is provided. The description doesn't mention when to use this instead of siblings like get_report_evidence_pack or get_activity_summary, so the agent must infer from the tool's name and description alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_report_evidence_packA
Build deterministic facts, context, flags, and guidance for a post-activity Agent report.
| Name | Required | Description | Default |
|---|---|---|---|
| activity_id | Yes | ||
| include_environment | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries more behavioral weight. It adds one useful behavior detail: the result is deterministic, meaning the generated evidence pack is reproducible. However, it does not explain important behavioral aspects such as whether this is a read-only/resource-consuming operation, whether it can fail, or what 'flags' semantically imply for the agent.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence that is concise, front-loaded with the core action, and contains no filler. The tradeoff is that brevity omits some needed behavioral details, but the text that is present earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The output schema exists, so return values are not required in the description. Even so, the description lacks parameter-level guidance, clear exclusions, and deeper behavioral context. It is minimally usable but not fully complete for an agent that must decide among several related activity/report tools.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description was expected to compensate, and it does not explain either parameter. Still, activity_id is clearly the identifier of the target activity, and include_environment is self-descriptive enough to infer its boolean intent, giving the parameter semantics a modest baseline.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses the specific verb 'Build' and names a concrete deliverable ('deterministic facts, context, flags, and guidance for a post-activity Agent report'), so the tool's basic purpose is clear. It does not fully distinguish itself from report-related siblings like get_activity_summary or get_report_contract, so it falls short of a 5.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The phrase 'for a post-activity Agent report' provides a clear, explicit use context: call this after an activity when generating an Agent report. It does not name alternative siblings, exclude related tools, or state when not to use it, but it does convey a direct context rather than leaving usage entirely implicit.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
inspect_huawei_exportA
Check the configured Huawei export and report available source-file counts.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the burden of behavioral disclosure. 'Check' and 'report' imply a read-only inspection that returns counts rather than file contents, which is helpful, but it doesn't explicitly state side effects, required configuration, or error/edge-case behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is one concise front-loaded sentence. It delivers the action, resource, and result with no filler or unclear phrasing.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no parameters, an output schema, and a clear read-oriented purpose, the description is mostly complete. It could be slightly stronger with explicit guidance on what 'configured' means or what the counts are used for, but an agent can likely call it correctly as-is.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool takes zero parameters and the schema confirms this, so there is no parameter-semantic burden on the description. A score of 4 aligns with the baseline for zero-parameter tools.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific action ('Check') and a clear resource ('configured Huawei export') along with the concrete outcome ('report available source-file counts'). This distinguishes it from the sibling activity/health/report tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Usage context is implicitly clear: an agent should call this when it needs to verify the Huawei export and know how many source files are available. However, there is no explicit guidance on when not to use it or how it compares to the sibling tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
list_activitiesA
List imported activities. Optionally filter by running, walking, cycling, fitness, or workout.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| sport_type | No |
Output Schema
| Name | Required | Description |
|---|---|---|
| result | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the behavioral disclosure burden. The verb 'list' implies a read-only operation and the filter values add useful context, but the description does not explain default limit behavior, what a null sport_type returns, pagination, or response shape.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence that front-loads the primary action and resource, then adds the key filtering detail. There is no filler or redundant repetition of the schema.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple list tool with no required parameters and an output schema, the description is largely sufficient: it says what is listed and how to filter. Some context is left implicit, such as default limit behavior and when a caller should switch to the detail getter tools, but the schema and sibling names cover part of that gap.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema has no descriptions for its parameters, so the description adds value by enumerating the valid sport_type filter values: running, walking, cycling, fitness, or workout. However, it does not clarify the 'limit' parameter or how filtering interacts with it.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the operation ('List') and resource ('imported activities'), and gives concrete filter categories. It is distinguishable from the sibling get_activity_* tools because it describes a list view rather than a specific activity detail, though it does not explicitly contrast with those tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies the tool is for listing imported activities and optionally filtering them by sport type. It does not explicitly say when to use this tool versus get_activity_summary, get_activity_track, or other siblings, nor does it provide exclusion cases.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
9 tool updates
v0.1.0- First observed
get_activity_environment - First observed
get_activity_samples - First observed
get_activity_summary - First observed
get_activity_track - First observed
get_health_context - First observed
get_report_contract - First observed
get_report_evidence_pack - First observed
inspect_huawei_export - First observed
list_activities
TDQS
Scored across 9 tools
Each tool maps cleanly to a distinct resource or data type: Huawei source inspection, activity listing, activity summary, GPS track, samples, health context, weather environment, report evidence, and report contract. Even the health context and activity environment tools are clearly separated by source and intent.
Most tools follow a clear get_<object> pattern, such as get_activity_summary, get_activity_track, and get_report_contract. The deviations are minor: list_activities uses list instead of get, and inspect_huawei_export uses inspect, but all are still recognizable, verb-first names.
Nine tools is a well-scoped surface for an activity and report analysis server. Each tool represents a meaningful step in the workflow—from inspecting source files, listing and retrieving activity data, adding health/environment context, and producing report evidence and contract rules.
The tool set forms a complete read-only pipeline for activity reporting: find source files, list activities, fetch summary, track, samples, health context, environmental context, and then produce evidence and contract for the final agent report. There are no obvious dead ends or missing operations within this server's reporting-focused scope.
Maintenance
Related MCP Connectors
PDF, photo, email, and file comparison evidence checks with plain-language reports.
- SomviaOAuthapp.somvia
Apple Health training load, recovery, HRV and workout detail for Claude, ChatGPT and any MCP client.
Read wearables and lab health data — sleep, activity, workouts, timeseries, lab tests and orders.
Authenticated public evidence search, verification, research jobs, exports, and webhooks.
Related MCP Servers
- AlicenseAqualityAmaintenanceLocal-first MCP server that reads Apple Health export files (export.xml/zip) and exposes activity, sleep, HRV, and workout data to AI agents, keeping all data on your machine.18169 npm2MIT
- FlicenseAqualityBmaintenanceEnables AI assistants to read and analyze Google Fit exported data (activities, daily metrics, workouts, sleep) from Google Takeout, providing tools for queries, resources, and coaching prompts.6-
- AlicenseNot gradedqualityBmaintenanceEnables AI clients to query and analyze Huawei Health data, including training records, sleep, heart rate, and athletic performance, through 14 MCP tools without third-party servers.2MIT
- FlicenseAqualityCmaintenanceEnables local analysis of unstructured documents (PDF, DOCX, PPTX, SVG, PNG) by extracting text and structure with citation anchors, and verifies summaries against source material before a human approves saving a report.9-