MCP App Store
by KeenEthics
Fincanya Kahve Falı icon

Fincanya Kahve Falı MCP Server for ChatGPT

By The Open Apps, Inc.

Overview

Fincanya reads Turkish coffee cups (kahve falı), the tradition of looking for shapes in the grounds left in a cup. It is for anyone who enjoys a coffee reading, in Turkish or English. Share a photo of the inside of your cup, taken from above, and ask ChatGPT to read it. Fincanya finds the rim and outlines the clearest shapes in the grounds with classical image processing, the same way every time, and sorts them into zones: the rim (the near future), the middle (the present) and the bottom (the past). Add a photo of the saucer for the wish. ChatGPT then names each numbered shape from Fincanya's own lexicon of about 400 traditional shapes, such as bird, fish, camel, road or ring, and gives a short reading from their traditional meanings. The reading opens as a card with your photo and the numbered outlines. Tap a shape to see its meaning, or pick another lexicon entry if you see it differently. Save readings to your fal defteri, a journal kept for your ChatGPT account, and share one with friends through an unlisted link you can turn off at any time. You can also ask what a shape means, for example what a camel or a bird near the rim means in coffee reading. Fincanya is for entertainment and tradition. It makes no predictions about health, money, legal matters, death or break-ups, and it never asks for your wish (niyet), which tradition keeps secret. Limits: - One cup photo and one saucer photo per reading; up to 8 shapes in the cup and 3 on the saucer. - Photograph the cup from straight above in good light, after the grounds have dried. - Shape names come only from Fincanya's lexicon; anything else is refused. - Unsaved readings are deleted after 24 hours.

How to connect

  1. ChatGPT: Open the Fincanya Kahve Falı listing in the ChatGPT app directory and choose Connect. ChatGPT listing Fincanya Kahve Falı exposes 9 tools here.

Tools

delete_reading

ChatGPT
Use this only when the user asks to delete a saved reading, or their whole fal defteri (all: true). Permanently deletes the photo crops, outlines and names, and stops any share link. The result text is a one-sentence confirmation in the user's language.

lookup_symbol

ChatGPT
Use this when the user asks what a shape means in Turkish coffee reading ("kahve falında deve görmek ne demek?"), or to find a lexicon entry while naming shapes. Searches the Fincanya lexicon in Turkish or English and returns up to 5 entries with their traditional meanings, plus a one-sentence answer from the top match (answer_en, answer_tr) that is suitable to show the user as is. Read-only.

name_shapes

ChatGPT
Use this after read_cup to name the outlined shapes from the Fincanya lexicon of about 400 traditional shapes. Takes, for each shape_id, the lexicon entry the shape most resembles in the photo (one of its suggestions, or any lexicon name in Turkish or English); names outside the lexicon are refused with the closest entries. Returns each shape's traditional meaning, a short reading text built only from those meanings (reply_en, reply_tr) that is suitable to show the user as is, and shows the reading card: the photo with numbered outlines that the user can tap to correct. Saves nothing.

open_journal

ChatGPT
Use this when the user wants to see their past coffee readings (fal defteri), or one of them. Without reading_id it shows the list, newest first; with reading_id it shows that reading's card. The result text is a one-sentence summary in the user's language.

read_cup

ChatGPT
Use this when the user shares a photo of the inside of their Turkish coffee cup for a coffee reading (kahve falı), optionally with a photo of the saucer. Finds the cup's rim and outlines up to 8 shapes in the grounds (3 on the saucer) with classical image processing, the same way every time, and returns where each shape is (rim, middle, bottom or saucer zone; clock position, 12 = top of the photo), its size, its form and 8 lexicon suggestions picked from its geometry (length, openings, symmetry, orientation) and zone. The result contains geometry and suggestions only, no meanings: name_shapes turns it into the reading. Shows no card and adds nothing to the user's fal defteri; the analysis (a crop of the cup and the outlines) is kept for 24 hours so name_shapes and save_reading can use it, then deleted. The same photo always gives the same analysis.

rename_shape

ChatGPT
Use this when the user says a shape in a saved reading is something else ("number 2 is a fish, not a bird"). Replaces that shape's name with another Fincanya lexicon entry and shows the updated card; the result text gives the new name and its traditional meaning. Readings that aren't saved yet are corrected through name_shapes with the new names, or in the card.

save_reading

ChatGPT
Use this when the user asks to keep a reading in their fal defteri (coffee-reading journal). Saves the cup photo crop, the outlines and the names for this ChatGPT user only. Saving the same analysis again returns the reading already saved. The card's Save button does the same. The result text is a one-sentence confirmation in the user's language.

share_reading

ChatGPT
Use this when the user wants a link to show a saved reading to friends. Creates an unlisted web page with the cup photo, the outlines, the names and their meanings, and returns its link; anyone with the link can view it until the user stops sharing. Calling it again returns the same link.

stop_sharing

ChatGPT
Use this when the user wants a reading's share link to stop working. The link is turned off at once; the reading stays in the fal defteri.

Capabilities

WritesInteractive

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/fincanya-kahve-fal"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/fincanya-kahve-fal)