# ArcFlow — Destiny Matrix & Compatibility Calculator

> A unique self-discovery ecosystem based on the Natalya Ladini method: a synthesis of numerology, 22 Major Arcana Tarot cards, and psychological diagnostics

ArcFlow is a free numerology / destiny-matrix service: enter a date of birth and get a full personality, talent, finance, relationship and karmic-tail reading based on the 22 Major Arcana (Natalya Ladini method). Calculations are pure math, server-rendered, and also exposed as a public JSON API.

## Calculators
- [Destiny Matrix](https://destinymatrixcalc.com/destiny-matrix): Free online Destiny Matrix calculator by date of birth. Discover your purpose, karmic tasks, and financial potential with ArcFlow’s precise proprietary algorithm.
- [Compatibility](https://destinymatrixcalc.com/compatibility): Birth date compatibility by the destiny matrix: calculate online for free. Synastry, arcana of the couple, chakras and biorhythms, karma and finances.

## Public API (for AI agents & tools)
The matrix can be calculated programmatically. Both endpoints are public GET requests, deterministic, need no authentication, and return JSON (arcana numbers 1–22 plus localized interpretations). Date format is DD-MM-YYYY. `locale` is one of en, es, ru.

```bash
# Personal matrix (param: date, optional name, locale)
curl "https://destinymatrixcalc.com/api/v1/matrix/personal?date=15-05-1990&name=Anna&locale=en&shape=public"

# Compatibility (params: date1, date2, locale)
curl "https://destinymatrixcalc.com/api/v1/matrix/compatibility?date1=15-05-1990&date2=20-08-1995&locale=en&shape=public"
```

Interactive API reference and machine-readable OpenAPI spec:
- [API reference](https://destinymatrixcalc.com/api-docs)
- [openapi.json](https://destinymatrixcalc.com/openapi.json)

Matrix octagram image (SVG or PNG), e.g.:
- https://destinymatrixcalc.com/api/v1/matrix/personal/image?date=15-05-1990&locale=en&format=png
- https://destinymatrixcalc.com/api/v1/matrix/compatibility/image?date1=15-05-1990&date2=20-08-1995&locale=en&format=svg

## MCP Server (call the calculator as agent tools)
Connect an MCP client (Streamable HTTP transport) to invoke the calculation directly as tools — no HTTP wrapper, no auth, read-only.

Endpoint: https://destinymatrixcalc.com/api/mcp-public

Tools:
- `calculate_matrix({ birthdate: "DD-MM-YYYY", locale?: "en"|"ru"|"es" })` → destiny matrix reading (arcana numbers 1–22 + interpretation texts)
- `calculate_compatibility({ birthdate_a: "DD-MM-YYYY", birthdate_b: "DD-MM-YYYY", locale?: "en"|"ru"|"es" })` → compatibility reading for two birth dates

## Arcana Encyclopedia (22 Major Arcana)
Each arcana (1–22) is an archetype mapped onto positions in the matrix.
- [Arcana 1 — The Magician](https://destinymatrixcalc.com/arcana/01-magician)
- [Arcana 2 — The High Priestess](https://destinymatrixcalc.com/arcana/02-high-priestess)
- [Arcana 3 — Empress](https://destinymatrixcalc.com/arcana/03-empress)
- [Arcana 4 — The Emperor](https://destinymatrixcalc.com/arcana/04-emperor)
- [Arcana 5 — The Hierophant](https://destinymatrixcalc.com/arcana/05-hierophant)
- [Arcana 6 — The Lovers](https://destinymatrixcalc.com/arcana/06-lovers)
- [Arcana 7 — The Chariot](https://destinymatrixcalc.com/arcana/07-chariot)
- [Arcana 8 — Justice](https://destinymatrixcalc.com/arcana/08-justice)
- [Arcana 9 — The Hermit](https://destinymatrixcalc.com/arcana/09-hermit)
- [Arcana 10 — Wheel of Fortune](https://destinymatrixcalc.com/arcana/10-wheel-of-fortune)
- [Arcana 11 — Strength](https://destinymatrixcalc.com/arcana/11-strength)
- [Arcana 12 — The Hanged Man](https://destinymatrixcalc.com/arcana/12-hanged-man)
- [Arcana 13 — Death](https://destinymatrixcalc.com/arcana/13-death)
- [Arcana 14 — Temperance](https://destinymatrixcalc.com/arcana/14-temperance)
- [Arcana 15 — The Devil](https://destinymatrixcalc.com/arcana/15-devil)
- [Arcana 16 — The Tower](https://destinymatrixcalc.com/arcana/16-tower)
- [Arcana 17 — Star](https://destinymatrixcalc.com/arcana/17-star)
- [Arcana 18 — Moon](https://destinymatrixcalc.com/arcana/18-moon)
- [Arcana 19 — Sun](https://destinymatrixcalc.com/arcana/19-sun)
- [Arcana 20 — The Last Judgment](https://destinymatrixcalc.com/arcana/20-judgement)
- [Arcana 21 — The World](https://destinymatrixcalc.com/arcana/21-world)
- [Arcana 22 — The Fool](https://destinymatrixcalc.com/arcana/22-fool)

## Guides & Blog
- [Celebrity Readings](https://destinymatrixcalc.com/celebrities)
- [Karmic Tails](https://destinymatrixcalc.com/karmic-tails)
- [Numerology Basics](https://destinymatrixcalc.com/basics)
- [Major Arcana](https://destinymatrixcalc.com/arcana)
- [Karmic tail “World of Passions and Stories” (9/15/6)](https://destinymatrixcalc.com/karmic-tails/karmic-tail-world-passions): A reflective guide to telling intense attraction from a pattern that narrows your choices, and to bringing mutuality and steadiness back into relationships.
- [Karmic tail “Warrior” (12/19/7)](https://destinymatrixcalc.com/karmic-tails/karmic-tail-warrior): How to stop proving your strength through struggle, keep your courage, and direct energy into clear action.
- [Karmic Tail “A Soul Sacrificed” (6/20/14)](https://destinymatrixcalc.com/karmic-tails/karmic-tail-victim): How to recognise a habit of living around other people’s needs and reclaim a voice of your own.
- [Karmic tail “Unborn child” (3/22/19)](https://destinymatrixcalc.com/karmic-tails/karmic-tail-unborn-child): A careful conversation about a traditional label: without blame, predictions, or attempts to explain a personal loss.
- [Karmic tail “Suppressed soul” (21/4/10)](https://destinymatrixcalc.com/karmic-tails/karmic-tail-suppressed-soul): How to hear your own voice, build boundaries and avoid turning freedom into rigid control.
- [Karmic tail “Spiritual priest” (21/10/16)](https://destinymatrixcalc.com/karmic-tails/karmic-tail-spiritual-priest): How to search for meaning, share experience without superiority, and test personal beliefs against ordinary life.
- [Profession and success area in the Destiny Matrix](https://destinymatrixcalc.com/basics/profession-success): Use a professional node to talk about strengths, work conditions and skill development without choosing a fate for yourself.
- [Karmic tail “Suicide” (3/13/10)](https://destinymatrixcalc.com/karmic-tails/karmic-tail-self-destruction): How to notice exhaustion and cruelty toward yourself before they become the only way to cope, and how to find real support.
- [Parent-child karma in the Destiny Matrix: connection without blame](https://destinymatrixcalc.com/basics/parent-child-karma): Talk about family patterns and difficult feelings without finding a culprit or making a child repair the family.
- [Karmic tail “Prisoner” (3/7/22)](https://destinymatrixcalc.com/karmic-tails/karmic-tail-prisoner): How to notice a feeling of being trapped, separate change from an impulsive escape, and regain choice without putting yourself or others at risk.
- [Money flow in the Destiny Matrix: growth and blocks](https://destinymatrixcalc.com/basics/money-flow): Replace a “blocked flow” diagnosis with a clear way to observe the route of money and choose one safe next step.
- [Karmic tail “Physical suffering” (18/3/12)](https://destinymatrixcalc.com/karmic-tails/karmic-tail-physical-suffering): A careful reading of 18/3/12 without guilt, mystical explanations of illness, or unsafe promises.

## FAQ
### Why is the calculation free?
We believe that fundamental self-knowledge should be accessible to everyone. Our goal is to help people find their path of transformation from Minus to Plus.

### How accurate is the algorithm?
Our algorithm uses the classic 'Matrix Ladini' methodology, supplemented by expert developments for maximum accuracy of descriptions.

### Is the Destiny Matrix fortune telling or science?
It's a numerological-psychological system. It doesn't predict the future (e.g., 'you will marry on the 15th'), but describes the energetic potential of a period. How you use this potential depends on your free will.

### Can the Matrix change?
Your birth code is immutable, like DNA. But how you live the energies changes. That's the essence of the ArcFlow method: you can change the quality of your life by consciously shifting your arcana's energies from minus to plus. The Matrix is a map, and you choose the route.

### Is it safe to calculate a Matrix?
Absolutely. It's a self-analysis tool. There's no magic, rituals, or connections to egregores. You simply receive information about yourself structured through the language of archetypes.

### How is this different from Astrology?
Astrology is based on the position of planets at the time of birth. The Destiny Matrix is based on the vibration of numbers. These systems complement each other, but the Matrix often provides more specific recommendations for ancestral tasks and karmic debts.

### How does the Destiny Matrix work?
It is based on the method of Natalya Ladini and 22 Major Arcana Tarot cards. Our algorithm takes your date of birth and calculates the Octagram. Each energy in the Octagram is interpreted, revealing your blocks, prosperity line, and karmic tasks.

### How does the Destiny Matrix affect energies?
The Destiny Matrix doesn't change energies — it diagnoses them. Energy can be experienced in 'minus' (fears, debts, conflicts) or in 'plus' (resourceful state, money, harmony). Our system provides a step-by-step plan to bring energies into the plus for full transformation.

Calculator-specific FAQ is included in llms-full.txt.

## Reference
- [llms-full.txt](https://destinymatrixcalc.com/llms-full.txt): Full text of key pages (calculators, FAQ, all arcana descriptions)
- [sitemap.xml](https://destinymatrixcalc.com/sitemap.xml): XML sitemap (all URLs, 3 locales)