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. And search everything at once: notes, identities, studies, events, cores and comments.

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

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
  • get_davison
  • scan_transits
  • cast_chart
  • get_milestones
  • get_account_frame

Sky

The year’s lunations, eclipses, ingresses and stations, and the exact aspects between Jupiter and the slow planets; and, for each event, which house it falls in and which points it touches in an identity’s chart. In UT and the tropical zodiac, as in /app/sky.

  • list_sky_events
  • sky_event_impact
  • get_ephemeris_month

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

Human Design

An identity's Human Design chart: the 26 personality and design activations with their gate and line, the defined channels and centers, and the type, authority, profile, definition and cross. Without a birth time there is no type or profile, and the answer says so. The server does not interpret: the meanings are yours.

  • get_human_design

Cohorts

Groups your identities by generation, by decade or by a slow planet in a sign — who among yours has Pluto in Scorpio — and lists each cohort’s members. Computed memberships, never interpreted.

  • list_cohorts
  • get_cohort_members
  • list_cohort_notes
  • upsert_cohort_note

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

Global events and timelines

What happened to the world rather than to someone: the shared catalogue of global events, with their dates and categories, and your timelines, which are your own curations of that catalogue. You can read them, create one, and add or remove events; the catalogue itself is not edited from here.

  • list_timelines
  • list_global_events
  • get_global_event
  • create_timeline
  • add_timeline_events
  • remove_timeline_events

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. Also read and write in a note's comment thread, with the same notice to the people who see it.

  • list_notes
  • get_note
  • upsert_note
  • delete_note
  • list_note_comments
  • add_note_comment
  • list_note_tags

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, timelines and notes. Writes nothing.
write — Write
Create and change: identities, studies, relations, events, timelines and notes.
destructive — Delete
Move an identity or a study to the trash, and delete an event, a note, a relation or an event from a timeline. Grant it only if you really want your assistant to be able to.

How to connect

  1. 1. Choose how to authorize

    Claude — web, desktop and mobile — authorizes with your account: you paste the address, accept on an Astromicelio screen, and there is no token to copy. Claude Code, Cursor and Codex use a personal token: create it in your account under "AI assistants", pick the scopes and copy it, because it is shown only once.

  2. 2. This is the address

    The MCP server for this deployment. It ends in /api/mcp.

  3. 3. Connect your client

    Find yours below. Each block is the format that client actually reads: one meant for another client connects and shows no tools.

Create a token

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

Claude: web, desktop and mobile

Settings → Connectors → Add custom connector. Paste this address, nothing else, and press Connect: an Astromicelio screen opens where you choose what Claude may do and authorize it. What you add on the web shows up on desktop and mobile too.

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

Claude Code

In the terminal. One command; `claude mcp list` confirms it says "Connected". If you would rather not copy a token, drop the two `--header` lines and authorize with `/mcp` inside Claude Code.

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

Cursor

In `~/.cursor/mcp.json` (for all your projects) or `.cursor/mcp.json` (for one). Cursor takes no `type` for a remote server.

{
  "mcpServers": {
    "astromicelio": {
      "url": "https://astromicelio.devenirmovimiento.es/api/mcp",
      "headers": {
        "Authorization": "Bearer amc_TU_TOKEN",
        "x-astromicelio-locale": "en"
      }
    }
  }
}

Codex

In `~/.codex/config.toml`. The token does not go in the file: it goes in the environment variable that `bearer_token_env_var` names, so first export `ASTROMICELIO_MCP_TOKEN=amc_YOUR_TOKEN` in the terminal you open Codex from.

[mcp_servers.astromicelio]
url = "https://astromicelio.devenirmovimiento.es/api/mcp"
bearer_token_env_var = "ASTROMICELIO_MCP_TOKEN"
http_headers = { "x-astromicelio-locale" = "en" }

.mcp.json file

The format of a Claude Code project `.mcp.json`, which other clients copy. Use it if your client asks for JSON with a `type`.

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

In the browser: WebMCP

If your browser has an AI agent built in — Gemini in Chrome, or an extension — Astromicelio can offer it tools from the tab itself. No token needed: the agent works with your session, on what you have open, with the same permissions you have on screen.

Today only Chrome has it, as a trial: turn it on at chrome://flags/#enable-webmcp-testing. Then switch it on in your account, under "AI assistants", "In this browser". It is off by default and applies to that device only.

On any screen

  • list_identities
  • list_studies
  • search
  • open_in_app

With an identity open

  • get_open_identity
  • describe_open_chart
  • describe_open_transits
  • scan_open_transits
  • get_open_solar_return
  • list_open_sky_events
  • get_open_milestones
  • get_open_human_design
  • get_open_numerology
  • list_open_notes
  • list_open_events
  • get_open_relations
  • write_note

With a study open

  • get_open_study
  • get_open_study_synastry

A single write, write_note, and it asks you to confirm on screen before saving. It cannot delete, move to the trash, share, make an identity public or create tokens.

WebMCP is a draft specification and may change. If your browser does not have it, nothing happens: the app works the same.

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. With Codex, check that `bearer_token_env_var` holds the variable name and not the token, and that the variable is exported in the terminal you open it from.
Claude says it could not connect, or that authorization failed.
Check that you pasted the address ending in /api/mcp, with no headers and no token, and that on the Astromicelio screen you pressed "Authorize" with the account that holds your data. If you closed that screen, press Connect again.
Some tools show up but not the ones I need.
The token or the authorization lacks that scope. A read-only one does not see the write tools: they are hidden on purpose, so you are never asked for them. Create another token, or disconnect and authorize again ticking 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.
Categories and labels come back in Spanish.
The server answers in Spanish unless told otherwise. The blocks on this page already carry the x-astromicelio-locale header with your language; if you configured the client by hand, add it.
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, or a connection authorized from Claude, is revoked from your account and stops working on the very next call.