Skip to content
Scalekit Docs
Talk to an EngineerDashboard

Eden MCP connector

OAuth2.1/DCRAIMarketingMedia

Eden is an AI-powered content creation platform that discovers viral trends across 3M+ social media posts and helps creators generate content in their...

Eden MCP connector

  1. Install the SDK

    Section titled “Install the SDK”
    Terminal window
    npm install @scalekit-sdk/node

    Full SDK reference: Node.js | Python

  2. Set your credentials

    Section titled “Set your credentials”

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>

  3. Authorize and make your first call

    Section titled “Authorize and make your first call”
    quickstart.ts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    

    const scalekit = new ScalekitClient(
      process.env.SCALEKIT_ENV_URL,
      process.env.SCALEKIT_CLIENT_ID,
      process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    

    const connector = 'edenmcp'
    const identifier = 'user_123'
    

    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Eden MCP:', link)
    process.stdout.write('Press Enter after authorizing...')
    await new Promise(r => process.stdin.once('data', r))
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'edenmcp_eden_analyze_list',
      toolInput: { listId: 'YOUR_LISTID' },
    })
    console.log(result)

What you can do

Section titled “What you can do”

Connect this agent connector to let your agent:

  • Index eden wait for creator — Wait for a creator’s content index to be ready before querying
  • Media eden upload scheduling — Upload media for use in scheduled posts using a pre-signed URL
  • Update eden — Update an existing AI skill’s name, description, or definition by skill ID
  • Board eden trash, eden save posts to, eden save links to — Move a board to trash
  • Carousels eden study top — Study the top-performing carousels for inspiration and patterns
  • Comment eden set first — Set the first comment on a scheduled post (for auto-commenting after publish)

Tool list

Section titled “Tool list”

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

edenmcp_eden_analyze_creator#Analyze a creator's full-corpus best posts and content patterns.2 params

Analyze a creator's full-corpus best posts and content patterns.

NameTypeRequiredDescription
creatorIdstringrequiredThe canonical creator ID to analyze.
workspaceIdstringoptionalID of the workspace context for the analysis. Uses the default workspace if omitted.
edenmcp_eden_analyze_list#Analyze all creators in a creator list, returning content patterns and best posts across the group.2 params

Analyze all creators in a creator list, returning content patterns and best posts across the group.

NameTypeRequiredDescription
listIdstringrequiredThe unique identifier of the creator list to analyze.
workspaceIdstringoptionalID of the workspace context for the analysis. Uses the default workspace if omitted.
edenmcp_eden_append_to_note#Append content to the end of an existing note.2 params

Append content to the end of an existing note.

NameTypeRequiredDescription
contentstringrequiredThe markdown content to append to the end of the note.
noteIdstringrequiredThe ID of the note to append content to.
edenmcp_eden_cancel_scheduled_post#Cancel a scheduled post (moves back to draft).1 param

Cancel a scheduled post (moves back to draft).

NameTypeRequiredDescription
postIdstringrequiredThe unique identifier of the scheduled post to cancel.
edenmcp_eden_create_board#Create a new board in a workspace.2 params

Create a new board in a workspace.

NameTypeRequiredDescription
namestringrequiredThe name to assign to the new board.
workspaceIdstringrequiredThe ID of the workspace in which to create the board.
edenmcp_eden_create_note#Create a new note in a workspace or board.4 params

Create a new note in a workspace or board.

NameTypeRequiredDescription
titlestringrequiredThe title of the new note.
boardIdstringoptionalThe ID of the board in which to create the note. Either workspaceId or boardId must be provided.
contentstringoptionalThe initial markdown content of the note.
workspaceIdstringoptionalThe ID of the workspace in which to create the note. Either workspaceId or boardId must be provided.
edenmcp_eden_create_scheduling_draft#Create a draft post in the scheduling queue.5 params

Create a draft post in the scheduling queue.

NameTypeRequiredDescription
contentstringrequiredThe text content of the draft post.
mediaIdsarrayoptionalList of media IDs to attach to the draft post, obtained from the upload flow.
platformstringoptionalThe target social platform for the draft (e.g. twitter, linkedin, instagram).
scheduleIdstringoptionalThe schedule to associate the draft with.
workspaceIdstringoptionalThe workspace ID to create the draft in. If omitted, uses the default workspace.
edenmcp_eden_create_skill#Create a new AI skill (reusable prompt workflow) in the workspace.4 params

Create a new AI skill (reusable prompt workflow) in the workspace.

NameTypeRequiredDescription
namestringrequiredThe display name of the new skill.
definitionstringoptionalThe skill definition as a JSON string describing its steps and configuration.
descriptionstringoptionalA brief description of what the skill does.
workspaceIdstringoptionalThe workspace ID to create the skill in. Uses the default workspace if omitted.
edenmcp_eden_delete_skill#Permanently delete an AI skill by its ID. This action cannot be undone.1 param

Permanently delete an AI skill by its ID. This action cannot be undone.

NameTypeRequiredDescription
skillIdstringrequiredThe unique identifier of the skill to permanently delete.
edenmcp_eden_export_skill#Export a skill definition as a JSON string, suitable for backup or importing into another workspace.1 param

Export a skill definition as a JSON string, suitable for backup or importing into another workspace.

NameTypeRequiredDescription
skillIdstringrequiredThe unique identifier of the skill to export.
edenmcp_eden_find_creator_in_workspace#Find saved posts and content by a specific creator in an Eden workspace, identified by their handle.2 params

Find saved posts and content by a specific creator in an Eden workspace, identified by their handle.

NameTypeRequiredDescription
creatorHandlestringrequiredThe handle or username of the creator whose content you want to find.
workspaceIdstringrequiredThe unique identifier of the workspace to search within.
edenmcp_eden_following_overview#Get an overview of creators the user follows, optionally filtered by platform.2 params

Get an overview of creators the user follows, optionally filtered by platform.

NameTypeRequiredDescription
platformstringoptionalFilter the following overview to a specific platform. Valid values: twitter, youtube, tiktok, linkedin.
workspaceIdstringoptionalID of the workspace context. Uses the default workspace if omitted.
edenmcp_eden_generate_image#Generate an AI image for use in posts.5 params

Generate an AI image for use in posts.

NameTypeRequiredDescription
promptstringrequiredThe text prompt describing the image to generate.
heightintegeroptionalThe height of the generated image in pixels.
stylestringoptionalThe visual style to apply to the generated image.
widthintegeroptionalThe width of the generated image in pixels.
workspaceIdstringoptionalThe workspace ID to use for image generation.
edenmcp_eden_get_generated_image#Get the result or status of a previously generated image.1 param

Get the result or status of a previously generated image.

NameTypeRequiredDescription
imageIdstringrequiredThe unique identifier of the previously generated image.
edenmcp_eden_get_my_voice#Get the authenticated user's own voice profile.1 param

Get the authenticated user's own voice profile.

NameTypeRequiredDescription
workspaceIdstringoptionalThe workspace ID to retrieve the voice profile from.
edenmcp_eden_get_note_markdown#Retrieve a note's full content formatted as markdown. Use this to read the body of a saved note by its ID.1 param

Retrieve a note's full content formatted as markdown. Use this to read the body of a saved note by its ID.

NameTypeRequiredDescription
noteIdstringrequiredThe unique identifier of the note to retrieve.
edenmcp_eden_get_prompt#Get a single saved prompt by its ID, returning its full content and metadata.1 param

Get a single saved prompt by its ID, returning its full content and metadata.

NameTypeRequiredDescription
promptIdstringrequiredThe unique identifier of the prompt to retrieve.
edenmcp_eden_get_skill#Get a single AI skill by its ID, returning its full definition and metadata.1 param

Get a single AI skill by its ID, returning its full definition and metadata.

NameTypeRequiredDescription
skillIdstringrequiredThe unique identifier of the skill to retrieve.
edenmcp_eden_get_voice#Get a specific voice profile by ID.1 param

Get a specific voice profile by ID.

NameTypeRequiredDescription
voiceIdstringrequiredThe unique identifier of the voice profile to retrieve.
edenmcp_eden_import_skill#Import a skill into the workspace from a JSON definition string, typically obtained via the Export Skill tool.2 params

Import a skill into the workspace from a JSON definition string, typically obtained via the Export Skill tool.

NameTypeRequiredDescription
skillJsonstringrequiredThe JSON string of the skill definition to import, as returned by the Export Skill tool.
workspaceIdstringoptionalThe workspace ID to import the skill into. Uses the default workspace if omitted.
edenmcp_eden_list_brief_definitions#List brief template definitions.1 param

List brief template definitions.

NameTypeRequiredDescription
workspaceIdstringoptionalThe workspace ID to filter brief definitions by. If omitted, uses the default workspace.
edenmcp_eden_list_briefs#List content briefs in a workspace.3 params

List content briefs in a workspace.

NameTypeRequiredDescription
cursorstringoptionalPagination cursor returned from a previous list response.
limitintegeroptionalMaximum number of briefs to return per page.
workspaceIdstringoptionalThe ID of the workspace whose briefs to list.
edenmcp_eden_list_captures#List saved captures (bookmarks/swipes) in a workspace.3 params

List saved captures (bookmarks/swipes) in a workspace.

NameTypeRequiredDescription
cursorstringoptionalPagination cursor from a previous response to fetch the next page of results.
limitintegeroptionalMaximum number of captures to return per page.
workspaceIdstringoptionalID of the workspace to list captures from. Uses the default workspace if omitted.
edenmcp_eden_list_chats#List chat conversations in Eden, optionally filtered to a specific workspace. Supports pagination.3 params

List chat conversations in Eden, optionally filtered to a specific workspace. Supports pagination.

NameTypeRequiredDescription
cursorstringoptionalPagination cursor from a previous response to fetch the next page of results.
limitintegeroptionalMaximum number of chat conversations to return per page.
workspaceIdstringoptionalThe unique identifier of the workspace to filter chats by. If omitted, returns chats across all workspaces.
edenmcp_eden_list_creator_lists#List creator lists (curated groups of creators) in a workspace.1 param

List creator lists (curated groups of creators) in a workspace.

NameTypeRequiredDescription
workspaceIdstringrequiredID of the workspace to list creator lists from.
edenmcp_eden_list_highlights#List saved highlights in Eden, optionally scoped to a specific workspace. Supports pagination.3 params

List saved highlights in Eden, optionally scoped to a specific workspace. Supports pagination.

NameTypeRequiredDescription
cursorstringoptionalPagination cursor from a previous response to fetch the next page of results.
limitintegeroptionalMaximum number of highlights to return per page.
workspaceIdstringoptionalThe unique identifier of the workspace to filter highlights by. If omitted, returns highlights across all workspaces.
edenmcp_eden_list_prompts#List saved prompts in the workspace, with optional pagination support.3 params

List saved prompts in the workspace, with optional pagination support.

NameTypeRequiredDescription
cursorstringoptionalPagination cursor from a previous response to fetch the next page of prompts.
limitintegeroptionalMaximum number of prompts to return per page.
workspaceIdstringoptionalThe workspace ID to list prompts from. Uses the default workspace if omitted.
edenmcp_eden_list_scheduled_posts#List scheduled posts, optionally filtered by schedule or date range.6 params

List scheduled posts, optionally filtered by schedule or date range.

NameTypeRequiredDescription
cursorstringoptionalPagination cursor from the previous response to fetch the next page of results.
fromstringoptionalStart of the date range filter in ISO 8601 date format (e.g. 2024-01-01).
limitintegeroptionalMaximum number of scheduled posts to return per page.
scheduleIdstringoptionalFilter posts by a specific schedule ID.
tostringoptionalEnd of the date range filter in ISO 8601 date format (e.g. 2024-01-31).
workspaceIdstringoptionalThe workspace ID to list scheduled posts for. If omitted, uses the default workspace.
edenmcp_eden_list_schedules#List publishing schedules for a workspace.1 param

List publishing schedules for a workspace.

NameTypeRequiredDescription
workspaceIdstringoptionalThe workspace ID to list schedules for. If omitted, uses the default workspace.
edenmcp_eden_list_skills#List AI skills (reusable prompt workflows) available in the workspace.1 param

List AI skills (reusable prompt workflows) available in the workspace.

NameTypeRequiredDescription
workspaceIdstringoptionalThe workspace ID to list skills from. Uses the default workspace if omitted.
edenmcp_eden_list_voices#List available voice profiles for AI content generation.1 param

List available voice profiles for AI content generation.

NameTypeRequiredDescription
workspaceIdstringoptionalThe workspace ID to list voice profiles for.
edenmcp_eden_list_workspace_items#List items in an Eden workspace as a paginated flat list. Use cursor from a previous response to fetch the next page.3 params

List items in an Eden workspace as a paginated flat list. Use cursor from a previous response to fetch the next page.

NameTypeRequiredDescription
workspaceIdstringrequiredThe unique identifier of the workspace to list items from.
cursorstringoptionalPagination cursor from a previous response to fetch the next page of results.
limitintegeroptionalMaximum number of items to return per page.
edenmcp_eden_list_workspaces#List all Eden workspaces the authenticated user belongs to. Returns workspace id, name, slug, and role for each workspace.0 params

List all Eden workspaces the authenticated user belongs to. Returns workspace id, name, slug, and role for each workspace.

edenmcp_eden_prepare_scheduling_media_upload#Get a pre-signed upload URL for scheduling media.3 params

Get a pre-signed upload URL for scheduling media.

NameTypeRequiredDescription
filenamestringrequiredThe name of the file to upload, including extension.
mimeTypestringrequiredThe MIME type of the file to upload (e.g. image/jpeg, video/mp4).
workspaceIdstringoptionalThe workspace ID to associate the media upload with. If omitted, uses the default workspace.
edenmcp_eden_publish_post_now#Publish a draft post immediately.1 param

Publish a draft post immediately.

NameTypeRequiredDescription
postIdstringrequiredThe unique identifier of the draft post to publish immediately.
edenmcp_eden_read_board#Read an Eden board and its full contents, including all items organized on the board.1 param

Read an Eden board and its full contents, including all items organized on the board.

NameTypeRequiredDescription
boardIdstringrequiredThe unique identifier of the board to read.
edenmcp_eden_read_brief#Read a content brief by ID.1 param

Read a content brief by ID.

NameTypeRequiredDescription
briefIdstringrequiredThe unique identifier of the content brief to retrieve.
edenmcp_eden_read_brief_idea#Read a specific idea within a content brief.2 params

Read a specific idea within a content brief.

NameTypeRequiredDescription
briefIdstringrequiredThe unique identifier of the content brief containing the idea.
ideaIdstringrequiredThe unique identifier of the idea to retrieve.
edenmcp_eden_read_card#Read a saved URL/shared card by its ID.1 param

Read a saved URL/shared card by its ID.

NameTypeRequiredDescription
cardIdstringrequiredThe unique identifier of the saved card to read.
edenmcp_eden_read_media_card#Read the details of a saved media card in Eden, including its metadata and content.1 param

Read the details of a saved media card in Eden, including its metadata and content.

NameTypeRequiredDescription
cardIdstringrequiredThe unique identifier of the media card to read.
edenmcp_eden_read_social_post#Read a single social media post by its ID.1 param

Read a single social media post by its ID.

NameTypeRequiredDescription
postIdstringrequiredThe unique identifier of the social media post to read.
edenmcp_eden_rename_board#Rename an existing board.2 params

Rename an existing board.

NameTypeRequiredDescription
boardIdstringrequiredThe ID of the board to rename.
namestringrequiredThe new name to assign to the board.
edenmcp_eden_rename_note#Rename a note.2 params

Rename a note.

NameTypeRequiredDescription
noteIdstringrequiredThe ID of the note to rename.
titlestringrequiredThe new title to assign to the note.
edenmcp_eden_resolve_creator#Resolve an ambiguous creator handle to a canonical creator profile.2 params

Resolve an ambiguous creator handle to a canonical creator profile.

NameTypeRequiredDescription
handlestringrequiredThe creator's handle or username to resolve to a canonical profile.
platformstringoptionalPlatform to resolve the handle on. Valid values: twitter, youtube, tiktok, linkedin.
edenmcp_eden_save_posts_to_board#Save social posts to a board.2 params

Save social posts to a board.

NameTypeRequiredDescription
boardIdstringrequiredThe ID of the board to save the posts to.
postIdsarrayrequiredAn array of social post IDs to save to the board.
edenmcp_eden_schedule_post#Schedule a draft post for publication at a specific time.2 params

Schedule a draft post for publication at a specific time.

NameTypeRequiredDescription
postIdstringrequiredThe unique identifier of the draft post to schedule.
scheduledAtstringrequiredThe ISO 8601 datetime at which to publish the post (e.g. 2024-06-01T09:00:00Z).
edenmcp_eden_search_captures#Search saved captures (bookmarks/swipes) by a text query.4 params

Search saved captures (bookmarks/swipes) by a text query.

NameTypeRequiredDescription
querystringrequiredSearch query text to filter captures.
cursorstringoptionalPagination cursor from a previous response to fetch the next page of results.
limitintegeroptionalMaximum number of captures to return per page.
workspaceIdstringoptionalID of the workspace to search captures in. Uses the default workspace if omitted.
edenmcp_eden_search_highlights#Search saved highlights in Eden by a query string, optionally scoped to a specific workspace. Supports pagination.4 params

Search saved highlights in Eden by a query string, optionally scoped to a specific workspace. Supports pagination.

NameTypeRequiredDescription
querystringrequiredSearch query string to match against saved highlights.
cursorstringoptionalPagination cursor from a previous response to fetch the next page of results.
limitintegeroptionalMaximum number of highlights to return per page.
workspaceIdstringoptionalThe unique identifier of the workspace to search highlights within. If omitted, searches across all workspaces.
edenmcp_eden_search_social_content#Search social posts across one of four scopes: a single creator, a curated list, every creator the user follows, or the entire indexed corpus. Optional free-text query enables semantic search; omitting it returns top posts in the chosen scope ranked by outlier score. Supports platform filters, follower-count tiers, and outlier-score thresholds. scope.kind values: - 'creator': requires scope.creatorRef.platform and scope.creatorRef.username - 'list': requires scope.listRef.listId - 'following': no extra fields needed - 'global': no extra fields needed9 params

Search social posts across one of four scopes: a single creator, a curated list, every creator the user follows, or the entire indexed corpus. Optional free-text query enables semantic search; omitting it returns top posts in the chosen scope ranked by outlier score. Supports platform filters, follower-count tiers, and outlier-score thresholds. scope.kind values: - 'creator': requires scope.creatorRef.platform and scope.creatorRef.username - 'list': requires scope.listRef.listId - 'following': no extra fields needed - 'global': no extra fields needed

NameTypeRequiredDescription
scopeobjectrequiredSearch scope object. Set kind to 'creator', 'list', 'following', or 'global'. For 'creator': include creatorRef with platform and username. For 'list': include listRef with listId.
creatorTierstringoptionalFollower-count band filter: micro (10k-100k), mid (100k-1M), macro (1M-10M), mega (10M+). Ignored on creator scope.
limitintegeroptionalMaximum number of results to return (max 25).
minOutlierScorenumberoptionalMinimum outlier multiplier vs creator baseline. 2.0 = double typical; 3.0+ = real breakouts.
orderBystringoptionalRanking method. Default is outlier (overperformers vs creator baseline).
platformstringoptionalOptional platform filter on top of the scope.
querystringoptionalFree-text search query (semantic for global/list/following scopes). Omit to get top posts ranked by outlier score.
sincestringoptionalTime window for the search. Default is lifetime.
workspaceIdstringoptionalWorkspace ID to scope the search to. Optional if EDEN_WORKSPACE_ID is configured.
edenmcp_eden_search_workspace_items#Search items in an Eden workspace by topic or title. Returns matching items with pagination support.4 params

Search items in an Eden workspace by topic or title. Returns matching items with pagination support.

NameTypeRequiredDescription
querystringrequiredSearch query string to match against item topics or titles.
workspaceIdstringrequiredThe unique identifier of the workspace to search within.
cursorstringoptionalPagination cursor from a previous response to fetch the next page of results.
limitintegeroptionalMaximum number of items to return per page.
edenmcp_eden_set_first_comment#Set the first comment on a scheduled post (for auto-commenting after publish).2 params

Set the first comment on a scheduled post (for auto-commenting after publish).

NameTypeRequiredDescription
commentstringrequiredThe text content of the first comment to auto-post after publishing.
postIdstringrequiredThe unique identifier of the scheduled post.
edenmcp_eden_study_top_carousels#Study the top-performing carousels for inspiration and patterns.3 params

Study the top-performing carousels for inspiration and patterns.

NameTypeRequiredDescription
limitintegeroptionalMaximum number of top carousels to return.
topicstringoptionalA topic or keyword to filter the top carousels by.
workspaceIdstringoptionalThe workspace ID to scope the top carousel study to.
edenmcp_eden_trash_board#Move a board to trash.1 param

Move a board to trash.

NameTypeRequiredDescription
boardIdstringrequiredThe ID of the board to move to trash.
edenmcp_eden_update_note#Update a note's content, fully replacing the existing content.2 params

Update a note's content, fully replacing the existing content.

NameTypeRequiredDescription
contentstringrequiredThe new markdown content for the note. This fully replaces any existing content.
noteIdstringrequiredThe ID of the note to update.
edenmcp_eden_update_scheduled_post#Update a scheduled post's content or scheduled time.4 params

Update a scheduled post's content or scheduled time.

NameTypeRequiredDescription
postIdstringrequiredThe unique identifier of the scheduled post to update.
contentstringoptionalThe new text content for the post.
mediaIdsarrayoptionalArray of media IDs to attach to the post.
scheduledAtstringoptionalThe new scheduled publish time in ISO 8601 format.
edenmcp_eden_update_skill#Update an existing AI skill's name, description, or definition by skill ID.4 params

Update an existing AI skill's name, description, or definition by skill ID.

NameTypeRequiredDescription
skillIdstringrequiredThe unique identifier of the skill to update.
definitionstringoptionalNew skill definition as a JSON string. Omit to leave unchanged.
descriptionstringoptionalNew description for the skill. Omit to leave unchanged.
namestringoptionalNew display name for the skill. Omit to leave unchanged.
edenmcp_eden_upload_scheduling_media#Upload media for use in scheduled posts using a pre-signed URL.3 params

Upload media for use in scheduled posts using a pre-signed URL.

NameTypeRequiredDescription
fileContentstringrequiredThe base64-encoded content of the file to upload.
mimeTypestringrequiredThe MIME type of the file being uploaded (e.g. image/jpeg, video/mp4).
uploadUrlstringrequiredThe pre-signed URL obtained from the prepare_scheduling_media_upload tool.
edenmcp_eden_wait_for_creator_index#Wait for a creator's content index to be ready before querying. Use this before calling analyze_creator or similar tools to ensure the index has been populated.1 param

Wait for a creator's content index to be ready before querying. Use this before calling analyze_creator or similar tools to ensure the index has been populated.

NameTypeRequiredDescription
creatorIdstringrequiredThe canonical creator ID whose index readiness to await.