---
name: aprixity-content
description: Read Aprixity's public website content through Markdown negotiation, the article APIs, llms.txt, and the API catalog. Use the linked OAuth metadata only for the separate Sanierungs-Check MCP.
---

# Aprixity Content Access

Aprixity (https://aprixity.run) helps people responsible for operations find the bottleneck before software or AI is chosen. German is the primary locale. This skill lists the supported public read-only access paths.

## Markdown content negotiation

Follow the advertised `rel="alternate"; type="text/markdown"` link to a canonical page's explicit `.md` sibling:

    GET https://aprixity.run/de/briefing.md

The canonical URL also supports `Accept: text/markdown` when that representation exists:

    curl -H "Accept: text/markdown" https://aprixity.run/de/briefing

If a route has no canonical Markdown representation, use the JSON article API or its HTML response. Do not infer a write capability from content negotiation.

## Plain-text overview

    GET https://aprixity.run/llms.txt

## JSON knowledge-base API

    GET https://aprixity.run/api/knowledge/articles
    GET https://aprixity.run/api/knowledge/articles/{slug}
    GET https://aprixity.run/api/aeo/articles/{slug}?locale={locale}

The first returns the published article list. The second returns one article with every available translation and does not accept a locale filter. The AEO route applies `locale` and returns the article in answer-first form. Slugs come from the article list. These endpoints are public and read-only.

## Discovery and MCP

- `GET https://aprixity.run/.well-known/api-catalog` — RFC 9727 linkset of machine endpoints
- `GET https://aprixity.run/openapi.json` — OpenAPI 3.1.1 contract for the public read operations
- `GET https://aprixity.run/de/developers` and `GET https://aprixity.run/en/developers` — localized developer-resource indexes
- `GET https://aprixity.run/.well-known/mcp/server-card.json` — server card for the Sanierungs-Check MCP (`https://sanierung-mcp.aprixity.run/mcp`, Streamable HTTP, OAuth-protected)
- `GET https://aprixity.run/auth.md` — authentication boundary for the public site and the protected MCP service

Do not look for an OAuth issuer on `aprixity.run`: the public site is not an OAuth protected resource. For the separate MCP service, start with its live metadata:

    GET https://sanierung-mcp.aprixity.run/.well-known/oauth-protected-resource
    GET https://sanierung-mcp.aprixity.run/.well-known/oauth-authorization-server

## Usage signals

`https://aprixity.run/robots.txt` declares `Content-Signal: search=yes, ai-input=yes, ai-train=yes` and allows the major AI crawlers. Rate limits apply on `/api/*`.