Your AI agent and Dreamlens (MCP)

Your own AI agent — Claude, and others later — can work with Dreamlens directly: ask it for exact sky data and answer you with that data in hand. Your agent does the thinking and writing, on your plan; Dreamlens only hands it the computed data. The agent sees what you see and acts with your rights — never more.

Address to connect

https://dreamlens.fun/mcp

One address for every app. If it does not work for you, try the fallback: https://dreamlens.app/mcp (the same thing on another server; the main one is faster).

Sign-in is by an emailed link, as on the site. Open the email in the same browser where the sign-in window appeared. App menus change — if an item is named differently, look for the closest one.

Without an account — try it right away

https://dreamlens.fun/mcp/open

The same tools, but with no sign-in, no email and free: the agent computes from the data you give it in the chat (birth date, time and place) and remembers nothing. Connect the same way, just without the "email → Allow" step: in Claude — a connector with this address, in ChatGPT — Authentication No authentication, in the terminal — claude mcp add --transport http dreamlens-open https://dreamlens.fun/mcp/open. For tools that need your saved data (the list of profiles, a profile by name, the divination history) the agent answers "sign-in needed" and shows how. Signing in is only for memory — so Dreamlens remembers your data, profiles and settings across chats and devices. The list of tools and the terms (everything is free for now) — https://dreamlens.fun/mcp/catalog.

Claude (app and claude.ai)

Settings → Connectors → Add custom connector.
Name — Dreamlens, address — the one above, leave the other fields empty. Add → Connect.
A Dreamlens page opens: sign in with the link from the email and press "Allow" on the access request screen.
In a new chat, make sure Dreamlens is enabled in the tools list — and ask away.

ChatGPT

Open the Plugins page and press “+” (or Create). If there is no button: Settings → Security and login → enable Developer mode and return to Plugins.
Fill in: Name — Dreamlens, URL — the address above, Authentication — OAuth. Press Create.
A Dreamlens page opens: sign in with the link from the email and press “Allow” on the access request screen.
In a new chat type @, pick Dreamlens and ask. The same connector appears in the ChatGPT app under the same account.

Terminal (Claude Code)

claude mcp add --transport http dreamlens https://dreamlens.fun/mcp

After the command, restart the session and open /mcp → dreamlens → Authenticate. Then the same email sign-in and "Allow" (this path is still being verified — see the note at the bottom). Codex CLI: this sign-in path does not work yet; the technical route through the wrapper is described in the developer documentation.

Your own agent gateway (a bot in Telegram, a home server): if the gateway receives the sign-in on its own public HTTPS address, you connect with one link right in the chat — sign in, press "Allow", and your next message already works. Without such an address the sign-in ends with a one-time code copied by hand into the gateway.

What the agent can do now

Everything in your language, your time zone, and with your house system and body set from settings:

planet positions at any moment — now or at a given date;
aspects between planets: those in effect now and those about to form;
houses for any place and moment;
coordinates and time zone of a major city by name; for any other place the agent asks you for coordinates (parse_place);
the Moon: position and sign, phase and its angle, distance from the Sun, the moments of the next new moon, first quarter, full moon and last quarter;
panchanga for a day: tithi, nakshatra, yoga, karana (as numbers);
the Chinese calendar: year, element, animal, lunar mansion;
the Moon's day in four traditions: Western phase, illumination, age and lunar day; tithi, nakshatra, yoga and karana; the Chinese and Arabic lunar mansions (get_luna_daily);
the Moon's mansion in one scheme or all three: the Jyotish nakshatra (27 equal), the Arabic manzil (28 equal) and the Chinese xiu (28) (get_mansion);
which planets are retrograde right now, and every retrograde loop over a period — shadow entry, both stations, shadow exit (get_retrograde_periods);
a calendar of sky events for any period, past or future — stations, ingresses, exact aspects with every pass of a retrograde loop, shadow entry and exit, new and full moons and quarters — each with its exact moment in your time zone and in UTC (get_sky_events);
space weather now: the Kp index, solar flares, geomagnetic storms, solar wind and the 3-day forecast, from NOAA SWPC; if a source does not answer, the agent says so instead of reporting a quiet Sun (get_space_weather);
events of hypothetical bodies — aspects, stations and stelliums of the Uranian points, Transpluto, Vulcan, Selena, Proserpina and others — over a window of 1 to 60 days; days not yet computed are computed in the same call, and what does not fit is computed by the next one (get_fictitious_events);
Human Design from the birth data: type, strategy, authority, profile, definition, centers, channels, gates and the incarnation cross (get_human_design_chart); the transits to the design at a moment and the upcoming transits that complete a channel (get_human_design_transits, get_human_design_upcoming_transits); the sleeping harmonics — channels that lack one paired gate (get_human_design_sleeping_harmonics);
upcoming eclipses and eclipse corridors.

Dreamlens computes the sky itself, with Swiss Ephemeris — the same calculation as on the site, so an agent needs no external calendar for dates. The principle: what the site can do, an agent should be able to do too; what it cannot reach yet is listed below under “Not yet”.

And with your birth data from your profile — read-only:

your natal chart (planets, houses) and planetary returns;
transits to your natal chart and to your house cusps, overlays;
Sade Sati (sidereal zodiac, Lahiri ayanamsha);
a quick synastry with a partner whose data you give in the chat;
fictitious points in your natal chart: Selena, Proserpina, Transpluto, the Uranian planets (Cupido, Hades, Zeus, Kronos, Apollon, Admetos, Vulkanus, Poseidon) and other hypothetical bodies;
your saved profiles by name — “Masha's chart”, “transits for Pete” — the agent sees the list of profiles (name, birth date and place) and, on request, the full birth data of the profile you name — exactly what you saved for that person.

If your profile has no birth data, the agent says so and suggests adding it on the site; only for the natal chart and planetary returns can it pass the birth date and time (plus coordinates for the chart) directly in the call.

And with your settings and profiles — now with writes, by the same path and with the same rights you have on the site:

personas and the assistant's voice: the persona catalog, any persona's body and assembly rules, a selection of up to two personas, empathy, humor, tone, address — the same as the “Voice” section of the settings; with an account the agent receives the assembled voice (guidance) ready and speaks in it;
dialog settings: answer language, house system, aspects to the nodes, lunar day, names in answers, goals and topics to avoid; the assistant's model and effort, the site's display and everything “site-only” are not reachable from the chat — they stay on the settings page;
saved profiles: add a person (saved, but not made active), change their birth data, rename, delete, profile groups — and compute for them right away: “add Masha and show her chart”.

And divination — the same cards, runes and hexagrams as on the site, in your language:

Tarot: the card of the day, spreads (one card, three cards, situation, decision, yes/no, week, month, year and more), the meaning of any card and the deck's card list; a spread comes in your deck from the settings — without signing in, the deck can be named right in the call; every card carries a link to its image from the original Dreamlens deck, and on request the agent receives the images themselves right in the answer;
Runes: a single rune or a spread, the meaning of a rune, a rune search by keyword or situation;
I-Ching: a hexagram cast (with changing lines and the relating hexagram), the meaning of a hexagram, the trigrams and their reference, a search by situation;
your divination history for a period — Tarot, Runes or I-Ching — with an account only.

With an account every spread, card of the day and rune draw lands in your history on the site — as if you had cast it on the site itself (an I-Ching cast is not written to the history yet — neither from the site nor from an agent; today only the Telegram bot keeps an I-Ching history). Without an account the agent divines but remembers nothing: the card of the day is not saved without signing in either.

And coupons — with an account only:

your access: the level and limits, the active promo gift and the history of your gifts;
activating a coupon in two steps: first the agent shows its terms — the plan, the duration, the date the gift would end, the last date to activate the coupon and whether it combines with your plan; that grants nothing yet. The agent activates it only after your explicit "yes". The server counts attempts, and wrong codes in a row run into a limit — so the agent never guesses or tries out codes;
in ChatGPT the same is in the Dreamlens panel, on the "Coupon" screen: your access and a field for the code; "Check" shows the terms, and only your press of "Activate" activates the coupon.

Without signing in, the agent answers that you need to sign in. The agent cannot issue or revoke coupons — Dreamlens issues them; you can also activate a coupon on the site, on the coupon page.

And your conversations with the assistant on the site — with an account only:

the latest conversation of the chat — or another of your own conversations, if the agent names it: its last messages, a search through it and a short summary of its topics; the agent sees only your own conversations, and every answer says which conversation it read and when it was last updated.

Without signing in, the agent answers that you need to sign in.

Not yet

Making a profile active, editing your own profile (birth data, owner's name) or the active profile, choosing the assistant's model and effort — on the site only; the agent answers honestly “that is done on the site”.
The numogram.
Moonrise and moonset times.

Where to start

"What's in the sky right now? Short and to the point"
"What is the current Moon phase and which sign is it in?"
"Which planets are retrograde right now?"
"What happens with Mercury and Venus in October and November — exact dates and times?"
"The next eclipses — dates and signs"
"Today's panchanga for my city"
"Which aspects will form in the next three days?"
"What is transiting my natal chart right now?"
"When is my next Saturn return? And Masha's?"
"Speak to me as Kovalev — with high empathy"
"Add Masha: 1 May 1990, 10:00, Moscow — and show her chart"
"Draw my card of the day" · "A three-card spread: should I change jobs?" · "Cast a hexagram on this question"
"What access do I have now, and do I have a gift?" · "I have a coupon — show me its terms first" · "Open Dreamlens on the coupon screen"

Rights and privacy

The agent acts on your behalf and within your rights.
The agent reads and, on your word, writes: the voice and dialog settings and the saved profiles — by the same guarded path as the site (the write lands in your account and you see it in the settings). The active profile, your own profile and the owner's birth data are not changed from the chat.
The agent reads your display settings (language, time zone, house system, body set), the birth data of your profile and your saved profiles — including the birth date, time and place of the people you saved; that is exactly what you see yourself, and you are responsible for their data just as on the site. The account owner's name is not passed separately; if your own profile is saved in the profile list, the agent sees it under the name you gave it, marked as yours.
Divination with an account is written to your history on the site and read by the agent only from there — exactly the history you see yourself; without an account no spread, card of the day, rune draw or hexagram is saved.
Your conversations with the assistant on the site are read by the agent only with an account and only your own; it reads them and changes nothing in them.
The coupon code goes only to Dreamlens, and the server does not repeat it in its answers. A code typed in the chat is seen by your app's model; a code entered in the field of the "Coupon" screen in ChatGPT is not passed to the model's context by the Dreamlens panel itself.
You can disconnect at any time — remove the connection in your app; the agent's access expires on its own unless renewed.

Disconnect, and if it did not work

Disconnect Dreamlens — remove the connector in your app's settings.
The email opened in another browser — the sign-in will not complete: start the connection again and open the email where the sign-in window is.
It does not connect — try the fallback address https://dreamlens.app/mcp.
The agent "does not see" a tool — start a new chat or reconnect: after Dreamlens updates, new capabilities appear in a new chat.

Checked 2026-09-22: connecting from the terminal through the developer wrapper — works. The claude mcp add … → Authenticate command, the Claude app / claude.ai and ChatGPT — verification pending; this page will be updated with the result. The "Coupon" screen in ChatGPT — 2026-10-07: it opens and shows your access; for an unknown code "Check" answers "Coupon code not recognized."; showing a coupon's terms and activating it — still to be checked.