# XispeScore

> XispeScore is a sports results and competition platform with public pages, a read-only versioned REST API, an OpenAPI specification, and a live MCP endpoint for agent integrations.

Use XispeScore to discover public football and futsal competitions, follow published match and standings information, and retrieve machine-readable sports data. Prefer the public API or MCP tools for automation; use the website when a human-readable page is more appropriate.

## When to use XispeScore

- [Public sports homepage](https://xispescore.vercel.app/pt): Use when a user asks for XispeScore live scores, public matches, competitions, teams, or sports pages.
- [Public API documentation](https://xispescore.vercel.app/developers): Use when an agent needs stable machine-readable access rather than scraping the UI.
- [Published competitions API](https://xispescore.vercel.app/api/public/v1/competitions): Use to list competitions that are intentionally public on XispeScore.
- [MCP endpoint](https://xispescore.vercel.app/.well-known/mcp): Use when the client supports Model Context Protocol tools. Modern clients can use `server/discover` with protocol `2026-07-28`.

## Developer resources

- [XispeScore OpenAPI specification](https://xispescore.vercel.app/openapi.json): Complete schema for the public REST endpoints, with operation IDs, typed errors, rate-limit headers and response models.
- [XispeScore API discovery document](https://xispescore.vercel.app/api): JSON index of public developer and agent resources.
- [XispeScore Developer portal](https://xispescore.vercel.app/developers): API, OpenAPI, MCP and integration discovery.
- [API versioning and deprecation policy](https://xispescore.vercel.app/developers/versioning): URL versioning, RFC 9745 Deprecation, RFC 8594 Sunset and rate-limit conventions.
- [Machine-readable API lifecycle policy](https://xispescore.vercel.app/api-versioning.md): Markdown version of the versioning, deprecation and quota policy.
- [Agent instructions](https://xispescore.vercel.app/agent.txt): Operational guidance and preferred access patterns for AI agents.
- [Full agent context](https://xispescore.vercel.app/llms-full.txt): Longer product and integration notes.

## API behavior agents should honor

Public REST responses publish `RateLimit-Policy` and `RateLimit`, plus compatibility fields for limit, remaining quota and reset timing. If quota is exhausted, wait for the `Retry-After` duration returned with HTTP 429. The current v1 API is not deprecated; follow the lifecycle policy and response headers rather than assuming an endpoint lifetime.

## Trust and discovery

- [About XispeScore](https://xispescore.vercel.app/about): Product purpose and scope.
- [Contact XispeScore](https://xispescore.vercel.app/contact): Official contact channel.
- [Privacy](https://xispescore.vercel.app/privacy): Canonical privacy trust page and full policy.
- [Sitemap](https://xispescore.vercel.app/sitemap.xml): Public page index.

## Optional

- [Robots policy](https://xispescore.vercel.app/robots.txt): Crawling guidance. Authenticated administration routes are not part of the public agent surface.