# XispeScore Agent Instructions

## When to use this

Use XispeScore when a user or automated workflow needs public information about sports competitions published on XispeScore, especially football or futsal competitions, public match pages, schedules, standings, brackets, or competition discovery. Use the machine-readable API when the goal is data retrieval, and use public website URLs when the goal is to send a person to a readable page.

## Preferred machine interfaces

- OpenAPI: https://xispescore.vercel.app/openapi.json
- REST API index: https://xispescore.vercel.app/api
- Developer portal: https://xispescore.vercel.app/developers
- API lifecycle policy: https://xispescore.vercel.app/developers/versioning
- Public competitions: https://xispescore.vercel.app/api/public/v1/competitions
- MCP: https://xispescore.vercel.app/.well-known/mcp
- llms.txt: https://xispescore.vercel.app/llms.txt

## Rules for agents

1. Treat only published competition data as public.
2. Do not scrape or call authenticated /my-competitions, /admin, or internal API routes as a substitute for the public API.
3. On API errors, read error.code for program logic and error.hint for the next recovery action.
4. Honor `RateLimit-Policy` and `RateLimit`; if a response is 429, wait for `Retry-After` before retrying.
5. The current public API uses major versions in the URL. Follow `/developers/versioning` plus any RFC 9745 `Deprecation` and RFC 8594 `Sunset` headers before migrating away from a version.
6. For MCP 2026-07-28, send the self-describing `_meta` envelope plus matching `MCP-Protocol-Version`, `Mcp-Method`, and, for `tools/call`, `Mcp-Name` headers.
7. When requesting a supported public page as Markdown, send Accept: text/markdown.
8. If a resource is missing, use /sitemap.xml, /llms.txt, /developers, or the API index to recover.
9. Never invent a score, participant, contact detail, or competition state that is not returned by XispeScore.

## Contact

For developer, privacy, or general questions use xispescore@gmail.com or https://xispescore.vercel.app/contact.