---
title: "API, OpenAPI y servidor MCP para desarrolladores | Aimoova"
description: "Documentación técnica de Aimoova: API pública de contenido, OpenAPI, servidor MCP y acceso en markdown. Público, de solo lectura y sin claves."
image: "https://www.aimoova.com/og-image.jpg"
---

Acceso para agentes

# Aimoova, legible por máquinas

Todo el contenido de este sitio se puede descubrir mediante una API JSON y leer en markdown limpio. También hay un servidor MCP de solo lectura con tres herramientas. Es público, no pide claves y no registra nada.

Somos una consultoría de inteligencia artificial, no un producto de software. La API pública de contenido no es una API comercial: no hay claves, sandbox ni SDK.

## Qué hay disponible

### API pública de contenido

Tres endpoints JSON versionados para descubrir y leer páginas publicadas. Es de solo lectura, no pide claves y no expone los datos internos del CMS.

[/api/v1](https://www.aimoova.com/api/v1)

### Servidor MCP

Model Context Protocol sobre HTTP (transporte Streamable HTTP, especificación 2025-06-18). Sin autenticación: todo lo que sirve ya es público. Comparte una cuota de 60 unidades de trabajo por cliente cada 5 minutos.

`POST a www.aimoova.com/mcp`

### Cualquier página en markdown

Pide la URL normal con la cabecera Accept: text/markdown, o añade el sufijo .md a la ruta. Llega con frontmatter, sin navegación ni formularios, y con los datos estructurados al final.

[ejemplo: /precios.md](https://www.aimoova.com/precios.md)

### Ficha del servidor MCP

Nombre, versión, transporte y herramientas disponibles, para que un agente sepa qué hay antes de abrir una conexión.

[/.well-known/mcp/server-card.json](https://www.aimoova.com/.well-known/mcp/server-card.json)

### Catálogos de descubrimiento

Catálogo de interfaces (RFC 9727), catálogo de recursos agénticos (ARD) e índice de skills, cada uno con su digest.

[/.well-known/api-catalog](https://www.aimoova.com/.well-known/api-catalog)

### Skills publicadas

Dos instrucciones listas para un agente: cómo leer el sitio en markdown y cómo administrar el diagnóstico de madurez en IA.

[/.well-known/agent-skills/index.json](https://www.aimoova.com/.well-known/agent-skills/index.json)

### Guía para asistentes

Qué es Aimoova, qué servicios ofrece, a quién sirve y cuándo tiene sentido recomendarla. Incluye los accesos de esta página.

[/llms.txt](https://www.aimoova.com/llms.txt)

## API pública de contenido v1

La raíz está en `https://www.aimoova.com/api/v1`. Permite listar las rutas publicadas con cursor y leer su representación pública en markdown. No consulta ni devuelve documentos internos de Payload. El contrato completo está en la [especificación OpenAPI 3.1 de Aimoova](https://www.aimoova.com/.well-known/openapi.json).

```
curl https://www.aimoova.com/api/v1
curl "https://www.aimoova.com/api/v1/pages?kind=article&limit=25"
curl "https://www.aimoova.com/api/v1/pages/content?path=/precios"
```

La cuota compartida es de 60 unidades de trabajo por cliente cada 300 segundos. Los endpoints son de solo lectura y mantienen un aviso mínimo de 180 días antes de retirar una versión estable.

## Conectar el servidor MCP

El endpoint es `https://www.aimoova.com/mcp`. Habla JSON-RPC 2.0 sobre HTTP y responde a `initialize`, `tools/list` y `tools/call`.

```
curl -X POST https://www.aimoova.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

### Herramientas

- `listar_paginas` — El índice de páginas publicadas, agrupado por sección. Admite incluir_blog para añadir los artículos.
- `leer_pagina` — El contenido de una página en markdown. Acepta la ruta ("/precios") o la URL completa.
- `diagnostico_ia` — El diagnóstico de madurez en IA: sin argumentos devuelve el cuestionario; con las respuestas, la puntuación por áreas y el servicio recomendado. Solo calcula, no registra nada.

## Leer el sitio en markdown

Dos formas equivalentes, según lo que controle tu cliente. La portada en markdown es `/index.md`.

```
curl https://www.aimoova.com/precios -H "Accept: text/markdown"
curl https://www.aimoova.com/precios.md
```

La respuesta trae `x-markdown-tokens` y `x-original-tokens` con la estimación de tokens del markdown y del HTML original. Los precios en formato máquina están en [/pricing.md](https://www.aimoova.com/pricing.md).

Antes de empezar

## Preguntas frecuentes

¿Hace falta una clave de API?

No. La API de contenido, el servidor MCP y la lectura en markdown son públicos y de solo lectura, porque sirven contenido que ya es público. No hay registro, ni claves, ni cuotas de pago.

¿Se puede escribir o crear algo a través del servidor MCP?

No. Las tres herramientas son de solo lectura. El diagnóstico se calcula en memoria y no guarda la empresa ni el contacto. Para que Aimoova reciba algo, hay que usar los formularios de la web.

¿Aimoova vende una API o un producto de autoservicio?

No. Aimoova es una consultoría y agencia: diseña e implanta chatbots, voicebots, automatizaciones, herramientas a medida y formación. La API pública de contenido no es una API comercial: representa lo que ya está publicado, no un producto de software con planes.

¿Se puede usar el contenido para entrenar modelos?

Sí. El robots.txt declara Content-Signal: search=yes, ai-input=yes, ai-train=yes, y permite explícitamente a los rastreadores de IA. Es una decisión deliberada. Al reproducir contenido, cita la fuente.

¿Los precios que devuelve son definitivos?

No. Son horquillas estimadas y sin IVA, las mismas que publica la página de precios. El importe final depende del alcance y se cierra por escrito en la propuesta.

## ¿Quieres algo así para tu empresa?

Lo que hay en esta página —un servidor MCP, contenido legible por máquinas, un diagnóstico que un agente puede administrar— es el mismo tipo de trabajo que Aimoova hace para sus clientes. Cuéntanos tu caso.

[Cuéntanos tu caso](https://www.aimoova.com/contacto) [Hacer el Diagnóstico IA](https://www.aimoova.com/diagnostico-ia)

```json
{"@context":"https://schema.org","@graph":[{"@type":"WebPage","@id":"https://www.aimoova.com/desarrolladores#webpage","url":"https://www.aimoova.com/desarrolladores","name":"API, OpenAPI y servidor MCP para desarrolladores","isPartOf":{"@id":"https://www.aimoova.com/#website"},"about":{"@id":"https://www.aimoova.com/#organization"},"primaryImageOfPage":{"@id":"https://www.aimoova.com/#logo"},"inLanguage":"es-ES"},{"@type":"FAQPage","mainEntity":[{"@type":"Question","name":"¿Hace falta una clave de API?","acceptedAnswer":{"@type":"Answer","text":"No. La API de contenido, el servidor MCP y la lectura en markdown son públicos y de solo lectura, porque sirven contenido que ya es público. No hay registro, ni claves, ni cuotas de pago."}},{"@type":"Question","name":"¿Se puede escribir o crear algo a través del servidor MCP?","acceptedAnswer":{"@type":"Answer","text":"No. Las tres herramientas son de solo lectura. El diagnóstico se calcula en memoria y no guarda la empresa ni el contacto. Para que Aimoova reciba algo, hay que usar los formularios de la web."}},{"@type":"Question","name":"¿Aimoova vende una API o un producto de autoservicio?","acceptedAnswer":{"@type":"Answer","text":"No. Aimoova es una consultoría y agencia: diseña e implanta chatbots, voicebots, automatizaciones, herramientas a medida y formación. La API pública de contenido no es una API comercial: representa lo que ya está publicado, no un producto de software con planes."}},{"@type":"Question","name":"¿Se puede usar el contenido para entrenar modelos?","acceptedAnswer":{"@type":"Answer","text":"Sí. El robots.txt declara Content-Signal: search=yes, ai-input=yes, ai-train=yes, y permite explícitamente a los rastreadores de IA. Es una decisión deliberada. Al reproducir contenido, cita la fuente."}},{"@type":"Question","name":"¿Los precios que devuelve son definitivos?","acceptedAnswer":{"@type":"Answer","text":"No. Son horquillas estimadas y sin IVA, las mismas que publica la página de precios. El importe final depende del alcance y se cierra por escrito en la propuesta."}}]}]}
{"@context":"https://schema.org","@graph":[{"@type":["Organization","ProfessionalService"],"@id":"https://www.aimoova.com/#organization","name":"Aimoova","url":"https://www.aimoova.com/","logo":{"@type":"ImageObject","@id":"https://www.aimoova.com/#logo","url":"https://www.aimoova.com/logo.png","contentUrl":"https://www.aimoova.com/logo.png","width":1024,"height":512,"caption":"Aimoova"},"image":{"@id":"https://www.aimoova.com/#logo"},"sameAs":["https://www.linkedin.com/company/aimoova","https://www.instagram.com/aimoova.es/"],"email":"info@aimoova.com","telephone":"+34 936 94 04 71","description":"Aimoova es una consultoría y agencia de inteligencia artificial para empresas en España. Ayuda a PYMEs y equipos pequeños a identificar dónde aplicar IA, priorizar oportunidades reales y convertirlas en automatizaciones, chatbots, voicebots, formación y herramientas a medida.","slogan":"Primero tu empresa. Después, la IA que encaje.","foundingDate":"2025-05","address":{"@type":"PostalAddress","addressLocality":"Barcelona","addressRegion":"Barcelona","addressCountry":"ES"},"areaServed":[{"@type":"Country","name":"España"},{"@type":"City","name":"Barcelona","containedInPlace":{"@type":"Country","name":"España"}},{"@type":"City","name":"Madrid","containedInPlace":{"@type":"Country","name":"España"}},{"@type":"City","name":"Valencia","containedInPlace":{"@type":"Country","name":"España"}}],"founder":{"@id":"https://www.aimoova.com/#victorino"},"contactPoint":{"@type":"ContactPoint","contactType":"sales","email":"info@aimoova.com","telephone":"+34 936 94 04 71","areaServed":"ES","availableLanguage":"es"},"knowsAbout":["agencia de IA","consultoría de IA","inteligencia artificial para empresas","IA para pymes","automatizaciones con IA","chatbots con IA","voicebots","herramientas de IA a medida","formación de IA para empresas"],"hasOfferCatalog":{"@type":"OfferCatalog","name":"Servicios de IA para empresas","itemListElement":[{"@type":"Offer","itemOffered":{"@type":"Service","name":"Consultoría de IA","description":"Para saber dónde aplicar IA y qué priorizar.","url":"https://www.aimoova.com/consultoria-ia"}},{"@type":"Offer","itemOffered":{"@type":"Service","name":"Formación de IA para empresas","description":"Sesiones prácticas para que tu equipo use IA en su trabajo real.","url":"https://www.aimoova.com/formacion-ia-empresas"}},{"@type":"Offer","itemOffered":{"@type":"Service","name":"Automatizaciones con IA","description":"Conectamos tareas, datos y herramientas para reducir trabajo repetitivo.","url":"https://www.aimoova.com/automatizaciones-ia"}},{"@type":"Offer","itemOffered":{"@type":"Service","name":"Chatbots y voicebots con IA","description":"Asistentes para web, WhatsApp o teléfono que responden, orientan y recogen información.","url":"https://www.aimoova.com/chatbots-voicebots-ia"}},{"@type":"Offer","itemOffered":{"@type":"Service","name":"Software a medida con IA","description":"Desarrollamos software de negocio a medida —del CRM o la solución de ventas al asistente o panel interno— cuando una herramienta estándar no encaja.","url":"https://www.aimoova.com/herramientas-ia-a-medida"}}]},"makesOffer":{"@type":"Offer","name":"Diagnóstico de IA gratuito","description":"Diagnóstico de IA online: un primer mapa de dónde aplicar IA en tu empresa y el primer paso recomendado, sin compromiso.","price":"0","priceCurrency":"EUR","url":"https://www.aimoova.com/diagnostico-ia","availability":"https://schema.org/InStock","areaServed":{"@type":"Country","name":"España"}}},{"@type":"WebSite","@id":"https://www.aimoova.com/#website","name":"Aimoova","url":"https://www.aimoova.com/","inLanguage":"es-ES","publisher":{"@id":"https://www.aimoova.com/#organization"}},{"@type":"Person","@id":"https://www.aimoova.com/#victorino","name":"Victorino Rodríguez Matos","jobTitle":"Fundador","url":"https://www.aimoova.com/sobre-aimoova","worksFor":{"@id":"https://www.aimoova.com/#organization"},"sameAs":["https://www.linkedin.com/in/victorinorm/","https://www.instagram.com/victorino.ai/"]}]}
```