• DATA
  • INSIGHT
  • SUMMARY
  • HUMAN

How to analyze relationship compatibility with your AI

Connect AstrologyAPI to your agent to turn birth details into astrological profiles. Once connected, your AI handles the planetary math for you.

Ask AI about this page

Short answer

Can my AI do astrological matchmaking?

Yes. You provide the birth data for two people, and your agent uses AstrologyAPI to pull the specific planetary positions needed for a report. You'll get a breakdown of how those charts interact.

The results you'll see

What the analysis produces

Your agent turns raw birth data into specific relationship insights.

DATA

Planetary positions

The AI pulls exact birth chart data through the connector. You get the specific placements needed for any astrological calculation.

INSIGHT

Compatibility reports

Your agent generates deep dives into how two charts align. It looks at specific aspects to explain relationship dynamics.

SUMMARY

Personality profiles

The AI builds individual profiles based on the birth data. This helps you understand the fundamental nature of each person.

HUMAN

Personal judgment

The AI provides the data and the logic. You decide how to apply these insights to your actual life.

The workflow

What your AI does when the data arrives.

The AI moves from raw birth information to a finished compatibility analysis.

  1. Collect birth data

    You give your agent the birth dates, times, and locations for both individuals. The AI prepares this information for the API.

    get_matchmaking_details

  2. Fetch astrological data

    The agent calls the connector to pull the specific planetary and house data for both people.

    get_matchmaking_details

  3. Calculate alignments

    The AI analyzes the relationship between the two sets of data to find points of tension or harmony.

    get_matchmaking_details

  4. Generate report

    The agent writes a structured breakdown of the compatibility findings based on the retrieved details.

    get_matchmaking_details

Try it

Copy these to start.

Use these prompts to trigger the analysis once you've connected the MCP.

Starting points

Swap the bracketed birth info with the actual dates, times, and locations you want to check.

AstrologyAPI Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_3ug39IyyzqLBiPQgO2FViFnzlKymV005zYkOevrz/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — AstrologyAPI capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "astrologyapi-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_3ug39IyyzqLBiPQgO2FViFnzlKymV005zYkOevrz/mcp"
    }
  }
}
Copy into chat04

  • Use AstrologyAPI to run a matchmaking report for two people: Person A (Jan 12, 1990, 14:30, NYC) and Person B (March 5, 1988, 08:15, London).

  • Analyze the compatibility between these two birth charts: [Insert Data Here].

  • Get the matchmaking details for a couple born on [Date 1] and [Date 2] to see their planetary alignments.

  • Based on the birth data for [Person A] and [Person B], what are the main astrological strengths of this relationship?

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect AstrologyAPI once, then ask.

One click connects the MCP to your client. Your credentials stay encrypted and secure while your agent gains access to the astrological data tools.

Connect AstrologyAPI to your AI

FAQ

How the analysis behaves

  • 01

    Do I need to provide exact birth times?

    Yes. For accurate house placements and specific planetary degrees, the exact time is necessary.

  • 02

    Can the AI predict the future of my relationship?

    No. The AI analyzes astrological placements and patterns, but it cannot predict future events.

  • 03

    Does the AI store my birth data?

    No. The data is passed to the tool to perform the calculation and is not stored by the connector.

  • 04

    Can the AI change my birth chart?

    No. The AI can only read and interpret the data provided through the tool; it cannot alter the astrological data itself.

  • 05

    What happens if I don't have the birth location?

    The tool requires location data to calculate the correct house positions, so you should provide it for a complete report.

  • More questions about AstrologyAPI? The Connector page answers them. See everything the AstrologyAPI Connector can do

Connect AstrologyAPI to Claude, Cursor, ChatGPT & more