Dexyd DevelopersAPI, webhooks y asistentes de IA

Conecta Oria y tus asistentes de IA al contexto Dexyd autorizado.

MCP permite que Oria o tus asistentes de IA entiendan la actividad de Dexyd, encuentren la información correcta, preparen acciones y acompañen a los usuarios sin perder el control sobre decisiones sensibles.

ContextoContexto Dexyd aprovechable.
AccionesAcciones mejor preparadas.
ValidaciónValidación en manos del usuario.

Búsqueda

Encuentra concursos, talentos y proyectos desde una petición natural.

Pilotaje

Sigue la actividad sin recorrer todos los menús.

Preparación

Crea y mejora más rápido sin partir de una página en blanco.

Personalización

Adapta la experiencia desde una simple petición.

Progresión

Ayuda a los participantes a mejorar sus competencias.

Control

Mantén la validación final dentro de Dexyd.

Endpoint

Llamar a Dexyd MCP

El servidor MCP de Dexyd habla JSON-RPC sobre HTTP POST. Acepta initialize, tools/list y tools/call.

POST /api/agent/mcp
Single MCP server endpoint.
Authentication
Authorization: Bearer <developer key>

The agent:mcp scope is required.

Methods
initialize, tools/list, tools/call.
Batch
A JSON-RPC request array is accepted.
List tools
curl "https://www.dexyd.com/api/agent/mcp" \
  -H "Authorization: Bearer dxyd_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'
Herramientas

Herramientas MCP disponibles

Cada herramienta tiene un esquema de entrada publicado por tools/list. Las herramientas de escritura no modifican Dexyd directamente.

dexyd_context
Returns compact context with search, media and integration status.
dexyd_search
Searches contests, submissions and creator profiles.
dexyd_media_feed
Reads the Dexyd media feed.
dexyd_import_media
Imports a public URL or Google Drive/Docs file.

Scope media:import.

dexyd_prepare_competition_draft
Prepares a contest draft for confirmation.

Scopes agent:mcp and drafts:write.

dexyd_prepare_expo_product_draft
Prepares an Expo product draft for confirmation.

Scopes agent:mcp and drafts:write.

dexyd_prepare_profile_bio_update
Prepares a public bio update.

Scopes agent:mcp and drafts:write.

Call a tool
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "dexyd_prepare_competition_draft",
    "arguments": {
      "title": "Challenge prototype",
      "description": "Brief public du concours",
      "submission_end": "2026-07-31T23:59:00Z"
    }
  }
}
Control

Borradores confirmables

Las herramientas de preparación devuelven confirmation_required=true con pending_action. El usuario decide después si se envía a Dexyd.

create_competition
Prepares a payload for /api/competitions.
create_expo_product
Prepares a payload for /api/expo-products.
update_profile
Prepares only the profile bio field.
  • Identity fields, email, phone, avatar and location are not changed by the bio tool.
Errores

Códigos MCP y HTTP

Los errores JSON-RPC permanecen en la respuesta MCP; los errores de acceso usan estados HTTP habituales.

-32700
Invalid JSON.
-32601
Unknown JSON-RPC method.
-32000
Error returned by the called tool.
401 / 403 / 402
Missing key, insufficient scope or unauthorized plan.