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 user asked to submit/add/update a course in the catalog. Do not call submit_course for normal race-plan creation; create_race_plan does not require catalog submission. Before calling submit_course, collect and pass event metadata from official sources whenever available: main event/race name, specific course name, year/date, start time, location/city/region and country, distance, elevation gain, organizer, applicable tags/types, competitions/series, official race page, route source URL, aid-chart/regulation URLs, and other source URLs. Use metadata.event.name for the main event and metadata.event.course for the specific course (example: name='Speedgoat Mountain Races', course='50K'); do not put distance/elevation stats in the course name (bad: 'Skyrace — 32 km, +2400 m'); location must not include country because metadata.event.country is separate. Add metadata.event.types tags where they apply, and metadata.event.competitions for circuits/series/championships such as Golden Trail World Series (GTWS). Put the race start time in metadata.event.time when known. Put catalog UI event links in metadata.event.links, not just metadata.source_urls; supported types include info, registration, rules, schedule, course, cutoff, parking, bib_pickup, wardrobe, results, and contact. Include official General Information (type=info), Registration (registration), Rules/Regulations (rules), Schedule/Program (schedule), Course (course), Cut-off times (cutoff), Parking (parking), Bib pick-up (bib_pickup), Wardrobe/drop bag (wardrobe), Results (results), and Contact (contact) links when available. This metadata is important for catalog review and discoverability. Do not invent unknown values; omit unconfirmed fields rather than guessing. Use this after discovering the official route source externally, importing a real GPX/FIT/CRSProf/ZIP-with-one-GPX source, enriching waypoints/resources/cutoffs when official data is available, applying metadata, and generating segments. Do not submit reconstructed/synthetic course geometry from roadbooks, checkpoint tables, elevation profiles, aid-station lists, screenshots, or regulations; those are enrichment/context only. If route links are blocked, stop and ask the user to upload the official GPX/FIT/CRSProf/ZIP through REST artifact upload or pass inline/proxied file content. Search the CourseProfiler catalog first to avoid duplicates or to identify updates. If official waypoint/aid documents conflict or are incomplete, ask the user to confirm and include only confirmed aid stations; do not invent locations. Returns a job whose progress includes submission_id and final_crsprof_artifact_id, and whose artifacts include the final CRSProf submitted for review. Report both IDs to the user.
View input schema
{
"type": "object",
"properties": {
"original_file_name": {
"description": "Optional original route/profile file name for review metadata.",
"type": "string"
},
"submitter": {
"additionalProperties": false,
"properties": {
"email": {
"description": "Optional submitter email.",
"type": "string"
},
"name": {
"description": "Optional submitter name.",
"type": "string"
}
},
"type": "object",
"required": []
},
"race_name": {
"description": "Race/course name to submit. Assistants should search the catalog and official web sources before calling submit_course, then populate metadata.event from official sources, including metadata.event.time and metadata.event.links when available.",
"type": "string"
},
"metadata": {
"additionalProperties": false,
"properties": {
"source_urls": {
"items": {
"type": "string"
},
"description": "Official URLs used for route geometry, race page, aid chart, regulations, or other metadata evidence. This is provenance only; event links shown in the catalog UI must also be added to metadata.event.links with type/url/tooltip.",
"type": "array"
},
"event": {
"description": "Submission metadata is normalized into canonical CRSProf event fields. Supplemental fields (including year, official distance/elevation, notes, and unrecognized extensions) are retained as sourceMetadata in the submission record, not inserted into CRSProf geometry. A year alone does not invent a date; website/source URLs become event links. Important catalog metadata collected from official sources. Populate known fields such as name/event_name, course, year/date, time (race start time), location/city/region/country, distance, elevation_gain, organizer/series, website, official_source_url, types, competitions, and links. metadata.event.name is the main event name and metadata.event.course is the specific course name (for example name='Speedgoat Mountain Races', course='50K'); do not put distance/elevation stats in the course name (bad: 'Skyrace — 32 km, +2400 m'). metadata.event.location must not include country because metadata.event.country is separate. Add metadata.event.types tags when officially applicable (for example race/trail/ultra), and add metadata.event.competitions when the race belongs to a circuit/series/championship, e.g. Golden Trail World Series (GTWS). Do not invent unknown values; omit or leave null when not confirmed. For event-level links, use links with type/url/tooltip entries for General Information (info), Registration (registration), Rules/Regulations (rules), Schedule/Program (schedule), Course (course), Cut-off times (cutoff), Parking (parking), Bib pick-up (bib_pickup), Wardrobe/drop bag (wardrobe), Results (results), and Contact (contact).",
"additionalProperties": true,
"type": "object",
"properties": {
"event_name": {
"description": "Alternative main event/race name field; do not include the course/distance variant unless official.",
"type": "string"
},
"city": {
"description": "Event city, if listed separately.",
"type": "string"
},
"notes": {
"description": "Official caveats or contextual notes retained as submission provenance, not course geometry.",
"type": "string"
},
"organizer": {
"description": "Event organizer/promoter, preferably {name,url}. Do not use this for competition/series membership unless the series is also the organizer.",
"type": "object",
"additionalProperties": true
},
"course": {
"description": "specific course/distance/variant name only. Do not include distance/elevation stats such as 'Skyrace — 32 km, +2400 m'; put those in dedicated distance/elevation fields. Example: 50K.",
"type": "string"
},
"date": {
"description": "Race date, preferably YYYY-MM-DD.",
"type": "string"
},
"types": {
"items": {
"type": "string"
},
"description": "Catalog tags/types that apply from official context, e.g. race, trail, ultra, skyrunning. Add obvious tags where they apply; do not invent niche tags.",
"type": "array"
},
"series": {
"description": "Race series name, if applicable; prefer structured metadata.event.competitions for catalog submissions.",
"type": "string"
},
"elevation_gain": {
"description": "Official elevation gain, meters unless elevation_gain_unit is provided.",
"type": "number"
},
"time": {
"description": "Race start time from official sources, preferably HH:MM local time. Include this when available; it is distinct from date.",
"type": "string"
},
"distance_unit": {
"enum": [
"km",
"m",
"mi"
],
"type": "string"
},
"location": {
"description": "Event location/city/region only. Do not include country here; use metadata.event.country for country.",
"type": "string"
},
"website": {
"description": "Official race/course page URL.",
"type": "string"
},
"name": {
"description": "main event/race name, not the course/distance variant. Example: Speedgoat Mountain Races.",
"type": "string"
},
"year": {
"description": "Race year.",
"type": "integer"
},
"competitions": {
"items": {
"additionalProperties": true,
"type": "object"
},
"description": "Race series/circuit/championship memberships, separate from organizer. Example: [{name: 'Golden Trail World Series', url: 'https://www.goldentrailseries.com/'}] for GTWS races.",
"type": "array"
},
"region": {
"description": "Event region/state/province, if listed separately.",
"type": "string"
},
"links": {
"items": {
"additionalProperties": false,
"properties": {
"tooltip": {
"description": "Optional human-readable label, e.g. General Information, Registration, Rules, Schedule, Course, Parking.",
"type": "string"
},
"type": {
"description": "Event link kind. Use info for General Information, registration for Registration, rules for Rules/Regulations, schedule for Schedule/Program, course for route/course page, cutoff for cut-off information.",
"type": "string",
"enum": [
"info",
"registration",
"rules",
"schedule",
"course",
"start_line",
"parking",
"bib_pickup",
"wardrobe",
"cutoff",
"results",
"contact"
]
},
"url": {
"description": "Official URL for this event link.",
"type": "string"
}
},
"type": "object",
"required": [
"type",
"url"
]
},
"description": "Structured event-level links displayed in the catalog UI. Always add official links when available instead of only listing them in source_urls. Use type values such as info, registration, rules, schedule, course, cutoff, parking, bib_pickup, wardrobe, results, contact.",
"type": "array"
},
"country": {
"description": "Event country.",
"type": "string"
},
"distance": {
"description": "Official course distance.",
"type": "number"
},
"official_source_url": {
"description": "Primary official source URL used for event metadata.",
"type": "string"
},
"elevation_gain_unit": {
"enum": [
"m",
"ft"
],
"type": "string"
}
}
}
},
"type": "object",
"required": []
},
"course": {
"additionalProperties": false,
"properties": {
"segments": {
"additionalProperties": false,
"properties": {
"mode": {
"enum": [
"generate",
"skip"
],
"type": "string"
},
"options": {
"additionalProperties": false,
"properties": {
"instant_mode": {
"description": "Use instant segmentation mode.",
"type": "boolean"
},
"flexible_flat_max_delta": {
"description": "Allow flexible flat max-delta behavior.",
"type": "boolean"
},
"minimum_distance": {
"description": "Minimum segment distance, meters.",
"type": "number"
},
"flat_max_delta": {
"description": "Maximum elevation delta for flat segments, meters.",
"type": "number"
},
"include_routes": {
"description": "Include route geometry in generated CRSProf.",
"type": "boolean"
},
"flat_grade": {
"description": "Flat grade threshold percent.",
"type": "number"
},
"algorithm": {
"description": "Segment partitioning algorithm, e.g. SLOPE_BASED.",
"type": "string"
},
"flexible_minimum_distance": {
"description": "Allow flexible minimum-distance behavior.",
"type": "boolean"
},
"slope_change_threshold": {
"description": "Slope-change threshold percent.",
"type": "number"
}
},
"type": "object",
"required": []
}
},
"type": "object",
"required": []
},
"source": {
"properties": {
"content": {
"description": "Inline text file content for raw_file inputs, suitable for GPX/XML/JSON/USRProf.",
"type": "string"
},
"artifact_id": {
"description": "Existing CourseProfiler artifact ID, e.g. art_...",
"type": "string"
},
"kind": {
"enum": [
"url",
"artifact",
"raw_json",
"raw_file"
],
"type": "string"
},
"base64": {
"description": "Base64-encoded file bytes for raw_file inputs, suitable for FIT or other binary files.",
"type": "string"
},
"content_type": {
"description": "MIME type for inline raw_file content.",
"type": "string"
},
"file_name": {
"description": "File name for inline raw_file content, e.g. course.gpx or runner.usrprof.",
"type": "string"
},
"url": {
"description": "Fetchable public URL to a GPX, FIT, CRSProf, USRProf, or evidence file. For course inputs, prefer official direct GPX/FIT/CRSProf URLs over generic race homepages, but stop and ask the user to download/upload when the host blocks server fetches (for example 403 from Wikiloc or other route hosts). Do not synthesize course geometry from roadbooks, checkpoint tables, or elevation profiles.",
"type": "string",
"format": "uri"
},
"payload": {
"description": "Inline raw JSON payload for CRSProf/USRProf-compatible inputs.",
"type": "object",
"additionalProperties": true
}
},
"additionalProperties": true,
"type": "object",
"required": [
"kind"
]
},
"crsprof_artifact_id": {
"description": "Existing converted CRSProf artifact ID to submit after optional metadata/enrichment/segmentation.",
"type": "string"
},
"waypoints": {
"additionalProperties": false,
"properties": {
"source_ref": {
"description": "Optional source reference for parsed waypoint rows.",
"type": "string"
},
"distance_unit": {
"enum": [
"km",
"m",
"mi"
],
"type": "string"
},
"mode": {
"description": "Use structured for reliable AI workflows.",
"type": "string",
"enum": [
"structured",
"table"
]
},
"start_time": {
"description": "Optional race start time used when parsing absolute cutoffs.",
"type": "string"
},
"table_url": {
"description": "Public URL to an aid-station table for best-effort parsing; verify results. If official documents disagree or exact aid locations are not listed, ask the user to confirm rather than inventing missing aid stations.",
"type": "string"
},
"items": {
"items": {
"additionalProperties": false,
"properties": {
"distance_unit": {
"enum": [
"km",
"m",
"mi"
],
"type": "string"
},
"cutoff": {
"description": "Elapsed cutoff time HH:MM, if known.",
"type": "string"
},
"resources": {
"items": {
"enum": [
"water",
"water_source",
"drinks",
"fruit",
"food",
"toilet",
"medic",
"chrono",
"crew",
"pacer",
"car",
"bus",
"ambulance",
"shuttle",
"telecabine",
"drop_bag",
"withdrawal",
"binoculars",
"hot_meal",
"tent",
"showers",
"changing_room",
"physiotherapy",
"rest_area",
"start_flag",
"finish_flag"
],
"type": "string"
},
"description": "Canonical aid/resources available here. Unsupported/free-text strings are ignored with warnings; preserve non-canonical details in note/source text.",
"type": "array"
},
"name": {
"description": "Waypoint, aid station, checkpoint, start, or finish name.",
"type": "string"
},
"distance": {
"description": "Distance from start.",
"type": "number"
},
"cutoff_kind": {
"enum": [
"in",
"out",
"leave"
],
"type": "string"
},
"kind": {
"enum": [
"start",
"finish",
"aid",
"checkpoint",
"water",
"crew",
"other"
],
"type": "string"
}
},
"type": "object",
"required": [
"name",
"distance"
]
},
"type": "array"
},
"text": {
"description": "Raw aid-station table text for best-effort table parsing.",
"type": "string"
}
},
"type": "object",
"required": [
"mode"
]
},
"import_options": {
"additionalProperties": false,
"properties": {
"include_routes": {
"description": "Include routes when analysing GPX/FIT. Existing CRSProf is preserved with analysis_options_not_applied warning.",
"type": "boolean"
},
"include_segments": {
"description": "Generate segments when analysing GPX/FIT. Existing CRSProf is preserved with analysis_options_not_applied warning.",
"type": "boolean"
}
},
"type": "object",
"required": []
}
},
"type": "object",
"required": []
},
"course_file": {
"description": "Inline/proxied GPX, FIT, CRSProf, or ZIP-with-one-GPX file object to import. Use content for text GPX/XML/JSON/CRSProf or base64 for FIT/ZIP/binary. Bare local filesystem paths and file:// URLs are rejected.",
"additionalProperties": false,
"type": "object",
"properties": {
"base64": {
"description": "Base64-encoded file bytes for FIT or other binary files.",
"type": "string"
},
"content_type": {
"description": "MIME type for the file.",
"type": "string"
},
"name": {
"description": "Original file name, e.g. course.gpx or runner.usrprof.",
"type": "string"
},
"url": {
"description": "Fetchable HTTPS URL to file bytes. Do not use file:// or bare local paths. ZIP is accepted only when it contains exactly one GPX file.",
"type": "string",
"format": "uri"
},
"file_name": {
"description": "Original file name, e.g. course.gpx or runner.usrprof.",
"type": "string"
},
"content": {
"description": "Inline text file content for GPX/XML/JSON/USRProf.",
"type": "string"
}
}
}
},
"required": [
"course"
],
"additionalProperties": false
}