Configuración del agente
Conecta la API de AstroWay a agentes de IA mediante MCP (Model Context Protocol). El catálogo está disponible de dos formas, ambas con tus claves aw_test_* / aw_live_*:
- Hosted (HTTP):
https://mcp.astroway.info/mcp, sin instalación, autenticación con token Bearer. - Stdio (npx):
npx @astroway/mcp, subproceso local, autenticación con variable de entorno, funciona sin conexión.
Obtén una clave gratuita en el panel y después elige tu cliente.
Un dominio en lugar de todo el catálogo
Sección titulada «Un dominio en lugar de todo el catálogo»843 herramientas en una sola respuesta son 3.4 MB que el agente tiene que leer antes de elegir una. La mayoría de los clientes se rinden mucho antes.
https://mcp.astroway.info/mcp/<dominio> entrega una sola materia en lugar de todo. La configuración es la misma, solo cambia la URL.
| Dominio | URL | Herramientas | Tamaño de tools/list |
|---|---|---|---|
| Núcleo de astrología | /mcp/core | 104 | 389 KB |
| Védica | /mcp/vedic | 192 | 970 KB |
| Metafísica china | /mcp/chinese | 60 | 202 KB |
| Helenística y tradicional | /mcp/hellenistic | 59 | 240 KB |
| Tarot | /mcp/tarot | 79 | 209 KB |
| Numerología | /mcp/numerology | 64 | 158 KB |
| Human Design | /mcp/human-design | 27 | 125 KB |
| Pronósticos | /mcp/forecast | 43 | 209 KB |
| Relaciones | /mcp/relationships | 42 | 247 KB |
| Psicológica | /mcp/psychological | 28 | 107 KB |
| Adivinación y esoterismo | /mcp/divination | 79 | 185 KB |
| Lecturas aplicadas | /mcp/applied | 45 | 148 KB |
| Informes | /mcp/reports | 42 | 209 KB |
| Plataforma | /mcp/platform | 42 | 119 KB |
Medido en producción el 2026-09-21. /mcp sigue entregando el catálogo completo, así que nada de lo configurado antes se ha roto. La consulta del saldo y la estimación del coste de una llamada están en todos los dominios, porque un agente limitado a la astrología védica sigue necesitando saber cuánto cuesta una llamada.
GET /domains devuelve esta misma lista como JSON, sin clave. Un dominio desconocido es un 404 con la lista de los reales, no una devolución silenciosa de las 843.
Documentación sin clave: /mcp/docs
Sección titulada «Documentación sin clave: /mcp/docs»La primera pregunta de un agente nunca es “calcula una carta”. Es “qué sabe hacer esta API, cómo es una llamada y cuánto me va a costar”. Las tres se pueden responder sin clave: https://mcp.astroway.info/mcp/docs no gasta ni un crédito, así que tampoco pide autorización.
| Herramienta | Qué hace |
|---|---|
find_endpoint | Busca entre las 770 operaciones. Para cada una devuelve el método, la URL, el precio en créditos, el plan, los campos obligatorios del cuerpo y el enlace a la referencia |
search_docs | Busca en 281 páginas de guías, en ucraniano y en inglés, con la lista de secciones de cada una |
read_doc | Devuelve una página como markdown |
list_docs | El índice completo, agrupado por secciones |
700 de las 770 operaciones tienen precio, y otras 37 están marcadas como operaciones que responden sin clave. Es decir, el coste de un escenario se puede calcular antes de tener una cuenta.
curl https://mcp.astroway.info/mcp/docs \-H "Content-Type: application/json" \-H "Accept: application/json, text/event-stream" \-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"find_endpoint","arguments":{"query":"solar return","limit":2}}}'read_doc solo lee las páginas que están en el índice. Cualquier otra ruta recibe un rechazo, y no sale ninguna petición hacia fuera.
Pide menos que la respuesta completa
Sección titulada «Pide menos que la respuesta completa»Cada herramienta acepta dos parámetros además de los suyos: fields (lista de rutas separadas por comas, relativas a data) y precision (cuántos decimales conservar). Van a la misma API que por REST, y la diferencia en tokens no es retórica.
| Llamada de carta natal por MCP | Bytes |
|---|---|
| sin parámetros, como era antes del 21.09.2026 | 91 737 |
| sin parámetros, hoy | 72 484 |
precision: 2 | 61 356 |
fields: "planets.name,planets.longitude,houses.cusp" más precision: 2 | 1 182 |
Medido en producción el 2026-09-21. Los créditos son iguales en las cuatro filas: la diferencia la paga quien lee la respuesta.
Una ruta que no coincide con ningún campo vuelve en _fields_unmatched. Una lista en la que no coincide nada es 400 FIELDS_UNKNOWN con la lista, no una respuesta vacía. Descripción completa de ambos parámetros: convenciones de la API.
Elige tu cliente
Sección titulada «Elige tu cliente»CI / raw HTTP
Sección titulada «CI / raw HTTP»Sin ningún cliente: el endpoint hosted habla JSON-RPC sobre HTTP. Lista de herramientas con token Bearer:
curl https://mcp.astroway.info/mcp \-H "Authorization: Bearer aw_live_YOUR_KEY" \-H "Content-Type: application/json" \-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Function calling sin MCP
Sección titulada «Function calling sin MCP»Si tu agente habla el function calling de OpenAI o Anthropic en lugar de MCP, pide a la API las definiciones de herramientas ya preparadas y pásalas directamente al modelo. Se generan a partir del documento OpenAPI, así que el esquema que rellena el modelo es el mismo esquema que valida el endpoint.
curl "https://api.astroway.info/v1/agent/tools?format=openai" \-H "X-Api-Key: aw_live_YOUR_KEY"La respuesta tiene dos mitades. tools se ajusta exactamente al contrato del proveedor y no lleva nada nuestro, así que se puede poner tal cual en la llamada al modelo: una clave de más dentro del objeto de una herramienta es un 400 en su lado. executors dice cómo ejecutar cada herramienta y tiene las mismas claves que devolverá el modelo:
{"tools": [ { "type": "function", "function": { "name": "astroway_post_chart", "description": "Natal chart...", "parameters": { "type": "object", "required": ["date", "time", "latitude", "longitude"], "properties": { "...": {} } } } }],"executors": { "astroway_post_chart": { "method": "POST", "path": "/v1/chart", "credits": 20, "group": "Core" }},"count": 26, "totalMatched": 26, "totalAvailable": 751, "truncated": false}A partir de ahí tu ejecutor son cinco líneas: buscar el nombre en executors, enviar los argumentos del modelo como cuerpo JSON a esa ruta con tu X-Api-Key y devolver la respuesta al modelo. Ninguna herramienta contiene credenciales, así que es seguro cachear esta lista.
Tú eliges qué ve el modelo. Por defecto es un conjunto inicial seleccionado de 26 herramientas, no el catálogo completo: OpenAI limita una petición a 128 funciones, y los modelos empiezan a elegir peor mucho antes de ese límite. Reduce o amplía con select=all, select=group:Vedic, select=paths:/chart,/synastry, filtra dentro con q= y limita con limit= (máximo 128). Nada desaparece en silencio: totalMatched y notes dicen qué ha quedado fuera. Añade format=anthropic para obtener { name, description, input_schema }.
La llamada es gratuita y no gasta créditos.
Tu propia clave del modelo
Sección titulada «Tu propia clave del modelo»En los endpoints donde generamos texto, puedes pagar tú mismo los tokens. Dos cabeceras, las dos o ninguna:
curl https://api.astroway.info/v1/ai/explain-aspect \-H "X-Api-Key: aw_live_YOUR_KEY" \-H "X-Provider: anthropic" \-H "X-Provider-Key: sk-ant-YOUR_PROVIDER_KEY" \-H "Content-Type: application/json" \-d '{"planet1":"Saturn","planet2":"Moon","aspectType":"Square"}'X-Provider es uno de openai, anthropic, google, groq, mistral, openrouter, deepseek, together; la dirección de cada uno está fijada en nuestro lado y nunca se toma de la petición. X-Provider-Model es opcional y sustituye al modelo por defecto.
No hay vuelta atrás a nuestra cadena. Si tu clave no funciona, recibirás el estado y el mensaje del proveedor, no una respuesta pagada por nosotros: una vuelta atrás silenciosa gastaría nuestros tokens en una petición que tú considerabas tuya, y sería imposible notarlo.
Una llamada así cuesta 5 créditos en lugar del precio del endpoint. Nosotros seguimos calculando la carta, montando el prompt y pasando las salvaguardas; la generación la has comprado tú.
Tu clave no se registra, no se almacena y no se cachea en ningún sitio. Va en una cabecera porque el cuerpo de la petición se convierte en hash para dos claves de caché, y nuestro registro de peticiones no escribe cabeceras en absoluto. Un error del proveedor que haya citado tu clave se redacta antes de llegar a nuestros logs o a tu respuesta. Una llamada con tu clave se salta ambas cachés en ambos sentidos: nunca recibirá una respuesta generada por nosotros, y su respuesta nunca le llegará a otra persona.
Las cabeceras están en la especificación. Cada ruta que las acepta declara X-Provider, X-Provider-Key y X-Provider-Model en /v1/openapi.json, así que un cliente generado las conectará como cualquier otro parámetro y no necesitará esta página. Solo están declaradas donde realmente llamamos a un modelo: puedes enviarlas a /chart, pero no pasará nada y pagarás el precio normal del endpoint.
Especificaciones legibles por máquina
Sección titulada «Especificaciones legibles por máquina»¿Quieres conectar la API REST directamente o darle la especificación a tu propio agente?
- AGENTS.md:
/AGENTS.md, instrucciones para el agente (qué se puede llamar sin clave, contrato de la petición, envoltorio de la respuesta, cabeceras de límites) - OpenAPI:
/v1/openapi.json - llms.txt:
/llms.txt· texto completo/llms-full.txt - Postman:
/postman/astroway-api.json - SDK: TypeScript, Python, PHP