Para Agentes IA.
Endpoints de descubrimiento, Protocolo A2A y API pública, todo lo que un agente IA necesita para encontrar y usar StudioMeyer.
Discovery
Cómo nos encuentran los agentes
Dos endpoints estandarizados bajo la ruta .well-known permiten el descubrimiento automático de agentes.
agents.json
agents.json / Open Standard for Agent DiscoveryHerramientas con parámetros, endpoints y descripciones. Permite a los agentes descubrir acciones disponibles automáticamente.
agent-card.json
A2A Protocol 1.0 + 0.3 (Linux Foundation)8 habilidades con ejemplos, etiquetas y modos de E/S. El endpoint ejecuta exactamente estas, en A2A 1.0 y 0.3.
Verificar los recursos de StudioMeyer
Nuestro catálogo ARD identifica el origen de cada recurso. Las entradas firmadas se pueden verificar con nuestra clave pública: la firma vincula al editor, la dirección y la descripción. Sin firma, HTTPS solo confirma la publicación en nuestro dominio.
El perfil de verificación de StudioMeyer describe el vínculo con el dominio, la canonicalización JSON y la verificación ES256. La firma protege la entrada del catálogo, no el contenido que se consulta después en una API ni una certificación independiente.
Protocolo A2A
Comunicación Agent-to-Agent
Endpoint JSON-RPC 2.0 para comunicación directa entre agentes, en A2A 1.0 (cabecera A2A-Version: 1.0) y 0.3 (sin cabecera) en la misma dirección. El texto libre va al asistente, las habilidades estructuradas se eligen con message.metadata.skillId. Con el contextId devuelto la conversación continúa.
Request
curl -X POST https://studiomeyer.io/api/a2a \
-H "Content-Type: application/json" \
-H "A2A-Version: 1.0" \
-d '{
"jsonrpc": "2.0",
"method": "SendMessage",
"id": "req-1",
"params": {
"message": {
"messageId": "msg-1",
"role": "ROLE_USER",
"parts": [{ "text": "What services do you offer?" }]
}
}
}'Respuesta
{
"jsonrpc": "2.0",
"id": "req-1",
"result": {
"task": {
"id": "task_…",
"contextId": "ctx_…",
"status": { "state": "TASK_STATE_COMPLETED", "timestamp": "…" },
"artifacts": [{
"artifactId": "art_…",
"name": "answer",
"parts": [{ "text": "StudioMeyer builds custom-coded websites …" }]
}],
"metadata": { "skillId": "chat" }
}
}
}SendMessageEnviar mensaje, devuelve la tarea con el resultado (0.3: message/send)
GetTaskConsultar una tarea de nuevo (0.3: tasks/get)
ListTasksLas tareas de una conversación, por contextId
CancelTaskCancelar una tarea en espera (0.3: tasks/cancel)
API pública v1
9 herramientas para agentes
Estos endpoints de lectura y consulta son públicos, abiertos a CORS y con límite de tasa (60 req/min por IP) y no requieren registro. El acceso vinculado a usuarios va aparte: los servidores MCP mediante OAuth 2.1 con PKCE, y el portal con inicio de sesión por Google, GitHub, Discord o enlace mágico.
Integración
Guía de inicio rápido
Descubrimiento
El agente obtiene /.well-known/agents.json y descubre herramientas disponibles.
Verificar Capacidades
El agente lee agent-card.json para habilidades, modos de E/S y endpoint A2A.
Llamar API
El agente usa herramientas vía /api/v1/ o envía tareas vía A2A.
Procesar Resultado
Respuestas JSON estructuradas, sin scraping, sin parsing necesario.
Límites y CORS
Política de uso justo
Rate Limiting
- -60 requests / minute per IP
- -X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset Headers
- -429 Too Many Requests + Retry-After Header
CORS
- -Access-Control-Allow-Origin: *
- -Estos endpoints sin registro
- -Todas las respuestas en JSON
¿AI-Ready para tu web?
Hacemos sitios web listos para agentes IA. WebMCP, agents.json y A2A, completamente en marca blanca.
Hazte AI-Ready