Collega Oria e i tuoi assistenti IA al contesto Dexyd autorizzato.

MCP permette a Oria o ai tuoi assistenti IA di comprendere l’attività Dexyd, trovare le informazioni giuste, preparare azioni e accompagnare gli utenti senza perdere il controllo sulle decisioni sensibili.

ContestoContesto Dexyd utilizzabile.

AzioniAzioni preparate meglio.

ValidazioneValidazione mantenuta dall’utente.

Ricerca

Trova concorsi, talenti e progetti da una richiesta naturale.

Pilotaggio

Segui l’attività senza percorrere tutti i menu.

Preparazione

Crea e migliora più rapidamente senza partire da una pagina vuota.

Personalizzazione

Adatta l’esperienza da una semplice richiesta.

Progressione

Aiuta i partecipanti a sviluppare competenze.

Controllo

Mantieni la validazione finale in Dexyd.

Endpoint

Chiamare Dexyd MCP

Il server MCP Dexyd parla JSON-RPC su HTTP POST. Accetta initialize, tools/list e 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": {}
  }'

Strumenti

Strumenti MCP disponibili

Ogni strumento ha uno schema di input pubblicato da tools/list. Gli strumenti di scrittura non modificano Dexyd direttamente.

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"
    }
  }
}

Controllo

Bozze confermabili

Gli strumenti di preparazione restituiscono confirmation_required=true con pending_action. L’utente decide poi se inviare 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.

Errori

Codici MCP e HTTP

Gli errori JSON-RPC restano nella risposta MCP; gli errori di accesso usano stati HTTP abituali.

-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.