Use your workspace from code

Run a tool

curl -X POST "https://mcp.eden.so/v1/tools/eden_search_social_content" \
  -H "Authorization: Bearer <key>" -H "Content-Type: application/json" \
  -d '{"scope":"global","query":"morning routine"}'

• GET https://mcp.eden.so/v1/tools lists every tool your key can use, with the fields each one takes.
• https://mcp.eden.so/v1/openapi.json has every tool in one OpenAPI file.
• The answer is { "ok": true, ... }, or { "ok": false, "status": "...", "message": "..." } with a matching HTTP code.
• Leave out workspaceId to use your default workspace.

Schedule a post

curl -X POST "https://mcp.eden.so/v1/tools/eden_schedule_post" \
  -H "Authorization: Bearer <key>" -H "Content-Type: application/json" \
  -d '{"text":"Three things I learned this week","platforms":["linkedin"],"scheduledAtIso":"2026-10-06T15:00:00Z"}'

Scheduling needs Starter or above. eden_list_schedules shows your connected accounts and time zone. Add "draft": true to save it for review instead. To hear back when it goes out or fails, add a webhook.

Upload a file for a post

Send an image, video, or PDF in one call:

curl -X POST "https://mcp.eden.so/v1/media" \
  -H "Authorization: Bearer <key>" -F "[email protected]"

You get back an asset. Put it in eden_schedule_post's media list. Files go up to 100 MB in JPG, PNG, WebP, GIF, PDF, MP4, MOV, or WebM. Add -F "workspace_id=<id>" to pick a workspace.

Talk to a Custom AI

Send a message to one of your Custom AIs and get its answer, with its instructions, knowledge, and tools:

curl -X POST "https://mcp.eden.so/v1/tools/eden_ask_custom_ai" \
  -H "Authorization: Bearer <key>" -H "Content-Type: application/json" \
  -d '{"customAIId":"<id>","message":"Write me three hooks about focus"}'

• Get the id from eden_list_custom_ai. Leave it out to ask Eve.
• Most answers come back with "status": "answered". A long one says "running" with a chatId: call eden_get_custom_ai_answer with it a few seconds later.
• Send the same chatId again to keep the conversation going. The chat shows up in your Eden sidebar.

Credits and limits

• Research calls cost 0.1 to 0.5 AI credits, the same as through MCP. Saving, scheduling, uploads, and reading your own workspace are free.
• Each Custom AI message costs what chatting in Eden does: 1 credit, or 2 with "mode": "max".
• 120 calls a minute per key, shared with MCP. A key only sees the tools its access allows. Changes need Full access or a Custom key with that part on Edit.