Dexyd DevelopersAPI, webhook, dan asisten AI

Hubungkan Oria dan asisten AI Anda ke konteks Dexyd yang diizinkan.

MCP memungkinkan Oria atau asisten AI memahami aktivitas Dexyd, menemukan informasi yang tepat, menyiapkan tindakan, dan mendampingi pengguna tanpa kehilangan kontrol atas keputusan sensitif.

KonteksKonteks Dexyd yang dapat digunakan.
TindakanTindakan disiapkan lebih baik.
ValidasiValidasi tetap pada pengguna.

Pencarian

Temukan kontes, talenta, dan proyek dari permintaan alami.

Pengarahan

Ikuti aktivitas tanpa membuka semua menu.

Persiapan

Buat dan tingkatkan lebih cepat tanpa mulai dari halaman kosong.

Personalisasi

Sesuaikan pengalaman dari permintaan sederhana.

Perkembangan

Bantu peserta meningkatkan kompetensi.

Kontrol

Pertahankan validasi akhir di Dexyd.

Endpoint

Memanggil Dexyd MCP

Server MCP Dexyd memakai JSON-RPC lewat HTTP POST. Mendukung initialize, tools/list, dan 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": {}
  }'
Tool

Tool MCP tersedia

Setiap tool memiliki skema input dari tools/list. Tool penulisan tidak mengubah Dexyd secara langsung.

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

Draf yang dapat dikonfirmasi

Tool persiapan mengembalikan confirmation_required=true dengan pending_action. Pengguna memutuskan apakah dikirim ke 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.
Error

Kode MCP dan HTTP

Error JSON-RPC tetap di respons MCP; error akses memakai status HTTP biasa.

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