# Public developer resources

Source: https://ethicsportal.eu/developers/public-resources/

These resources describe EthicsPortal and its published documentation. They do not grant access to customer organisations or reports.

| Resource                                    | Address                                                 |
| ------------------------------------------- | ------------------------------------------------------- |
| OpenAPI 3.1                                 | [Schema](https://ethicsportal.eu/openapi.json)                                 |
| API catalog (RFC 9727)                      | [api-catalog](https://ethicsportal.eu/.well-known/api-catalog)                 |
| Developer documentation index for AI agents | [developers/llms.txt](https://ethicsportal.eu/developers/llms.txt)             |
| All developer documentation in one file     | [developers/llms-full.txt](https://ethicsportal.eu/developers/llms-full.txt)   |
| Agent guide                                 | [agents.md](https://ethicsportal.eu/agents.md)                                 |
| Site overview                               | [llms.txt](https://ethicsportal.eu/llms.txt)                                   |
| Full public content                         | [llms-full.txt](https://ethicsportal.eu/llms-full.txt)                         |
| Agent card                                  | [A2A card](https://ethicsportal.eu/.well-known/agent-card.json)                |
| Agent skills                                | [Skills manifest](https://ethicsportal.eu/.well-known/agent-skills/index.json) |
| Sitemap                                     | [sitemap.xml](https://ethicsportal.eu/sitemap.xml)                             |
| Crawl policy                                | [robots.txt](https://ethicsportal.eu/robots.txt)                               |
| Vulnerability disclosure                    | [security.txt](https://ethicsportal.eu/.well-known/security.txt)               |
| Vendor questionnaire                        | [CAIQ CSV](https://ethicsportal.eu/caiq-ethicsportal.csv)                      |
| Blog feed                                   | [RSS](https://ethicsportal.eu/blog/index.xml)                                  |

## Markdown content negotiation

Eligible public pages have a Markdown representation. Append `.md` to a page URL or request `Accept: text/markdown`:

```
curl --fail \
  -H 'Accept: text/markdown' \
  'https://ethicsportal.eu/developers/quickstart/'
```

Representation selection honours quality values. `Vary: Accept` distinguishes HTML and Markdown responses. With no preference, the response is HTML. Unsupported preferences receive `406 Not Acceptable`; unknown pages receive `404 Not Found`. HTML responses advertise their Markdown twin with an alternate link. Markdown copies link back to canonical HTML and are excluded from search indexing.

The customer application is separate from these public exports. The OpenAPI schema documents a credential-protected metadata contract; it is not an API gateway. The [MCP server](https://ethicsportal.eu/developers/mcp/) is part of the customer application: an assistant reaches it only after a person approves the connection.