API

Everything published on IT Support Directory is also available to machines: a read-only JSON API, two Atom feeds, an llms.txt file, and an MCP server for AI agents and answer engines. All of them read from the same data as the pages, all of them are free, and none of them need an API key.

JSON API

The API is versioned at /api/v1. Every response is JSON with a {data, meta} envelope, snake_case fields and ISO 8601 dates. Every response carries Cache-Control: public, max-age=300, Access-Control-Allow-Origin: * and X-Robots-Tag: noindex. There is no authentication and no write endpoint. A missing resource returns HTTP 404 with {error: {code, message}}.

Method and path	Returns
GET /api/v1/areas	Every UK region, county and council area, with its parent and published provider count
GET /api/v1/areas/{slug}?service=	One area with its Featured, local and nationwide providers
GET /api/v1/providers?q=&area=&service=&page=	Search results by rating, 20 per page, with a total count
GET /api/v1/providers/{slug}	One provider: contact, areas served, services, accreditations, facts, nearby providers and review summary
GET /api/v1/openapi.json	The OpenAPI 3.1 document, machine-readable

A provider's review_summary is an average, a count and a star distribution, never an individual review or a reviewer's identity.

Try it

curl "https://itsupport.directory/api/v1/providers?area=glasgow&service=cyber-security"
curl https://itsupport.directory/api/v1/areas/kent
curl https://itsupport.directory/api/v1/areas

The full, hand-written schema is at /api/v1/openapi.json.

Feeds

/feed.xml lists published providers in order of most recently updated, and /reviews/feed.xml lists newly published reviews (rating and provider only, never a reviewer's name). Both are Atom 1.0, 50 entries, cached for one hour.

llms.txt

/llms.txt is a short plain-text index of every area with providers and every provider, for an agent that wants an overview before it fetches anything else. /llms-full.txt adds each provider's description, areas served, services, accreditations, facts and review summary, so an agent can often answer a question from this one file. Both are generated on request and cached for one hour.

Connect an AI agent

https://itsupport.directory/mcp is a read-only MCP server (Streamable HTTP, no session, no authentication). It offers four tools: list_areas, search_providers (q, area, service, page), get_provider (slug) and get_nearby_providers (slug), each returning the same JSON as the API above. There is nothing to configure and nothing it can write.

Most MCP clients take a URL directly:

{
  "mcpServers": {
    "itsupport-directory": {
      "type": "http",
      "url": "https://itsupport.directory/mcp"
    }
  }
}