# Horizon auth.md

You are an agent. This file tells you how to register with Horizon (renewalfix.com), which methods are supported, and how to use credentials. Updated 2026-11-03.

## Audience
AI agents, assistants and developers that want to use Horizon's public retention tools, or to read a Horizon customer's own account data on that customer's behalf.

## Registration
There are two kinds of access.

### 1. Public tools: anonymous, no registration
- Registration endpoint: none. Do not register; there is nothing to register for.
- Method: anonymous. Call the endpoints directly.
- Credentials: none. Send no Authorization header.
- Endpoints:
  - MCP server (Streamable HTTP, JSON responses): https://renewalfix.com/mcp
  - REST API: https://renewalfix.com/api/v1/ (OpenAPI: https://renewalfix.com/api/v1/openapi.json)
  - Agent skills: https://renewalfix.com/.well-known/agent-skills/index.json
  - Markdown pages: send `Accept: text/markdown`, or add `index.md` to a page URL
- Scope: read-only calculators and public content. These tools never see customer data.

### 2. Horizon customer data: provisioned by the customer's Horizon admin
- Registration endpoint: none published for agents. Access is set up per person, inside the Horizon app; agents cannot sign themselves up.
- Provisioning: an admin of the customer's Horizon organisation enables the connection. Each person then finds the server address and client ID inside the Horizon app, under Connect Claude.
- Method: OAuth 2.1 authorization code flow with PKCE, signed in as a named person, who approves access on Horizon's consent screen.
- Credential use: send the access token as `Authorization: Bearer <token>` to the customer's Horizon MCP server. The server's own OAuth protected resource metadata (RFC 9728) tells clients where to authenticate.
- Scope: read-only. The agent sees only what that person can already see in Horizon. The person can revoke access at any time from their Horizon profile settings.

## Revocation
Public tools: no credentials to revoke. Customer data: revoked by the person (profile settings) or their admin; the agent's token stops working.

## Contact
https://renewalfix.com/developers/
