# Dribbble MCP > Dribbble MCP lets your AI agent manage your entire design portfolio directly. Upload shots, create new projects, update your team info, and track jobs—all from conversation. Stop juggling tabs; keep your creative workflow inside your code editor. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** portfolio-management, creative-workflow, design-showcase, content-creation, api-integration ## Description This MCP gives you direct control over your Dribbble account. You can talk to your agent about your work, and it handles the heavy lifting of asset management. Need to list all your shots or see what data is in your profile? Just ask. It also lets you group related pieces into projects, keeping everything categorized without logging into a separate dashboard. If you're working with team assets, you can manage job listings and attachments too. Vinkius hosts this connector, making it available to any MCP-compatible client so you never have to switch tools just to update your portfolio. ## Tools ### create_attachment Adds high-resolution files to an existing shot, provided you have the necessary membership level. ### create_job Initializes a new job posting on your Dribbble profile (requires a special token). ### create_project Creates a brand-new container to group related design work. ### create_shot Publishes a new visual shot to your portfolio (video shots are not supported). ### delete_attachment Removes an attached file from a shot, provided you have the necessary permissions. ### delete_project Permanently removes a project container and all associated work. ### delete_shot Removes an entire shot from your public profile. ### get_job Retrieves the details of a specific job listing on your profile (requires special token). ### get_shot Fetches all data and metadata for one specific shot by its ID. ### get_user Retrieves the core details of your authenticated user profile, including bio and team info. ### list_projects Generates a list of all existing projects associated with your account. ### list_user_shots Shows a complete list of every shot you have currently published to Dribbble. ### update_job Edits the details of an existing job listing (requires special token). ### update_project Modifies the metadata or settings of a project container. ### update_shot Changes details for an existing shot on your portfolio, provided you have upload scope. ## Prompt Examples **Prompt:** ``` Retrieve my Dribbble profile information. ``` **Response:** ``` I've accessed your profile. You are logged in as 'CreativeMind' (ID: 987654). Your bio states 'UI/UX Designer based in London' and you are currently associated with the 'DesignStudio' team. ``` **Prompt:** ``` List the shots I have currently published. ``` **Response:** ``` I found 3 shots on your profile: 'Mobile App Dashboard', 'Logo Exploration', and 'Dark Mode UI'. Would you like to see the details for any of these? ``` **Prompt:** ``` Create a new project called 'Brand Identity 2024'. ``` **Response:** ``` Project 'Brand Identity 2024' has been successfully created. You can now start adding shots to this project to organize your branding work. ``` ## Capabilities ### Manage Portfolio Assets List, retrieve, create, update, or delete individual shots from your profile. ### Organize Workspaces Build and maintain structured collections of work by creating, listing, or updating projects. ### Update User Details Access your core account data, including bio information and team memberships. ### Handle Attachments Add or remove high-resolution files to shots (requires Pro/Team access). ### Track Design Jobs Create, view, and modify job listings associated with your profile. ## Use Cases ### Client needs a status report on all current designs. Instead of asking a team member for screenshots, your agent runs list_user_shots() and pulls every relevant asset ID. It then uses get_shot() to retrieve the metadata needed for a complete client presentation. ### A project needs a formal organizational umbrella. You tell your agent, 'Create a new project called Q3 Branding.' The agent executes create_project(). You can then use update_project() to set the correct team owners immediately after. ### Marketing needs old assets for a campaign. The marketer asks their agent to find all shots by 'UI/UX' that have attachments. The agent runs list_user_shots(), filters the results, and then uses get_shot() to confirm the necessary file data. ### A job listing needs an update before a meeting. You tell your agent, 'Update the salary range on the Senior Designer role.' The agent handles the communication by calling update_job(), making sure the details are current without manual intervention. ## Benefits - Never manually update a profile again. Use the agent to call get_user() so you can instantly pull your bio or team associations into a report without leaving your IDE. - Keep your assets clean by managing projects with create_project() and list_projects(). This lets you categorize work before it even hits Dribbble. - When you publish new work, use create_shot() directly from your agent. You upload the shot, then immediately call update_shot() to add a better title or tag. - Managing team jobs is simpler too. Instead of logging in and clicking through forms, use get_job() and update_job() via conversation. - Need that perfect image asset? Use create_attachment() right when you publish something; it ties the files directly to the shot data. ## How It Works The bottom line is: your AI client handles the token authentication and API calls so you just talk to it like a human conversation. 1. First, subscribe to this MCP and provide your Dribbble Personal Access Token. 2. Next, point your AI client at the connector. You can then ask it to perform any action—like listing all projects or creating a new shot. 3. The agent executes the command against Dribbble's API and reports back the status, letting you know exactly what changed. ## Frequently Asked Questions **How do I check what shots I have published using the list_user_shots tool?** You ask your agent to run list_user_shots(). It will return a complete list of every shot associated with your account, letting you know exactly how many pieces you've uploaded. **Do I need special access for create_attachment()?** Yes, creating attachments requires upload scope and typically needs Pro or Team membership. The agent will flag this requirement if the necessary permissions aren't active. **Can I manage multiple job listings with update_job()?** You can use it to modify specific job details, like changing a required skill set or salary range. You must specify which job you want to change and provide the new data. **What is the difference between create_project() and list_projects()?** create_project() makes a brand-new, empty container for related work. list_projects() just shows you all the project containers that already exist on your account. **What permissions are needed for tools like `delete_shot`?** You need an upload scope token to use deletion tools. If your access token lacks this permission, the API call fails immediately. Always verify your token's scopes before attempting any asset removal. **Can I use `create_shot` for video content?** No, the API does not support creating video shots. You must provide standard image files when calling this function. Always confirm that your source material matches Dribbble's supported file types. **If I call `update_project` with an invalid ID, how do I handle the error?** The system returns a specific error code and message stating the resource was not found. You must confirm the project identifier exists before running update commands to prevent failure. **What information does `get_user` retrieve if my profile is incomplete?** It retrieves core user identifiers, team associations, and any available bio data even if optional fields are blank. This allows your agent to start building context immediately. **Can I upload a new design to Dribbble using this tool?** Yes! Use the `create_shot` tool. You can provide an image URL or file data, along with a title and description, to publish a new shot to your profile instantly. **How do I organize my work into different collections?** You can use the `create_project` and `list_projects` tools to manage your Dribbble projects, allowing you to categorize your shots and keep your portfolio organized. **Is it possible to add high-resolution files to my shots?** Yes, if you have a Pro or Team account, you can use the `create_attachment` tool to add files (up to 10MB) to any of your existing shots.