Dexyd DevelopersAPI, Webhooks und KI-Assistenten

Suche

Finden Sie Wettbewerbe, Talente und Projekte über eine natürliche Anfrage.

Steuerung

Verfolgen Sie Aktivität, ohne alle Menüs zu durchlaufen.

Vorbereitung

Erstellen und verbessern Sie schneller, ohne mit einer leeren Seite zu starten.

Personalisierung

Passen Sie die Erfahrung über eine einfache Anfrage an.

Fortschritt

Helfen Sie Teilnehmenden, Kompetenzen aufzubauen.

Kontrolle

Behalten Sie die finale Validierung in Dexyd.

Endpoint

Dexyd MCP aufrufen

Der Dexyd MCP-Server spricht JSON-RPC über HTTP POST. Er akzeptiert initialize, tools/list und 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": {}
  }'
Tools

Verfügbare MCP-Tools

Jedes Tool hat ein Input-Schema aus tools/list. Schreiborientierte Tools ändern Dexyd nicht direkt.

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

Bestätigbare Entwürfe

Vorbereitungs-Tools geben confirmation_required=true mit pending_action zurück. Der Nutzer entscheidet danach über das Absenden.

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

MCP- und HTTP-Codes

JSON-RPC-Fehler bleiben in der MCP-Antwort; Zugriffsfehler nutzen normale HTTP-Status.

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