> ## Documentation Index
> Fetch the complete documentation index at: https://docs.prophia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integration Overview

> Two ways to work with Prophia data: the MCP server and the REST API

Prophia exposes your portfolio data through two integration surfaces. Both are hosted by Prophia, both are read-optimized views of the same underlying data, and both scope everything to an **account**.

## Choose your surface

> [card] [MCP Server](https://docs.prophia.com/developers/mcp/overview.md)
>
> Connect AI assistants (Claude, Cursor, any MCP client) to your Prophia data. Best when a person is asking questions in natural language.

> [card] [REST API](https://docs.prophia.com/api-reference/v2/introduction.md)
>
> Versioned JSON API for programmatic integration — sync leases into your data warehouse, feed your BI stack, automate reporting.

| | MCP Server | REST API |
| - | - | - |
| Base URL | `https://api.prophia.com/mcp/v1/{api-name}` | `https://api.prophia.com/rest/v2` |
| Consumer | AI assistants / MCP clients | Your code |
| Auth | OAuth via your IdP (recommended) or API key | API key |
| Shape | Tools the model calls (`get_lease`, `smart_search`, …) | Resources (`/accounts/{accountId}/leases`, …) |
| Writes | Custom terms and saved reports only | Full read/write, with the [write module](https://docs.prophia.com/developers/write-access.md) enabled |

## The account scope

Every request — MCP or REST — operates inside one account:

* REST paths embed the account id: `/rest/v2/accounts/{accountId}/properties`
* The MCP URL embeds your account's **API Name**: `/mcp/v1/acme-real-estate`

Your credentials determine which accounts you can reach, and per-resource permissions (property, lease, document, tag) apply underneath — two users connected to the same account can see different data.

Both surfaces expose the same hierarchy you see in the web application, so if you know where something lives in Prophia you know where to find it here. The [data model](https://docs.prophia.com/api-reference/v2/concepts/data-model.md) page has the entity diagram, field conventions, and how tags reference spaces by suite name.

## Getting started

> [card] [Authentication](https://docs.prophia.com/developers/authentication.md)
>
> API keys, what each type can reach, and how to send them.

> [card] [MCP server](https://docs.prophia.com/developers/mcp/overview.md)
>
> What a connected assistant can do, and how to connect one.

> [!NOTE]
>
> There is a third, separate MCP server that serves **this documentation** rather than your data — public, no credentials, and useful alongside either surface above. See [Connect AI to these docs](https://docs.prophia.com/developers/docs-mcp.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.