CourseProfiler
Race course profiling, catalog search, course submission, and personalized race plans.
| Endpoint | https://courseprofiler.com/mcp (streamable-http) |
|---|---|
| Registry version | 0.1.0 |
| Now | 26 tools · grade F (15) · pin ts_006670921a9afcef714648c3936dba79 · protocol 2025-06-18 |
| First / last listed | 2026-11-01 02:44 UTC / 2026-11-01 02:44 UTC |
| Grade over time | 2026-11-01: F (15), 26 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: create_race_plan search_race_catalog import_course enrich_course_waypoints generate_course_segments generate_runner_profile submit_course get_course_submission_requirements get_race_plan_requirements get_runner_profile_requirements get_artifact_upload_requirements get_job get_artifact validate_course_profile validate_runner_profile export_race_plan_pdf build_runner_profile_from_strava analyze_activity inspect_analysis compare_execution inspect_runner_profile assess_finish_time_goal compare_pacing_strategies import_profile_attachment get_storage_readiness get_activity_submission
create_race_plan | Primary CourseProfiler tool for creating a personalized race plan and optional PDF. Use this after obtaining both a course input and runner input. Course input may be course_file, course.source with kind=url/artifact/raw_file, or course.crsprof_artifact_id. Do not use raw_json or reconstruct/synthesize a course from roadbooks, checkpoint tables, elevation profiles, aid-station lists, or screenshot params: course_file, course, runner, race_name, estimate, runner_profile_file, pdf |
search_race_catalog | Search CourseProfiler's race catalog by race/course name and return direct CRSProf URLs that can be used as course sources. params: query*, limit |
import_course | Import a fetchable official GPX/FIT/CRSProf URL, official ZIP containing exactly one GPX, uploaded source_file artifact, raw JSON payload, or inline/proxied course_file into a CRSProf artifact. Third-party route hosts such as Wikiloc may return 403 to server fetches; when a URL is blocked, ask the user to download/upload the file through POST /api/artifact-uploads outside MCP and pass the returned params: options, course_file, source |
enrich_course_waypoints | Add structured aid stations, checkpoints, cutoffs, and canonical resources to a CRSProf artifact that lacks them. Before enriching, inspect whether the imported source already contains GPX/CRSProf waypoints; if it already contains GPX/CRSProf waypoints, avoid duplicate Start/Finish/aid stations and prefer merging/updating resources, cutoffs, notes, or links on existing waypoint metadata. Prefer wa params: crsprof_artifact_id*, waypoints* |
generate_course_segments | Generate analytical course segments from an enriched CRSProf artifact after waypoint enrichment, or from a catalog CRSProf that already contains official waypoints/resources/cutoffs; then use the resulting artifact in create_race_plan for race planning, or call submit_course if and only if the user asked to submit a course for catalog review. A generated CRSProf artifact is not a catalog submissio params: crsprof_artifact_id*, options |
generate_runner_profile | Generate a segment-evidence USRProf runner profile artifact from uploaded runner evidence or an existing .usrprof source. Confirm profile purpose and evidence selection only if not already explicit. Do not silently use every local file. profile_intent is advisory: the server does not filter sources. Evidence supports pacing, durability, terrain fit, uphill running limits, and confidence; get_runne params: sources*, import_options, profile_intent |
submit_course | Submit an official/trusted course for CourseProfiler catalog review. This is the only MCP tool that creates a catalog-review submission; import_course, enrich_course_waypoints, and generate_course_segments only create temporary artifacts. A final CRSProf artifact is not a submission. If there is no submission_id in the submit_course result, the course has not been submitted. Use this only when the params: course*, metadata, race_name, submitter, original_file_name, course_file |
get_course_submission_requirements | Use this before submit_course when the user gives only a race name or incomplete inputs. Returns the catalog-first course submission workflow, accepted route sources, metadata, waypoint enrichment, and upload requirements. params: race_name, known_course_url, has_waypoint_data |
get_race_plan_requirements | Use this before create_race_plan when the user gives only a race name or incomplete inputs. Returns the required course and runner inputs and the next steps an assistant should take, including catalog matches when available. params: race_name, known_course_url, has_runner_profile |
get_runner_profile_requirements | Use this when runner input is missing or unclear. Explains how to obtain or generate runner input, what USRProf/evidence files should contain, whether GPX/FIT activities are enough, and how hosted MCP clients should upload artifacts. params: none |
get_artifact_upload_requirements | Use this when an assistant needs instructions for CourseProfiler's REST artifact upload flow or needs to explain why hosted MCP cannot upload bare local paths. This is an instruction helper, not a raw-byte MCP upload tool. params: none |
get_job | Poll a CourseProfiler async job by job_id. params: job_id* |
get_artifact | Fetch artifact metadata and a private short-lived download URL by artifact_id. Artifact download URLs are private and short-lived; share them only with the user, verbatim in a code block, not a clickable link. Ask the user to copy the entire URL into their browser address bar. Do not rewrite the URL or add tracking parameters such as utm_source: changes invalidate the signature. If expired, call g params: artifact_id* |
validate_course_profile | Validate a CRSProf artifact or inline CRSProf JSON before race planning or catalog submission. This does not mutate artifacts or submit courses. params: crsprof, crsprof_artifact_id |
validate_runner_profile | Validate a USRProf artifact or inline USRProf JSON before creating personalized race plans. This does not mutate artifacts or generate a new profile. params: usrprof, usrprof_artifact_id |
export_race_plan_pdf | Export a Hi-Fi PDF or standalone checkpoint card from an existing CRSProf artifact. The CRSProf supplies the course/profile/plan data; options are presentation-only overrides such as title, subtitle, metric/imperial unit system, format, and file name. Omit unit_system unless the user explicitly asks for metric or imperial. params: crsprof_artifact_id*, options |
build_runner_profile_from_strava | Build a USRProf from Strava activities selected for a target course or distance. Ask the user for the target course or distance and, when an existing profile is supplied, explicitly ask whether to merge or replace. Strava credentials are never accepted through MCP: this tool returns a private one-hour browser authorization URL and resumes the same job after authorization. If evidence is insufficie params: decision, resume_job_id, course_file, target_distance_m, existing_usrprof_artifact_id, course, filters, existing_profile_strategy |
analyze_activity | Analyze supplied GPX/FIT directly with the browser's canonical pipeline; no catalog search or runner profile is needed. Accept inline course_file, URL, or artifact source. Existing CRSProf is preserved and summarized. Returns job plus a bounded structured summary, units, missing-data warnings and complete CRSProf artifact. Defaults: moving threshold 0.25 m/s, minimum stop 30 s, merge distance 60 m params: course_file, idempotency, source, options |
inspect_analysis | Read an existing v3 CRSProf artifact without reanalysis or downloading source points. Query segments, splits, climbs, stops, range, or quality. Pages default to 20 rows (maximum 100); follow next_offset and total_matches. Distances are metres and times seconds. Climbs group existing UP movement rows, with dwell separate. Missing/UNKNOWN terrain uses the browser grade policy (gain-loss)/distance an params: axis, to_m, limit, from_m, min_duration_seconds, sort, artifact_id*, offset, duration_metric, query* |
compare_execution | Compare plan and execution v3 CRSProf artifacts with the full browser canonical comparison pipeline. Association defaults to 60 metres; override stop_association_distance_m only when requested. This does not redetect stops: use analyze_activity on original GPX/FIT to change detection. Returns job and bounded summary: first 20 splits/stops, quality, and server-owned findings shared with the UI. Lar params: stop_association_distance_m, plan_artifact_id*, execution_artifact_id* |
inspect_runner_profile | Read an existing USRProf or uploaded USRProf source artifact without reconstruction, scope replacement or model activation. For chat attachments without artifact IDs, first use import_profile_attachment with explicit upload permission if host file handoff is available; otherwise offer the browser upload page immediately. Do not substitute raw-file commentary for this canonical inspection. Required params: offset, usrprof_artifact_id*, limit, query*, course_artifact_id |
assess_finish_time_goal | Assess a positive elapsed goal including saved dwell using the existing nine intensity/shape combinations (5% shapes). Preserve reference-plan movement locks, stops, checkpoint windows, cutoffs and saved GAP settings. Requires current v3 course and runner artifact IDs. Defaults to load_response_evidence_v2 and allow_profile_preparation=false; experimental v3 and in-memory preparation require expli params: course_artifact_id*, usrprof_artifact_id*, estimation_model, allow_profile_preparation, target_elapsed_seconds* |
compare_pacing_strategies | Compare all nine existing intensity/shape combinations without an elapsed goal. split_percent defaults to 5, inclusive range 0-15. Preserve reference-plan locks, dwell, checkpoint windows, cutoffs and saved GAP settings. Requires current v3 course and runner artifact IDs. Defaults to load_response_evidence_v2 and allow_profile_preparation=false; experimental v3 and in-memory preparation require ex params: course_artifact_id*, usrprof_artifact_id*, estimation_model, allow_profile_preparation, split_percent |
import_profile_attachment | Store an attached USRProf or CRSProf unchanged as a private source_file artifact (maximum 25 MiB). Prefer this for ChatGPT attachments when file handoff is available; do not ask the user to copy artifact IDs. Obtain explicit permission to send the selected file to CourseProfiler before setting upload_authorized=true. Use the host-provided file object, never invent a download URL or pass a sandbox/ params: upload_authorized*, file*, profile_type* |
get_storage_readiness | Read-only non-secret storage diagnostic. Default checks configuration only. check_bucket=true performs HeadBucket; never writes test objects. Bucket access does not verify job/artifact reads or writes. params: check_bucket |
get_activity_submission | Read-only lookup of an opt-in analyze_activity submission using the same caller/key. No URL fetches, writes or reanalysis. outcome_unknown is not absence and never authorizes a fresh execution. Requires durable idempotency enabled; private caller_token required for anonymous callers. params: idempotency* |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.