# Quickstart: read the REST API and connect an MCP server

Adresse: https://docs.athaus.ai/en/schnellstart/entwickler

> The REST API, the two MCP servers and your own key.

Type: Quickstart
Last updated: 2026-11-12

|              | REST API                                                                 | Athaus für Anbieter                  | Athaus Immobiliensuche               |
| ------------ | ------------------------------------------------------------------------ | ------------------------------------ | ------------------------------------ |
| Address      | `https://api.athaus.ai/v1`                                               | `https://anbieter.mcp.athaus.ai/mcp` | `https://suche.mcp.athaus.ai/mcp`    |
| For          | Systems that read and write an office's listings, contacts and enquiries | Agents working for an office         | Agents working for someone searching |
| Sign-in      | an `ath_live_` key                                                       | OAuth 2.1 or an `ath_` key           | OAuth 2.1                            |
| Described in | [Reference](/en/api/v1/referenz)                                         | [Tools](/en/mcp/werkzeuge/anbieter)  | [Tools](/en/mcp/werkzeuge/suche)     |

## Read your office's listings [#read-your-offices-listings]

```bash
curl "https://api.athaus.ai/v1/listings?limit=5" \
  -H "Authorization: Bearer ath_live_..."
```

The response is one page (`externalListingIds`, `nextPageToken`, see [Pagination](/en/api/v1/blaettern)). `GET /v1/listings/{externalListingId}` fetches one listing ([Listings](/en/api/v1/inserate)). You create the key under [Settings, API-Keys](https://app.athaus.ai/einstellungen/api-keys), and all routes are in the [reference](/en/api/v1/referenz).

## Connect an MCP server [#connect-an-mcp-server]

With Claude Code it is one line per server; sign-in then happens in the browser:

```bash title="Athaus für Anbieter"
claude mcp add --transport http athaus-makler https://anbieter.mcp.athaus.ai/mcp
```

```bash title="Athaus Immobiliensuche"
claude mcp add --transport http athaus-suche https://suche.mcp.athaus.ai/mcp
```

For Claude, ChatGPT, Cursor and VS Code see [Installation](/en/mcp/installation), plus [example prompts](/en/mcp/beispiele) and [troubleshooting](/en/mcp/fehlerbehebung).

## Your own agent with a key [#your-own-agent-with-a-key]

Without a browser, create a key under [Settings, API-Keys](https://app.athaus.ai/einstellungen/api-keys) (Pro and Scale plans) and send it as a bearer token. It only works with Athaus für Anbieter:

```bash
claude mcp add --transport http athaus-makler https://anbieter.mcp.athaus.ai/mcp \
  --header "Authorization: Bearer ath_..."
```

A new key may only read ([keys](/en/api/schluessel), [rights](/en/mcp/rechte)).

## These docs for agents [#these-docs-for-agents]

[/llms.txt](/llms.txt) is the table of contents, [/llms-full.txt](/llms-full.txt) all German pages. Every page is available as Markdown (its address with `.md` appended). The docs MCP server is at `https://docs.athaus.ai/api/mcp`, without sign-in.
