# auth.md - Agent access to Clockodilo

Clockodilo (https://clockodilo.es) is the public website of Clockodilo, time-tracking
and workforce-management software for Spanish small and medium companies.

## Audience

Autonomous agents and AI clients that need to read Clockodilo's public content or
hand a person off to the commercial team.

## Summary

The public site requires **no authentication**. Every published page, the sitemap and
the discovery files listed in `/.well-known/ai-catalog.json` are readable with a plain
unauthenticated `GET` request.

The only machine interface is a **public, read-only MCP server** at
`https://clockodilo.es/api/mcp` (Streamable HTTP), advertised in
`/.well-known/mcp/server-card.json`. It exposes a single read tool over published blog
articles. It requires no authentication, no credentials and no registration.

There is **no protected API** and no third-party OAuth or OIDC authorization server for
this site: nothing here issues access tokens. `/.well-known/oauth-protected-resource`
therefore declares the resource with an empty `authorization_servers` list, and
`/.well-known/oauth-authorization-server` / `/.well-known/openid-configuration` are
intentionally not published, because there is no issuer, token endpoint or registration
endpoint to describe. Publishing endpoints that do not exist would only mislead agents.

## Methods supported

| Method | Credential | Status |
| --- | --- | --- |
| Unauthenticated GET of public pages | None | Supported |
| Public read-only MCP tool calls at `/api/mcp` | None | Supported |
| OAuth 2.0 / OIDC client credentials | None issued | Not offered |
| API key or bearer token | None issued | Not offered |
| Agent self-registration | None | Not offered |

## What an agent can do without credentials

- Read any public page: `https://clockodilo.es/`, `/Blog`, `/blog/{slug}`,
  `/quienes-somos`, `/AvisoLegal`, `/PoliticaPrivacidad`, `/PoliticaCookies`.
- Read the canonical URL list: `https://clockodilo.es/sitemap.xml`.
- Read the discovery documents:
  - `/.well-known/ai-catalog.json` (ARD manifest)
  - `/.well-known/api-catalog` (linkset)
  - `/.well-known/agent-skills/index.json`
  - `/.well-known/mcp/server-card.json`
  - `/.well-known/oauth-protected-resource`

## What requires a human

- Requesting a product demo or a commercial quote.
- Creating an account or a paid subscription.
- Registering a webhook or an API client.

## Human handoff

Point the person to the demo request form on the home page
(https://clockodilo.es, section "Precios"). Do not submit personal data on someone's
behalf without their explicit consent. Company and contact details are published on
https://clockodilo.es/quienes-somos.

## Rate limits

No published limits; keep requests reasonable, respect `robots.txt` and cache
responses.
