Desarrolladores y agentes

El catálogo, en JSON

Todo lo que ves en el sitio está disponible como API pública de solo lectura: productos, presentaciones, precios en MXN, kits y blog. Sin llave, sin registro, sin datos personales de por medio. Los mismos datos se exponen también como servidor MCP y como agente A2A.

Descubrimiento automático

Un agente no necesita leer esta página: empieza por el catálogo de APIs y sigue los enlaces.

/.well-known/api-catalog

application/linkset+json

Catálogo de APIs (RFC 9727). Punto de entrada para agentes: lista cada API de este dominio con su descripción, documentación y health check.

/api/v1/openapi.json

application/vnd.oai.openapi+json

Documento OpenAPI 3.1 con todos los endpoints, parámetros y esquemas de respuesta.

/api/v1/health

application/health+json

Estado del servicio: pass cuando responde WooCommerce, warn cuando el catálogo se sirve desde el snapshot local.

/mcp

JSON-RPC 2.0

Servidor Model Context Protocol con las mismas herramientas de catálogo, para agentes que hablan MCP.

/.well-known/agent-card.json

application/json

Ficha A2A (Agent2Agent): mismas herramientas de catálogo, invocables por JSON-RPC en /a2a para agentes que hablan A2A en vez de MCP.

/.well-known/mcp.json

application/json

Ficha del servidor MCP (también en /mcp/server-card — la convención todavía no fija un único lugar).

/.well-known/agent-skills/index.json

application/json

Índice de Agent Skills publicadas: cómo usar este catálogo, en formato SKILL.md con hash de integridad.

/.well-known/ai-catalog.json

application/ai-catalog+json

Catálogo ARD (Agentic Resource Discovery): apunta a la ficha MCP, la ficha A2A y el OpenAPI, para que un registro los indexe.

/auth.md

text/markdown

Nada aquí requiere autenticación. Este documento lo dice explícitamente en vez de dejarlo a la duda.

Endpoints REST

Todos son GET, responden application/json y aceptan peticiones cross-origin.

GET /api/v1/products?limit=50&category=glp1-metabolismo

Lista de productos con nombre, precio MXN, oferta, disponibilidad, categorías e imagen.

GET /api/v1/products/{slug}

Detalle de un producto: descripción, todas las presentaciones con su precio y stock, y galería completa.

GET /api/v1/kits?category=GLP-1

Kits curados con precio individual, precio de kit y ahorro en MXN.

GET /api/v1/posts?limit=20

Publicaciones del blog con fecha y extracto.

GET /api/v1/posts/{slug}

Cuerpo completo del artículo en bloques estructurados.

Ejemplo

curl https://vitalpeptides.app/api/v1/products?limit=3

Cada respuesta de producto incluye source: vale live cuando viene de WooCommerce y snapshot cuando el catálogo se sirve desde la copia local porque la tienda no respondió. Un precio marcado price_is_from: true es el de la presentación más barata, no el del producto.

Servidor MCP

El endpoint https://vitalpeptides.app/mcp expone las herramientas list_products, get_product, list_kits, list_blog_posts y get_blog_post. Todas son de solo lectura. El manifiesto de herramientas está en /.mcp/list-tools.

{
  "mcpServers": {
    "vitalpeptides": {
      "type": "http",
      "url": "https://vitalpeptides.app/mcp"
    }
  }
}

Agente A2A

El endpoint https://vitalpeptides.app/a2a implementa el método message/send del protocolo Agent2Agent (JSON-RPC 2.0) sobre las mismas 5 herramientas del servidor MCP — no es una segunda implementación, invoca el mismo código. No hay lenguaje natural: cada llamada es un DataPart con el nombre de la herramienta y su entrada.

Ejemplo

curl -X POST https://vitalpeptides.app/a2a \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "message/send",
    "params": {
      "message": {
        "role": "user",
        "parts": [{
          "kind": "data",
          "data": { "skill": "get_product", "input": { "slug": "bpc-157" } }
        }]
      }
    }
  }'

La ficha completa —con un ejemplo por herramienta— está en /.well-known/agent-card.json.

Condiciones de uso

Solo lectura. No hay endpoints de escritura, ni de pedidos, ni de cuentas. La API no expone ningún dato personal.
Sin llave, con mesura. Respeta el Cache-Control de cada respuesta en lugar de reconsultar en bucle; el catálogo completo cambia en minutos, no en segundos.
Uso exclusivo en investigación. Todo el material del catálogo se comercializa para investigación (RUO) y no es un medicamento para consumo humano. Si construyes algo encima, no lo presentes como asesoría médica.
Precios en MXN. Los importes son cadenas decimales, no números, para evitar redondeos de punto flotante.

APIs publicadas

Catalog REST API v1

https://vitalpeptides.app/api/v1

Read-only JSON over the public VitalPeptides catalog: products, presentations and prices in MXN, curated kits and blog posts. No key, no auth, no personal data.

Model Context Protocol server

https://vitalpeptides.app/mcp

The same catalog exposed as MCP tools (list_products, get_product, list_kits, list_blog_posts, get_blog_post) over JSON-RPC, for agents that speak MCP.

Agent2Agent (A2A) endpoint

https://vitalpeptides.app/a2a

The same catalog exposed as A2A skills (list_products, get_product, list_kits, list_blog_posts, get_blog_post) over JSON-RPC message/send, for agents that speak A2A instead of MCP.