MCP tools reference

Dribbble MCP tools

11 tools for Dribbble on the Cotlet MCP server. Your agent picks them from tools/list.

MCP server
https://cotlet.dev/mcp/v1
Connects with
Your own Dribbble account (a Pro account for Pro Analytics)
Integration page
Dribbble
Dribbble Endpoints
Endpoint Access Description
dribbble_list_shots read Your shots, newest first, with title, tags, publish date and URL.
dribbble_get_shot_stats read Views, likes, saves and comment count of one of your shots.
dribbble_get_pro_analytics read Pro Analytics: leads, proposals, funded projects, response time and rate, conversion and earnings.
dribbble_list_conversations read Your Messages inbox: who, last message, time and whether it is unread.
dribbble_get_conversation read All messages in a conversation, with sender, text, time and attached files.
dribbble_list_leads read Project and Service Requests you received, with client, date, type and whether you replied.
dribbble_list_comments read Comments on one of your shots, with author, text, time and whether you replied.
dribbble_upload_shot write Publish a new shot from an image, with title, description and tags.
dribbble_update_shot write Change the title, description or tags of one of your shots.
dribbble_reply_to_message write Send a message as you in an existing conversation.
dribbble_reply_to_comment write Reply as you under a comment on one of your shots.

List shots

read

MCP tool dribbble_list_shots

Returns your own shots, newest first, the same order as your profile. Each item has the title, tags, publish date and URL. Use the shot_id of an item in get_shot_stats, list_comments and update_shot. Pass next_cursor back as cursor for the next page.

Parameters

Parameters: list_shots
NameTypeDescription
limit integer 1 to 100. Default: 24.
cursor string Next page cursor from the previous call.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "dribbble_list_shots",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "shots": [
      {
        "shot_id": "21847531",
        "title": "Fintech dashboard",
        "tags": [
          "ui",
          "fintech",
          "dashboard"
        ],
        "published_at": "2026-10-08T09:30:00Z",
        "url": "https://dribbble.com/shots/21847531-Fintech-dashboard"
      },
      {
        "shot_id": "21790442",
        "title": "Onboarding flow",
        "tags": [
          "ux",
          "mobile"
        ],
        "published_at": "2026-09-30T14:10:00Z",
        "url": "https://dribbble.com/shots/21790442-Onboarding-flow"
      }
    ],
    "next_cursor": "eyJvZmZzZXQiOjI0fQ"
  },
  "isError": false
}

Get shot stats

read

MCP tool dribbble_get_shot_stats

Returns the engagement numbers Dribbble shows for one of your shots: views, likes, saves and the number of comments. It works for your own shots only. The numbers are the ones Dribbble shows at the time of the call.

Parameters

Parameters: get_shot_stats
NameTypeDescription
shot_id required string Shot ID from list_shots.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "dribbble_get_shot_stats",
    "arguments": {
      "shot_id": "shot_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "shot_id": "21847531",
    "title": "Fintech dashboard",
    "views": 4120,
    "likes": 186,
    "saves": 74,
    "comments": 12
  },
  "isError": false
}

Get Pro Analytics

read

MCP tool dribbble_get_pro_analytics

Returns the figures of your Pro Analytics dashboard for a period: leads, project proposals, funded and completed projects, average project value, response time, response rate, lead conversion rate, cancellation rate and earnings. Dribbble refreshes these once a day. Needs a Pro account.

Parameters

Parameters: get_pro_analytics
NameTypeDescription
period enum 30d, 60d, 90d or all_time. Default: 30d.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "dribbble_get_pro_analytics",
    "arguments": {
      "period": "60d"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "period": "30d",
    "leads": 14,
    "project_proposals": 6,
    "funded_projects": 3,
    "completed_projects": 2,
    "average_project_value": 2400,
    "response_time_hours": 3.5,
    "response_rate": 92.9,
    "lead_conversion_rate": 21.4,
    "cancellation_rate": 0,
    "earnings": 4800,
    "currency": "USD"
  },
  "isError": false
}

List conversations

read

MCP tool dribbble_list_conversations

Lists your Dribbble Messages conversations, most recent first, with the other person, a preview of the last message, its time and whether it is unread. Set unread_only to see only what needs an answer. Pass conversation_id to get_conversation or reply_to_message.

Parameters

Parameters: list_conversations
NameTypeDescription
unread_only boolean Only conversations with unread messages.
limit integer 1 to 50. Default: 20.
cursor string Next page cursor from the previous call.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "dribbble_list_conversations",
    "arguments": {}
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "conversations": [
      {
        "conversation_id": "8841207",
        "with": "Marta Kowal",
        "last_message": "Hi! We need a redesign of our analytics dashboard.",
        "updated_at": "2026-10-10T08:14:00Z",
        "unread": true
      }
    ],
    "next_cursor": null
  },
  "isError": false
}

Get conversation

read

MCP tool dribbble_get_conversation

Returns the messages of one conversation, oldest first, with the sender, text, time and any attached files. Your agent reads the whole thread before it drafts a reply.

Parameters

Parameters: get_conversation
NameTypeDescription
conversation_id required string Conversation ID from list_conversations.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "dribbble_get_conversation",
    "arguments": {
      "conversation_id": "conversation_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "conversation_id": "8841207",
    "with": "Marta Kowal",
    "messages": [
      {
        "from": "Marta Kowal",
        "body": "Hi! We need a redesign of our analytics dashboard.",
        "sent_at": "2026-10-10T08:14:00Z",
        "attachments": []
      }
    ]
  },
  "isError": false
}

List leads

read

MCP tool dribbble_list_leads

Lists the Project and Service Requests you received, newest first, the same requests Pro Analytics counts as Leads. Each item has the client, the date, the request type and whether you have replied. Use unanswered_only to see what still needs an answer.

Parameters

Parameters: list_leads
NameTypeDescription
since date Only leads received on or after this date.
unanswered_only boolean Skip leads you already replied to.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "dribbble_list_leads",
    "arguments": {
      "since": "2026-10-05",
      "unanswered_only": true
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "leads": [
      {
        "lead_id": "ld_30912",
        "client": "Marta Kowal",
        "type": "Project Request",
        "received_at": "2026-10-08T11:02:00Z",
        "replied": false,
        "conversation_id": "8841207"
      }
    ],
    "next_cursor": null
  },
  "isError": false
}

List comments

read

MCP tool dribbble_list_comments

Lists the comments on one of your shots, newest first, with the author, text, time and whether you replied. Set unanswered_only to skip comments you already answered. Pass comment_id to reply_to_comment.

Parameters

Parameters: list_comments
NameTypeDescription
shot_id required string Shot ID from list_shots.
unanswered_only boolean Skip comments you already replied to.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "dribbble_list_comments",
    "arguments": {
      "shot_id": "shot_8c41d2"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "shot_id": "21847531",
    "comments": [
      {
        "comment_id": "c_4471",
        "author": "Jonas Weber",
        "body": "Clean grid. What spacing scale is this?",
        "created_at": "2026-10-09T17:40:00Z",
        "replied": false
      }
    ],
    "next_cursor": null
  },
  "isError": false
}

Upload shot

write Confirm

MCP tool dribbble_upload_shot

Publishes a new shot on your profile from an image URL, with a title, an optional description and tags. Set publish_at to schedule it. The shot appears under your name and is public once published. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: upload_shot
NameTypeDescription
image_url required string PNG, JPG or GIF by URL.
title required string Shot title.
description string Text shown under the shot.
tags string[] Tags that help the shot show up in search.
publish_at datetime Schedule it, ISO 8601 with time zone.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "dribbble_upload_shot",
    "arguments": {
      "image_url": "https://example.com",
      "title": "title"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "shot_id": "21901377",
    "status": "published",
    "title": "Fintech dashboard",
    "tags": [
      "ui",
      "fintech",
      "dashboard"
    ],
    "url": "https://dribbble.com/shots/21901377-Fintech-dashboard",
    "published_at": "2026-10-11T10:00:00+02:00"
  },
  "isError": false
}

Update shot

write

MCP tool dribbble_update_shot

Changes the title, description or tags of one of your own shots. Fields you leave out stay as they are. It sends nothing to anyone and one more call restores the old text, so it runs without asking first.

Parameters

Parameters: update_shot
NameTypeDescription
shot_id required string Shot ID from list_shots.
fields required object Any of title, description, tags.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "dribbble_update_shot",
    "arguments": {
      "shot_id": "shot_8c41d2",
      "fields": "fields"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "shot_id": "21847531",
    "status": "updated",
    "title": "Fintech dashboard v2",
    "tags": [
      "ui",
      "fintech",
      "dashboard"
    ]
  },
  "isError": false
}

Reply to message

write Confirm

MCP tool dribbble_reply_to_message

Sends a message in an existing conversation, under your name. The other person sees it in their Dribbble Messages. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: reply_to_message
NameTypeDescription
conversation_id required string Conversation ID from list_conversations.
body required string Message text.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "dribbble_reply_to_message",
    "arguments": {
      "conversation_id": "8841207",
      "body": "Thanks for reaching out! I can start on the dashboard redesign next week. Could you share the current screens?"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "message_id": "55120934",
    "conversation_id": "8841207",
    "status": "sent",
    "sent_at": "2026-10-10T14:22:05+02:00"
  },
  "isError": false
}

Reply to comment

write Confirm

MCP tool dribbble_reply_to_comment

Posts a reply under one comment on your shot, under your name. The reply is public on the shot. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: reply_to_comment
NameTypeDescription
comment_id required string Comment ID from list_comments.
body required string Reply text.

tools/call

JSON-RPC 

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "dribbble_reply_to_comment",
    "arguments": {
      "comment_id": "comment_8c41d2",
      "body": "body"
    }
  }
}

Example response

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "comment_id": "c_4480",
    "reply_to": "c_4471",
    "status": "published"
  },
  "isError": false
}