This page is the human-readable hub. The documents agents actually fetch live
at well-known URLs (and /auth.md at the site root, for the Auth.md
convention). Source for those files is in this repo under agents/.

Start here

  1. Register. A human creates a workspace at
    my.node.uk/signup, then mints a gateway
    credential per agent.
  2. Read auth. /auth.md (also mirrored at
    /agents/auth.md).
  3. Call the gateway. OpenAI-compatible API at
    https://api.node.uk, or the read-only MCP tools at
    https://api.node.uk/mcp.

Discovery documents

URL What
/auth.md Registration and client_credentials flow
/.well-known/oauth-protected-resource RFC 9728 (this origin; resource = https://node.uk)
api.node.uk/.well-known/oauth-protected-resource RFC 9728 for the gateway
/.well-known/api-catalog RFC 9727 linkset
/.well-known/mcp/server-card.json MCP Server Card pointing at api.node.uk/mcp
/.well-known/agent-skills/ Agent Skills index
/llms.txt Site summary for LLMs
/ai/ai-gateway/ Human product page for the gateway

MCP tools (public, read-only)

Connect a Streamable HTTP MCP client to https://api.node.uk/mcp:

  • list_models: live catalogue from GET /api/v1/models
  • list_products: public Hosting-for-X products
  • get_auth_instructions: pointers to auth.md and OAuth metadata

Billable chat completions stay on the OpenAI-compatible paths under
/api/v1/models/{id}/... with a Bearer token.