Efsun MCP Connector

Ottoman havas tradition toolkit for Claude.ai · Last updated: June 5, 2026

The Efsun MCP Connector exposes Efsun's classical Islamic occult-science toolkit (Cifr, Havas, Ebced, Esma-i Hüsna, Yıldızname) inside Anthropic Claude.ai. You can simply say "draw my yıldızname", "interpret my dream", or "read this coffee cup" — the connector authenticates with your Efsun account in the background and produces the reading.

Important: To use the connector you first need an Efsun account, created via the Efsun mobile app on Google Play, and some akçe (credit) balance. The credits you hold in the mobile app are the same credits used by the connector.

1. Connection (OAuth 2.0)

The connector uses standard OAuth 2.0 + PKCE. When you add the connector in Claude.ai:

Claude redirects you to the Efsun login page.
You sign in with your Efsun email + password (the same one used in the mobile app), or with Google sign-in.
You grant access.
Claude.ai automatically receives an access token; from this point on, tools work on your behalf — no further prompting.

Access tokens are valid for 1 hour and refresh automatically. Your password is never visible to Claude.ai — it is verified only at the Efsun OAuth server.

2. MCP Server Information

Server URL	`https://mcp.efsun.anka.istanbul/mcp`
Transport	Streamable HTTP (stateless)
Auth	OAuth 2.0 + PKCE (S256), Dynamic Client Registration
Discovery	`/.well-known/oauth-authorization-server`
Health check	`/health`

3. Available Tools

There are 13 tools. Each tool's cost is in Efsun akçe (credits); the same balance as the mobile app is used.

Tool	Description	Cost
`efsun_bakiye` Account	Your akçe balance and account status	0 akçe
`efsun_yildizname` Text	From your name + mother's name: spiritual zodiac, planet, 12-house analysis (Cifr/Havas)	1 akçe
`efsun_numeroloji` Text	Pythagorean numerology + Kabbalah (Ebced) layer — life path, destiny, soul numbers	1 akçe
`efsun_ruya_tabiri` Text	Dream interpretation in the Islamic tradition (personalised with Ebced profile)	1 akçe
`efsun_imtizac` Text	Ebced / Cifr compatibility analysis between two people (love, marriage, partnership)	1 akçe
`efsun_gunun_enerjisi` Text	Today's planetary hour, dominant element, spiritual advice	1 akçe
`efsun_kriz_raporu` Text	Today's global astrological / Cifr analysis — political, economic, spiritual foresight	1 akçe
`efsun_kahve_fali` Image	Classical coffee cup reading from 1–5 cup photos	2 akçe
`efsun_nazar_tespiti` Image	Detection of evil eye from a personal photo using Cifr/Havas computation	2 akçe
`efsun_aura_okuma` Image	Aura colour and energy state from a face/portrait photo	2 akçe
`efsun_yuz_analizi` Image	Classical Kıyafetname (physiognomy) character analysis from a face/portrait photo	2 akçe
`efsun_hocaya_sor` Human Expert	Real human scholar writes a personalised reply within 48 hours	500 akçe
`efsun_sorularim` Account	Lists your past scholar questions and the answers received	0 akçe

Image validation: Image-based tools (coffee cup, evil eye, aura, face analysis) are first checked by the AI. If you upload an irrelevant image (a slipper, a screenshot, an empty glass etc.) the tool will refuse to fabricate a reading and ask you to resubmit a proper photo.

4. Hocaya Sor — Real Human Expert Consultation

The efsun_hocaya_sor tool does NOT produce an automated AI response — your question is forwarded to Efsun's expert scholar, who writes you a personal, individualised reply within 48 hours. This is the operational core of Efsun and differentiates it from typical algorithmic horoscope products.

When your answer is ready, it appears in the "Hocaya Sor" tab of the Efsun mobile app. From inside Claude, simply ask "Has the scholar answered yet?" and Claude will call efsun_sorularim to retrieve and display the answer in full.

5. Data Flow and Privacy

When you use the connector:

Your inputs (name, mother's name, dream text, etc.) are sent from Claude.ai to the Efsun MCP server.
Ebced values and calculations are computed on the Efsun server (sourced from a Firestore Ebced database).
Natural-language generation is delegated to a contracted AI provider with anonymised payloads.
Image-based tools: uploaded photos are not retained; they are discarded after the analysis.
History records are saved in your Efsun account where you can view or delete them at any time.

For full details see the Privacy Policy.

6. Credits and Billing

All credit purchases are made via the Efsun mobile app (Google Play / App Store).
The connector shares the same balance with the mobile app — both channels see the same user.
If you don't have enough akçe, the tool returns a purchase link.
Failed analyses (server errors) result in automatic refunds.

7. Support

For questions or feedback: info@anka.istanbul

8. Technical Details (for developers)

The Efsun MCP Server is fully compliant with the Model Context Protocol specification.

POST https://mcp.efsun.anka.istanbul/mcp
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "efsun_yildizname",
    "arguments": {
      "isim": "Asım Ender",
      "anne_adi": "Şükran"
    }
  }
}