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.
POSThttps://mcp.flatflash.com/mcp
Streamable HTTP, one POST, bearer auth. No GET stream, no sessions, no resumability.
Open Connected AppsTwo 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 guidePersonal 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 tokenPersonal 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
listings:read
Search current listings by city, districts, budget, rooms, WBS and features. Returns compact results with FlatFlash and original-ad links.
get_listing
listings:read
Full detail for one listing, including the original ad link.
get_saved_searches
alerts:write
List your saved searches.
create_saved_search
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
alerts:write
Update criteria, batch size or max wait. Idempotent.
get_entitlement
alerts:write
Subscription status, feature availability and the informational plans link.
get_digest
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.
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