Dexyd DevelopersAPI, webhooks, and AI assistants

Connect Oria and your AI assistants to authorized Dexyd context.

MCP lets Oria or your AI assistants understand Dexyd activity, find the right information, prepare actions, and support users without losing control over sensitive decisions.

ContextUsable Dexyd context.
ActionsBetter prepared actions.
ValidationValidation kept with the user.

Search

Find contests, talents, and projects from a natural request.

Steering

Follow activity without browsing every menu.

Preparation

Create and improve faster without starting from a blank page.

Personalization

Adapt the experience from a simple request.

Progression

Help participants build skills.

Control

Keep final validation inside Dexyd.

Endpoint

Call Dexyd MCP

The Dexyd MCP server speaks JSON-RPC over HTTP POST. It accepts initialize, tools/list and 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

Available MCP tools

Each tool has an input schema published by tools/list. Write-oriented tools do not modify Dexyd directly.

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

Confirmable drafts

Preparation tools return confirmation_required=true with a pending_action. The user then decides whether the action should be submitted to 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.
Errors

MCP and HTTP codes

JSON-RPC errors stay inside the MCP response; access errors use regular HTTP statuses.

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