MCP ENDPOINT

FlatFlash over MCP

One endpoint for any MCP client: search listings, read your saved search and pull a best-effort digest. The ChatGPT plugin is the consumer path; this page is for your own client.

Endpoint

POSThttps://mcp.flatflash.com/mcp

Streamable HTTP, one POST, bearer auth. No GET stream, no sessions, no resumability.

Open Connected Apps

Two credentials, one account

Both doors reach the same Subscriber, the same saved search and the same digest history. Pick the one your client supports.

OAuth 2.1 for the ChatGPT plugin

The published plugin connects through the FlatFlash authorization server with OAuth 2.1 and PKCE. Install and consent are two manual steps in ChatGPT; a prompt can do neither.

Read the plugin guide

Personal access token for a generic MCP client

Create a token in Connected Apps and send it as a bearer token. The plaintext is shown once; FlatFlash stores only its hash.

Create a token

Personal access token properties

  • Expires 90 days after creation; the server sets the lifetime.
  • Stored as a SHA-256 hash. The plaintext is shown once and cannot be retrieved later.
  • Revocable at any time, per token.
  • Every successful call records last_used_at, so Connected Apps can show recent activity.

What a PAT can and cannot do

Read listings, read and create or update your saved search, read your entitlement and pull a digest.

No delete or pause of a saved search, no cancellation, no billing change and no access to another account.

There is no tool beyond those limits: the endpoint offers no such operation.

Tools

Seven tools, two scopes. No tool takes a user id: identity comes from the bearer token.

search_listings
read listings:read

Search current listings by city, districts, budget, rooms, WBS and features. Returns compact results with FlatFlash and original-ad links.

get_listing
read listings:read

Full detail for one listing, including the original ad link.

get_saved_searches
read alerts:write

List your saved searches.

create_saved_search
write alerts:write

Create your saved search; starts the 10-day trial if it is still available. Idempotent: a repeated call returns the existing search.

update_saved_search
write alerts:write

Update criteria, batch size or max wait. Idempotent.

get_entitlement
read alerts:write

Subscription status, feature availability and the informational plans link.

get_digest
read alerts:write

New matches since the last digest, capped; advances the cursor only after a successful call.

Scopes

A scope is checked on every request; a credential without the needed scope is rejected and no tool runs.

listings:read

Search listings and read one listing. These tools need no subscription entitlement.

alerts:write

Read and write saved searches, entitlement and digest.

Public tools need no subscription entitlement, but they still need a token: every POST /mcp carries a bearer token.

Call it from a terminal

Export the endpoint and your PAT, then send one JSON-RPC POST. The placeholder stands in for your own token; never paste a token into a prompt, a tool argument or a URL.

export FLATFLASH_MCP_ENDPOINT="https://mcp.flatflash.com/mcp"
export FLATFLASH_PAT="<your-personal-access-token>"

curl -sS "$FLATFLASH_MCP_ENDPOINT" \
  -H "Authorization: Bearer $FLATFLASH_PAT" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "search_listings",
      "arguments": {"city": "berlin", "max_budget_eur": 1200, "min_rooms": 2}
    }
  }'

The response is a JSON-RPC result with a text block for the model and structuredContent for your client.

Create and revoke

Connected Apps lists every MCP grant and token, with scopes and last use.

Revoking a token or an OAuth connection ends access on the next request: the endpoint answers 401 and no tool runs. Your web session and saved search stay.

Open Connected Apps

Uninstalling the plugin or disconnecting it in ChatGPT revokes the OAuth grant the same way.

Security notes

Audience-bound tokens: an access token is valid only for this MCP resource, never as a general FlatFlash credential.

Bearer header only: tokens in a prompt, a tool argument, a query string or a log are not accepted.

No passthrough: FlatFlash never forwards your token to another service.

Public-ad data only: tool output carries no landlord contact details, internal ids or session identifiers.

Best effort, pull only

Your client decides when to call the digest. FlatFlash does not schedule the call and does not push into your client; Telegram and the web app stay the reliable alert channels.

Keep the reliable alerts

The MCP digest is best-effort and depends on your client. Telegram and the web app deliver alerts independently of any AI client.

Read the ChatGPT plugin guide
Get started