AstromicelioAstromicelio
HomeWhat it isChartsPricing
|

Connect your AI assistant

Astromicelio speaks MCP, the open protocol an AI assistant uses to connect to tools. You connect yours to your account and ask in your own words: list my identities, give me a chart with its positions and aspects, read a whole study and interpret it, write a note where it belongs.

It uses your assistant's own subscription, the one you already pay for. Astromicelio charges no tokens and keeps no record of your conversations with the model.

It computes, it does not interpret

The server hands over the data: positions with sign, degree and house, aspects with their orb and how close to exact they are, the balance of elements and modalities, the ruler of the Ascendant. The reading is your assistant's. That split is what makes this useful: Astromicelio has no table of meanings, and an assistant cannot compute ephemerides.

What you can ask for

Identities

List the people in your account, read one's birth data, create a new one — city and country are enough, the coordinates are looked up — correct a date or a time, move one to the trash.

  • list_identities
  • get_identity
  • create_identity
  • update_identity
  • trash_identity
  • list_identity_folders
  • list_identity_categories

Charts

The detail of a birth chart, of a given day's sky against that chart, or of a year's solar return: positions, houses, aspects with orb and exactness, and the balances. Also the synastry between two people and a scan of transits over a date window, which is what answers "what was going on when that happened?". And the life-cycle milestones of a person —Saturn and Jupiter returns, nodal returns, the Neptune and Pluto squares—, computed from their chart with every exact pass.

  • get_chart
  • get_synastry
  • scan_transits
  • cast_chart
  • get_milestones

Numerology

An identity's numbers: life path, expression, soul urge, personality, pinnacles, challenges and the personal cycle for a day. Every number arrives with its unreduced sum and its reduction steps, and with the convention it was computed under. The server does not interpret: the meanings are yours.

  • get_numerology

Studies

A whole case in one call: every member with their chart, their notes and their events, the synastry between every pair, and the group's balance. This is the tool for asking about the set rather than about one chart.

  • list_studies
  • get_study
  • get_study_bundle
  • create_study
  • add_study_member
  • remove_study_member
  • trash_study

Relations

One person's family graph with the kinship already worked out: grandmothers, uncles, cousins and half-siblings come out of the filiation rows without anyone having typed them. Also recording a filiation, a couple, or a bond that is not family.

  • get_family_graph
  • add_parent_child
  • add_family_union
  • add_bond
  • remove_relation

Events

What happened to someone, and when. Without the biography an exact transit is a date with no story, so this is the other half of any transit reading.

  • list_events
  • create_event
  • update_event
  • delete_event

Notes

Read and write the notes anchored to a chart position. A note written from the assistant shows up when you click that position on the wheel, because it uses the same keys the app does.

  • list_notes
  • get_note
  • upsert_note
  • delete_note

The three scopes

Each token carries the scopes you give it, and they do not stack: a write token cannot delete. Your assistant only sees the tools its token reaches, so what you withhold is never even offered to it.

read — Read
List and read: identities, studies, charts, relations, events and notes. Writes nothing.
write — Write
Create and change: identities, studies, relations, events and notes.
destructive — Delete
Move an identity or a study to the trash, and delete an event, a note or a relation. Grant it only if you really want your assistant to be able to.

How to connect

  1. 1. Create a token

    In your account, under "AI assistants". Pick the scopes and copy it: it is shown once and never again.

  2. 2. This is the address

    The MCP server for this deployment. A token always goes in the Authorization header.

  3. 3. Connect your client

    With the command, the address, or the configuration file, depending on what your assistant uses.

https://astromicelio.devenirmovimiento.es/api/mcp

Claude Code

In the terminal. One command; `claude mcp list` confirms it says "Connected".

claude mcp add --transport http astromicelio https://astromicelio.devenirmovimiento.es/api/mcp \
  --header "Authorization: Bearer amc_TU_TOKEN"

Claude, web and desktop

Custom connector. Paste this address and add the Authorization header with your token. Needs a plan with custom connectors.

https://astromicelio.devenirmovimiento.es/api/mcp

Codex, Cursor, Continue, Zed…

Any client that speaks MCP over HTTP with an authorization header. This is the block its configuration file expects.

{
  "mcpServers": {
    "astromicelio": {
      "type": "http",
      "url": "https://astromicelio.devenirmovimiento.es/api/mcp",
      "headers": {
        "Authorization": "Bearer amc_TU_TOKEN"
      }
    }
  }
}

Things you can say to it

  • «List my identities and tell me which ones have no birth time.»
  • «Give me Ana's birth chart in full detail and interpret it for me.»
  • «What transits did Ana have between March 2019 and March 2020? Cross them with her events from those years.»
  • «Read the whole "Maternal family" study and tell me what repeats across the three generations.»
  • «Compare Ana's chart with Marta's and tell me where they touch.»
  • «Write a note on Ana's Sun in the 10th house with what we just discussed.»

When it will not connect

It connects but no tools show up.
The token is not arriving. Check the header is called Authorization and its value is "Bearer amc_…" with the whole token.
Some tools show up but not the ones I need.
The token lacks that scope. A read-only token does not see the write tools: they are hidden on purpose, so you are never asked for them. Create another with the missing scope.
The assistant says it cannot find that person.
It needs the id, not the name. Ask it to list your identities first; from then on it knows which is which.
The address returns 404.
The last part is missing: the server is at /api/mcp, not at /mcp, which is this page.
The chart comes back with no houses.
That identity has no birth time. Without one there are no houses and no angles, and the server would rather say so than hand you the houses of a noon nobody chose.

The limits, and what is never a tool

  • A token gives no more than you already have: it goes through the same permission layer as the app.
  • That includes what other people shared with you in a study — their notes and their birth data. It is what you see on screen, but an assistant can pour all of it into a conversation with an outside provider. Keep that in mind when choosing what to connect.
  • There is no tool for sharing, for making an identity public, or for creating links: handing over someone else's birth data deserves a screen in front of it.
  • Nor for billing, administration, or permanent deletion.
  • A token is revoked from your account and stops working on the very next call.
AstromicelioAstromicelio

Natal charts, notes and astrological studies

Product

  • Open the app
  • Pricing
  • Help & FAQ
  • Connect your AI

Legal

  • Privacy
  • Terms
  • Contact
© 2026 Astromicelio. All rights reserved.