Dexyd DevelopersAPI, webhooks och AI-assistenter

Koppla Oria och dina AI-assistenter till auktoriserad Dexyd-kontext.

MCP låter Oria eller dina AI-assistenter förstå Dexyd-aktivitet, hitta rätt information, förbereda åtgärder och stödja användare utan att tappa kontrollen över känsliga beslut.

KontextAnvändbar Dexyd-kontext.
ÅtgärderBättre förberedda åtgärder.
ValideringValidering behålls av användaren.

Sökning

Hitta tävlingar, talanger och projekt från en naturlig fråga.

Styrning

Följ aktivitet utan att gå igenom alla menyer.

Förberedelse

Skapa och förbättra snabbare utan att börja från en tom sida.

Personalisering

Anpassa upplevelsen från en enkel fråga.

Utveckling

Hjälp deltagare att bygga kompetens.

Kontroll

Behåll slutlig validering i Dexyd.

Endpoint

Anropa Dexyd MCP

Dexyd MCP-servern använder JSON-RPC över HTTP POST och accepterar initialize, tools/list och 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": {}
  }'
Verktyg

Tillgängliga MCP-verktyg

Varje verktyg har ett input-schema från tools/list. Skrivverktyg ändrar inte Dexyd 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"
    }
  }
}
Kontroll

Bekräftningsbara utkast

Förberedelseverktyg returnerar confirmation_required=true med pending_action. Användaren avgör sedan om det ska skickas.

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

MCP- och HTTP-koder

JSON-RPC-fel stannar i MCP-svaret; åtkomstfel använder vanliga HTTP-statusar.

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