# Agent guide — EthicsPortal

EthicsPortal is whistleblower software for EU organisations.

## Public reference content

- [Site overview](https://ethicsportal.eu/llms.txt)
- [Full-content collection](https://ethicsportal.eu/llms-full.txt)
- [Developer resources](https://ethicsportal.eu/developers/)

## Setting up EthicsPortal for a person

If a person asks you to set up a whistleblowing channel with EthicsPortal, follow
the [setup skill](https://ethicsportal.eu/.well-known/agent-skills/ethicsportal-setup/SKILL.md).
You connect to the MCP server at `https://secure.ethicsportal.eu/mcp`. The
person needs no account first: they sign up in the browser while they connect,
and you create their organisation and configure its channel with the tools.

## Building an integration

Start from the [developer documentation index](https://ethicsportal.eu/developers/llms.txt).
It lists every guide and API operation as Markdown. The
[OpenAPI 3.1 schema](https://ethicsportal.eu/openapi.json) names the scope and
token types for each operation, and the
[API skill](https://ethicsportal.eu/.well-known/agent-skills/ethicsportal-api/SKILL.md)
summarises the rules an integration must follow.

An AI assistant can also work through the
[MCP server](https://ethicsportal.eu/developers/mcp.md) at
`https://secure.ethicsportal.eu/mcp`. It offers the API's operations as tools.
A person approves the connection with OAuth and chooses the organisations it
reaches. Use the REST API with a token for scripts and server integrations.

Public content pages have Markdown versions. Append `.md` to the HTML path,
or send `Accept: text/markdown` to the HTML URL.
Sections use `/section/index.md`; the homepage is `/index.md`.

HTML is the default, including equal quality preferences. Markdown responses
identify the canonical HTML URL and are excluded from search indexing. Drafts,
noindex pages, accounts, tenant channels, reports and messages are not included.

## Scope

These endpoints serve public reference content. They do not provide access to
customer accounts or whistleblower reports. The API at
`https://secure.ethicsportal.eu` needs a token issued by a customer, and the
MCP server needs a connection approved by a person. Both return report
metadata, never report content.

## Contact

- Support: support@ethicsportal.eu
- Security: security@ethicsportal.eu