# PostExpert

> PostExpert is a multi-tenant platform that uses AI to generate Instagram
> content (captions, images, video) and auto-schedules it to Instagram Business
> accounts. It exposes a paid, machine-usable HTTP API and an MCP server so
> agents can list bots, enqueue posts and read usage — provided the account is
> on the **Ultra** plan.

## What an agent can do here

- Authenticate machine-to-machine with OAuth 2.0 client-credentials (see
  [auth.md](https://app.postexpert.de/auth.md)) or a raw `X-API-Key` header.
- List the account's Instagram bots, enqueue posts (image/video URL + caption),
  read recent queue items and read current usage vs. plan limits.
- Talk to the same capabilities over the Model Context Protocol (MCP).

Access requires an active **Ultra** subscription; every request re-checks the
plan, so a downgrade revokes access immediately.

## API

- [API documentation](https://www.postexpert.de/docs/api): human guide to the `/api/v1/*` endpoints.
- [OpenAPI description](https://app.postexpert.de/api/v1/openapi.json): machine-readable schema.
- [API catalog](https://app.postexpert.de/.well-known/api-catalog): RFC 9727 discovery linkset.
- [Health](https://app.postexpert.de/api/v1/health): liveness probe.

## Authentication

- [auth.md](https://app.postexpert.de/auth.md): how an agent registers a client and obtains a token.
- [OAuth authorization server metadata](https://app.postexpert.de/.well-known/oauth-authorization-server)
- [OAuth protected resource metadata](https://app.postexpert.de/.well-known/oauth-protected-resource)
- Token endpoint: `POST https://app.postexpert.de/oauth/token` (grant_type=client_credentials).

## Agent interfaces

- [MCP server card](https://app.postexpert.de/.well-known/mcp/server-card.json) — endpoint: `https://app.postexpert.de/mcp`
- [A2A agent card](https://app.postexpert.de/.well-known/agent-card.json)
- [Agent skills index](https://app.postexpert.de/.well-known/agent-skills/index.json)

## Plans & pricing

- [Pricing](https://www.postexpert.de/preise): the Ultra plan unlocks API + MCP access.

## Optional

- [robots.txt](https://app.postexpert.de/robots.txt): crawl rules + content signals.