Overlay for AI assistants
An assistant can ask Overlay for the chart two people make together. It sends two birthdays and gets back the pair's Sun, Moon and Venus signs and their Tandem name, one of 144 names for a composite Sun and Moon. It's free and needs no account or key.
Where it lives
- As a connector (MCP server):
https://overlayastro.com/api/mcp. Add it to an assistant that takes custom connectors. There is nothing to sign in to. - As a web request:
POST https://overlayastro.com/api/together/tandemwith JSON. The OpenAPI description has the details.
The two tools
- tandem_name: two birthdays, written as YYYY-MM-DD. A birth time and a birthplace are optional for each person. With an exact time and a place for both, the Moon is settled and the rising sign comes back too.
- tandem_name_for_signs: a composite Sun sign and a composite Moon sign, for when the signs are already known. It takes no personal details.
POST /api/together/tandem
{ "birthday_a": "1994-04-20", "birthday_b": "1992-11-03" }
{ "sun": { "signs": ["Aquarius"], "certain": true },
"moon": { "signs": ["Taurus", "Gemini"], "certain": false },
"names": [ { "name": "The Best Friends", "line": "You like each other as much as you love each other.", ... },
{ "name": "The Brainstormers", ... } ],
"summary": "Their Moon together could be in Taurus or Gemini, so they're one of: ..." }When the Moon could be in two signs, both names come back with the likeliest first.
What is sent, and what is kept
- Overlay receives the birthdays, and the birth times and birthplaces if they're sent. It never asks for names, and assistants are told not to send them.
- Nothing is stored. The details are used to work out the answer and are gone when the reply is sent.
- Both people must be 18 or over. A birthday less than 18 years ago is refused.
- On the Together page itself, the same sums run in your browser and your details aren't sent to Overlay at all.