Developers

Everything on subcore.ai is available programmatically. No API key, no sign-up, no tiers — the same content the site renders is served as JSON, as markdown, and over the Model Context Protocol.

REST API

Base URL: /api/v1. Unauthenticated.

• GET /pages — every public page
• GET /pages/{slug} — one page, including its markdown body
• GET /products — products and platform components
• GET /search?q= — ranked full-text search
• GET /company — company profile and agent interfaces
• POST /contact — send a demo request

curl "https://subcore.ai/api/v1/search?q=guardrails&limit=3"

Errors share one envelope. Lists paginate with limit and offset and return a next_url. Search and the contact endpoint are metered per client and send RateLimit-* headers; the cached reads are not metered and send none. POST /contact accepts an Idempotency-Key so a retry is recognised rather than delivered again.

OpenAPI

The full contract, with every schema and example: openapi.json.

MCP server

Model Context Protocol over Streamable HTTP at /api/mcp, also reachable at /mcp. No authentication.

{ "mcpServers": { "subcore-ai": { "type": "streamable-http", "url": "https://subcore.ai/api/mcp" } } }

Six tools: list_pages, get_page, search_content, list_products, get_company_info and request_demo. Every page is also exposed as a markdown resource, and two ui:// views let MCP Apps hosts render products and search results inline.

Connection details: mcp.json · Server card: server-card.json

Markdown and agent indexes

• llms.txt — curated index, including when to use this site and when not to
• llms-full.txt — every page in one response
• Any page as markdown by appending .md, e.g. /core0/agents.md
• ard.json — agentic resource catalog
• agent-skills/index.json — published skills

Versioning and deprecation

The version is in the path. /api/v1 is current and not deprecated. Breaking changes ship as /api/v2; a retired version keeps serving for at least six months and carries Deprecation, Sunset and a successor-version Link header on every response. Their absence means the version is current.

Support

Questions about the API: support@subcore.ai, or the contact form.