# redPIM — Developer Portal

> Markdown version of [developers.html](https://redpim.de/developers.html).
> Integrate with redPIM programmatically — the Cloud PIM for technical distributors.

## Surfaces

- **REST API** — base `https://app.redpim.de/api`, routing `/{Controller}/{Action}`. Agent surface under `/api/ai/*`.
- **OpenAPI 3.1** — [openapi.json](https://redpim.de/openapi.json).
- **MCP server** — `https://mcp.redpim.de/` (Streamable HTTP). Tools: `get_stats`, `list_departments`, `list_catalogs`, `add_product`, `start_export`.
- **Sync connector** — fingerprint-based diff (mappings → inventory → upsert) for shops/ERPs.

## Authentication

- Interactive REST API: session cookie (`REDPim.Cookie`).
- Agent / MCP surface: **OAuth 2.1** (`authorization_code` + PKCE/S256), live. Dynamic Client Registration at `https://app.redpim.de/connect/register` (scopes `mcp`, `api`, `offline_access`). See [auth.md](https://redpim.de/auth.md).

## More

- [agents.md](https://redpim.de/agents.md) · [Agent skills index](https://redpim.de/.well-known/agent-skills/index.json) · [llms.txt](https://redpim.de/llms.txt) · [llms-full.txt](https://redpim.de/llms-full.txt)

Contact: me@redcomponents.de