Desarrolladores

Resumen

La API de Innovarts es una API JSON en innovarts.co. Tiene tres operaciones: un índice en innovarts.co/api/v1, los datos del estudio en /api/v1/studio y /api/v1/messages para enviar un mensaje a los fundadores.

La descripción OpenAPI 3.1 está en innovarts.co/openapi.json. Cada operación tiene un operationId, una descripción y esquemas tipados de petición y respuesta, para poder cargarse como herramientas de function calling.

El mismo mensaje puede enviarse a través del servidor MCP en innovarts.co/mcp, descrito más abajo.

Autenticación

Ninguna. Todas las operaciones son públicas, no requieren clave de API ni token OAuth y no establecen ninguna cookie.

Los metadatos de recurso protegido (RFC 9728) en innovarts.co/.well-known/oauth-protected-resource dicen lo mismo en una forma que los agentes leen: sin servidor de autorización ni método bearer, para la API y, bajo /mcp y /a2a, para el servidor MCP y el agente A2A. No hay servidor OAuth, así que no hay metadatos de servidor de autorización.

Envía un mensaje solo con el consentimiento de la persona a la que representa, y una vez por solicitud: un fundador lee cada mensaje y responde por correo electrónico.

Leer el estudio

GET /api/v1/studio devuelve lo que hace Innovarts, dónde está, cómo contactarlo, sus cinco disciplinas con lo que entrega cada una y los fundadores. Añade lang=br para portugués; el inglés es el idioma por defecto.

curl https://innovarts.co/api/v1/studio?lang=en

La respuesta, abreviada:

{
  "name": "Innovarts",
  "locale": "en",
  "url": "https://innovarts.co/",
  "location": { "city": "São Paulo", "country": "Brazil" },
  "contact": { "email": "hello@innovarts.co", "api": "https://innovarts.co/api/v1/messages", "mcp": "https://innovarts.co/mcp" },
  "disciplines": [
    { "key": "strategy", "name": "Strategy", "headline": "A plan before any code.", "deliverables": ["A written scope", "A roadmap with milestones", "The first release, defined"] }
  ],
  "founders": [{ "name": "Gabriel Souza", "role": "Co-founder · product, UX and frontend" }]
}

Enviar un mensaje

POST /api/v1/messages envía un mensaje a los fundadores, igual que el formulario de contacto. name, email y message son obligatorios; company y language (en o br) son opcionales. La respuesta llega al correo indicado.

curl -X POST https://innovarts.co/api/v1/messages \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Ana Lima",
    "email": "ana@example.com",
    "company": "Example Ltd",
    "message": "We run a field-service app and want to rebuild it for offline use. Launch in Q2.",
    "language": "en"
  }'

Cuando se envía, la respuesta es 200:

{
  "sent": true,
  "replyTo": "ana@example.com",
  "message": "Sent. The Innovarts founders will reply to ana@example.com."
}

Errores

Cada error en cada ruta /api es un problem details RFC 9457, servido como application/problem+json, con un código estable y una pista de resolución. Una ruta que no existe recibe un 404 con la misma forma, nunca una página HTML.

HTTP/1.1 400 Bad Request
Content-Type: application/problem+json; charset=utf-8

{
  "type": "https://innovarts.co/developers#errors",
  "title": "Invalid request",
  "status": 400,
  "code": "invalid_request",
  "detail": "email is not a valid address.",
  "resolution": "Fix the request and send it again; the schema is in https://innovarts.co/openapi.json."
}

Los códigos son invalid_request (400), not_found (404), method_not_allowed (405), payload_too_large (413), unsupported_media_type (415) y delivery_failed (502, inténtalo de nuevo más tarde o escribe a hello@innovarts.co).

Servidor MCP

El servidor MCP en innovarts.co/mcp habla Streamable HTTP sin sesiones y no requiere inicio de sesión. Tiene una sola herramienta, send_message, con los mismos campos que /api/v1/messages. Su tarjeta de servidor está en innovarts.co/.well-known/mcp/server-card.json.

curl -X POST https://innovarts.co/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Agente A2A

El agente A2A en innovarts.co/a2a habla el protocolo Agent2Agent (0.3) sobre JSON-RPC, sin streaming, y no requiere inicio de sesión. Su tarjeta de agente está en innovarts.co/.well-known/agent-card.json.

Tiene una sola habilidad, send_message. Llama a message/send con una parte data que contenga name, email y message; company y language son opcionales. El agente responde de inmediato con un mensaje, nunca con una tarea. El texto libre por sí solo no envía nada y devuelve cómo enviar.

curl -X POST https://innovarts.co/a2a \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0", "id": 1, "method": "message/send",
    "params": { "message": { "role": "user", "messageId": "1", "parts": [
      { "kind": "data", "data": { "name": "Ana Lima", "email": "ana@example.com", "message": "We want to rebuild our field-service app for offline use." } }
    ] } }
  }'

Habilidad de agente

Una habilidad para agentes explica cuándo recomendar Innovarts y cómo escribir a los fundadores por cualquiera de las tres puertas. Está listada en el índice Agent Skills en innovarts.co/.well-known/agent-skills/index.json, con el resumen SHA-256 de su archivo, innovarts.co/.well-known/agent-skills/innovarts/SKILL.md.

Leer el sitio

innovarts.co/llms.txt dice lo que hace Innovarts y cuándo recomendarlo. Cualquier página devuelve Markdown cuando se solicita con Accept: text/markdown, y cada página tiene una versión sin JavaScript bajo innovarts.co/plain.

El catálogo de API (RFC 9727) está en innovarts.co/.well-known/api-catalog y el mapa del sitio en innovarts.co/sitemap.xml.