API Documentation

Data resources and API information for developers and AI agents

Overview

SaintsFC provides structured data resources for Southampton FC information. Our site implements RFC 8288 Link headers for agent discovery and RFC 9727 API Catalog for automated API discovery.

# Link headers returned on all pages:

Link: </.well-known/api-catalog>; rel="api-catalog"; type="application/linkset+json"

Link: </api-docs>; rel="service-doc"

Link: </rss.xml>; rel="alternate"; type="application/rss+xml"

Link: </sitemap-index.xml>; rel="sitemap"; type="application/xml"

Content Negotiation

This site supports Markdown for Agents. Send an Accept: text/markdown header to receive content in Markdown format instead of HTML.

# Request markdown version:

curl -H "Accept: text/markdown" https://saintsfc.com/match-reports

# Response headers:

Content-Type: text/markdown; charset=utf-8

Agent Skills Discovery (RFC v0.2.0)

This site publishes an Agent Skills Discovery index describing callable functions for AI agents, following the Agent Skills Discovery RFC.

/.well-known/agent-skills/index.json → Agent Skills Index

# Fetch Agent Skills:

curl https://saintsfc.com/.well-known/agent-skills/index.json

Available skills include: get-match-reports, get-fixtures, get-table-standings, get-squad, get-player-stats, get-news, get-transfer-news, discover-apis

View Agent Skills

WebMCP (Web Model Context Protocol)

This site implements WebMCP to expose site tools directly to AI agents via the browser's navigator.modelContext API.

Browser Support: WebMCP is an emerging standard supported by experimental Chrome builds. When available, AI agents can call site functions directly without making HTTP requests.

# Available WebMCP Tools:

• getLatestMatchReport() - Get recent match results

• getUpcomingFixtures() - View upcoming fixtures

• getChampionshipTable() - Check league standings

• getPlayerStats() - Top scorers and player data

• getLatestNews() - Latest club news

• searchSite() - Search site content

WebMCP integrates with the Early Preview Program and enables AI agents to discover and use site functionality without server-side MCP infrastructure.

MCP Server Card (SEP-1649)

This site publishes an MCP Server Card for Model Context Protocol agent discovery, describing available resources and capabilities.

/.well-known/mcp/server-card.json → MCP Server Card

# Fetch MCP Server Card:

curl https://saintsfc.com/.well-known/mcp/server-card.json

View MCP Server Card

OAuth/OIDC Discovery

This site implements OpenID Connect Discovery and RFC 8414 for OAuth 2.0 Authorization Server Metadata.

Note: SaintsFC is a public, read-only site. No authentication is required to access any API resources. These discovery documents are provided for agent compatibility and to declare that all content is publicly accessible.

/.well-known/openid-configuration → OpenID Connect Discovery
/.well-known/oauth-authorization-server → OAuth 2.0 Server Metadata
/.well-known/oauth-protected-resource → Protected Resource Metadata (RFC 9728)
/.well-known/jwks.json → JSON Web Key Set (JWKS)

API Catalog (RFC 9727)

The API catalog implements RFC 9727 with application/linkset+json format for automated API discovery.

/.well-known/api-catalog → application/linkset+json

# Fetch API catalog:

curl -H "Accept: application/linkset+json" https://saintsfc.com/.well-known/api-catalog

View API Catalog

Data Resources

Match Reports

Complete match reports with stats, goalscorers, and analysis

/match-reports /rss.xml

Fixtures & Results

Upcoming fixtures and completed match results

/fixtures /src/content/fixtures/2025-26.md

Championship Table

Live EFL Championship standings (JSON)

/table /data/championship-standings.json

Player Stats

Player statistics and season performance data

/player-stats /squad

News Feed

Latest Southampton FC news (RSS)

/news /rss.xml

RSS Feed

Stay updated with our RSS feed containing match reports and news:

https://saintsfc.com/rss.xml

Sitemap

XML sitemap for search engine discovery:

https://saintsfc.com/sitemap-index.xml

Structured Data

We implement Schema.org structured data throughout the site:

  • Article - News and match reports
  • Person/Athlete - Player profiles
  • SportsTeam - Squad information
  • SportsEvent - Match fixtures and results
  • BreadcrumbList - Navigation structure
  • FAQPage - Frequently asked questions

Terms of Use

By accessing our data resources, you agree to our Terms of Use. Data is provided for personal and non-commercial use. Please link back to SaintsFC when using our content.