Skip to main content

Crate mcp_equidia_rs

Crate mcp_equidia_rs 

Source
Expand description

§Equidia MCP and CLI

This crate provides a standalone read-only Equidia API executable and its run entry point. A shared catalogue validates inputs for the CLI, MCP stdio and MCP Streamable HTTP. It covers 60 public GET routes, with 11 short aliases and offline discovery: 72 MCP tools in total. No Equidia credentials are used.

§Installation

After the first crates.io publication:

cargo install mcp-equidia-rs --locked
mcp-equidia-rs --help

For a source checkout, use cargo install --path . --locked. Release archives and container images are described in the distribution guide.

§Read racing data

mcp-equidia-rs meetings --date 2026-11-11
mcp-equidia-rs races --date 2026-11-11 --items-per-page 5
mcp-equidia-rs race --guid 20261111_STR_1
mcp-equidia-rs runners --race-guid 20261111_STR_1
mcp-equidia-rs call equidia_horse --args '{"uuid":"HORSE_UUID"}'

Start with meetings and races, then use the returned UUIDs or GUIDs for related resources. Dates use YYYY-MM-DD; pagination is explicit. Responses preserve upstream data inside a JSON envelope with source, request URL, status and byte count metadata. Media URLs remain metadata and are not downloaded.

§Inspect the catalogue offline

mcp-equidia-rs tools
mcp-equidia-rs schema runners
mcp-equidia-rs api-catalog --query horse

The bundled catalogue is derived from the 2026-11-11 OpenAPI snapshot, reviewed for anonymous access. Credential-dependent routes and non-JSON document retrieval are excluded. Tool discovery and startup do not download the contract.

§MCP transports

With no command the executable starts MCP stdio; serve stdio is equivalent. Diagnostics go to stderr and MCP messages use stdout.

mcp-equidia-rs --no-env-file serve stdio
MCP_HTTP_TOKEN='choose-a-listener-token' mcp-equidia-rs serve http

Streamable HTTP uses /mcp; /health reports process liveness. Optional Prometheus metrics use /metrics. The listener token protects this MCP server and is never forwarded to Equidia. Non-loopback bindings require it. Native TLS, mTLS, host/origin allowlists and graceful shutdown are supported.

§Configuration and failures

CLI flags override process environment, then the optional dotenv file, then defaults. --no-env-file disables dotenv loading. EQUIDIA_ENABLED_TOOLS limits the exact exposed MCP tool names. Requests have deadlines, bounded response sizes, bounded concurrency and transient retries; redirects are refused.

Use doctor to check local configuration and doctor --live to probe meetings. CLI errors set a nonzero exit status. MCP tool execution failures return an error result; unknown tool names are invalid parameters. Empty upstream arrays are successful responses and do not imply that matching data exists.

The public Rust API is the process entry point run; API queries are exposed through the CLI and MCP tools. The README documents all environment variables, deployment examples and the current test evidence.

§Read tool reference

Generated from the bundled Equidia OpenAPI snapshot (2026-11-11). All canonical tools use GET.

ToolEndpointRequired arguments
equidia_get_broadcast_meetings_by_date_editorial/api/broadcast/meetings/{date}/editorialdate
equidia_get_broadcast_meetings_by_guid_editorial/api/broadcast/meetings/{guid}/editorialguid
equidia_get_broadcast_races_by_guid_editorial/api/broadcast/races/{guid}/editorialguid
equidia_get_broadcast_tickets_by_guid/api/broadcast/tickets/{guid}guid
equidia_get_desk_race_clipping/api/desk/race-clipping—
equidia_get_hexaglobe_live_streams/api/hexaglobe/live-streams—
equidia_get_mobile_daily_predictions/api/mobile/daily-predictions—
equidia_get_mobile_horse/api/mobile/horse—
equidia_get_mobile_horse_stats/api/mobile/horse-stats—
equidia_get_mobile_last_programmings/api/mobile/last-programmings—
equidia_get_mobile_live_streams/api/mobile/live-streams—
equidia_get_mobile_meetings/api/mobile/meetings—
equidia_get_mobile_race/api/mobile/race—
equidia_get_mobile_race_quinte/api/mobile/race-quinte—
equidia_get_mobile_races/api/mobile/races—
equidia_get_mobile_races_by_family_discipline/api/mobile/races-by-family-discipline—
equidia_get_mobile_races_by_highlight/api/mobile/races-by-highlight—
equidia_get_mobile_races_by_meeting/api/mobile/races-by-meeting—
equidia_get_mobile_races_by_meeting_number/api/mobile/races-by-meeting-number—
equidia_get_mobile_races_pulling/api/mobile/races-pulling—
equidia_get_mobile_runner/api/mobile/runner—
equidia_get_mobile_runner_by_trainer_or_rider/api/mobile/runner-by-trainer-or-rider—
equidia_get_mobile_runners/api/mobile/runners—
equidia_get_mobile_runners_analyse/api/mobile/runners-analyse—
equidia_get_mobile_runners_by_horse/api/mobile/runners-by-horsehorse-uuid
equidia_get_mobile_social_prono/api/mobile/social-prono—
equidia_get_ordonnanceur_batch_favorite_runner/api/ordonnanceur/batch-favorite-runner—
equidia_get_pro_live_streams/api/pro/live-streams—
equidia_get_tv_epg/api/tv/epg—
equidia_get_tv_last_episodes/api/tv/last-episodes—
equidia_get_tv_last_quinte/api/tv/last-quinte—
equidia_get_tv_live_streams/api/tv/live-streams—
equidia_get_tv_meetings/api/tv/meetings—
equidia_get_tv_race/api/tv/race—
equidia_get_tv_races_by_meeting/api/tv/races-by-meeting—
equidia_get_tv_shows/api/tv/shows—
equidia_get_v2_articles/api/v2/articles—
equidia_get_v2_categories/api/v2/categories—
equidia_get_v2_editorial_contents/api/v2/editorial-contents—
equidia_get_v2_image_parts/api/v2/image-parts—
equidia_get_v2_image_parts_by_id/api/v2/image-parts/{id}id
equidia_get_v2_medias/api/v2/medias—
equidia_get_v2_meetings/api/v2/meetings—
equidia_get_v2_meetings_by_guid/api/v2/meetings/{guid}guid
equidia_get_v2_optiweb/api/v2/optiwebstart, end
equidia_get_v2_pre_runners/api/v2/pre-runners—
equidia_get_v2_rundowns/api/v2/rundowns—
equidia_get_v2_rundowns_by_uuid/api/v2/rundowns/{uuid}uuid
equidia_get_v2_runners/api/v2/runners—
equidia_get_v2_runners_by_uuid/api/v2/runners/{uuid}uuid
equidia_get_v2_segments/api/v2/segments—
equidia_get_v2_segments_by_id/api/v2/segments/{id}id
equidia_get_v2_stable_noise/api/v2/stable-noise—
equidia_get_v2_subscriptions/api/v2/subscriptions—
equidia_get_v2_subscriptions_by_id/api/v2/subscriptions/{id}id
equidia_get_v2_tags/api/v2/tags—
equidia_get_v2_user_optiwebs/api/v2/user-optiwebs—
equidia_get_v2_users/api/v2/users—
equidia_get_v2_users_by_uuid/api/v2/users/{uuid}uuid
equidia_get_web_article_mobile/api/web/article-mobileslug

§Common aliases

AliasCanonical tool
equidia_racesequidia_get_mobile_races
equidia_meetingsequidia_get_mobile_meetings
equidia_raceequidia_get_mobile_race
equidia_runnersequidia_get_mobile_runners
equidia_horseequidia_get_mobile_horse
equidia_horse_statsequidia_get_mobile_horse_stats
equidia_predictionsequidia_get_mobile_daily_predictions
equidia_live_streamsequidia_get_mobile_live_streams
equidia_tv_scheduleequidia_get_tv_epg
equidia_articlesequidia_get_v2_articles
equidia_tagsequidia_get_v2_tags

equidia_api_catalog searches enabled reads locally. Use schema TOOL or tools for full parameter descriptions, enums, types and limits.

Functions§

run
Run the CLI or MCP server using process arguments and environment.