Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.etonecarg.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Response Envelopes and Partials

Sports MCP Server is explicit by design. A response can succeed and still tell you that one section was missing, ambiguous, or unsafe to enrich.

​
Read the envelope before you deepen

FieldWhy it matters
meta.partialTells you the answer is usable but incomplete
meta.missingSectionsLists which parts of a bundle answer were intentionally not filled
meta.sourcesPreserves provenance across sports truth, program connectivity, current-state checks, and fallback evidence
meta.crosswalkConfidenceTells you whether cross-provider enrichment is safe for the selected result
meta.agentHints.recommendedNextToolsGives the host ordered, non-binding next-step hints
meta.agentHints.disambiguationOptionsHelps you ask a narrowing question without guessing
meta.limitationsExplains known gaps, ambiguity, or upstream constraints

​
How to respond in the host

A successful response with partial: false is usually safe to render directly.Good host behavior:
  • render the answer
  • preserve meta.sources for observability or QA
  • keep meta.agentHints.recommendedNextTools available only if the user drills down

​
Treat crosswalk confidence as a numeric workflow signal

BandMeaningSafe host behavior
0.90-1.00High confidenceCross-provider enrichment may proceed when the product job requires it
0.60-0.89Mixed confidenceDo not silently deepen across providers; narrow scope or stay inside one source family
0.01-0.59Low confidenceDo not automatically cross providers
nullNo safe crosswalkDo not assume linkage at all

​
Example response shapes

Partial bundle
{
  "meta": {
    "partial": true,
    "missingSections": ["watchAvailability"],
    "sources": [
      { "provider": "gsd_lookup", "role": "primary" },
      { "provider": "on_availability", "role": "secondary" }
    ],
    "crosswalkConfidence": null,
    "limitations": [
      "Watchability enrichment was skipped because cross-provider linkage was not strong enough."
    ],
    "agentHints": {
      "recommendedNextTools": ["get_watch_availability", "list_programs_for_entity"],
      "disambiguationOptions": []
    }
  },
  "data": {}
}

​
Read this next