# RandomDuck MCP for AI Agents AI Agent Connect > RandomDuck lets your AI agent pull random duck images, GIFs, and specific visual representations for HTTP status codes. It is a simple way to add some personality to your workspace or turn a boring debugging session into something a bit more entertaining. Whether you need a 404 duck to show a teammate or just a random quack to clear your head, this Connector handles it. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_2Gq4CCCVprEpypk2Z0SWmUKcDiXKeqRi3XyBnb91/ai-agent-connect - **Tags:** random-images, http-status, ducks, fun, visuals ## Description Working in web development can get dry. You are staring at logs, debugging status codes, and trying to keep the momentum going. This Connector changes that by giving your AI agent a sense of humor. It connects your workflow to a library of avian joy, allowing the agent to pull up visual content on demand. Instead of just seeing a 404 Not Found error in a terminal, your agent can show you a duck that looks just as lost as the missing page. It is about making the developer experience feel less like a grind and more like a shared hobby. You can use it to spice up team standups, add some visual flair to your project docs, or just grab a quick pick-me-up when a deployment goes sideways. Because Vinkius makes it so easy to manage these connections, you can plug this in and start getting results immediately without worrying about complex configurations. It is a small addition that makes a big difference in how you interact with your agent during the workday. It is not about replacing your tools, but about making the time you spend using them a lot more enjoyable. Whether you are troubleshooting a broken API or just need a quick distraction, having a reliable source of duck content at your fingertips keeps the vibe light. ## Tools ### get_random_img_url Get a direct link to a random duck image without extra fluff. This is perfect for sharing links in chat apps. ### get_http_duck Get a duck image that specifically represents an HTTP status code like 404 or 200. This is great for explaining errors to others. ### list_ducks View every duck filename currently available in the library. Use this to see the full range of options. ### get_quack Grab a random duck image or GIF quickly to lighten the mood. It is the fastest way to get a visual pick-me-up. ### get_random_duck Fetch a random duck image or GIF to show your AI client. Use this when you just want to see something funny. ### get_specific_duck Request a specific duck by its unique number and file type. This lets you find exactly the right duck for your needs. ### upload_duck Submit your own duck images to the collection for community review. Share your own duck creations with the rest of the community. ## Prompt Examples **Prompt:** ``` Show me a duck for a 404 error. ``` **Response:** ``` I've found the 404 duck! You can view it here: **https://random-d.uk/api/http/404.jpg**. It looks a bit lost, just like a 404 error. 🦆 ``` **Prompt:** ``` Give me a random duck to make me laugh. ``` **Response:** ``` Quack! Here is a random duck for you: **https://random-d.uk/api/32.jpg**. Hope it makes your day better! ✨ ``` **Prompt:** ``` What ducks do you have available? ``` **Response:** ``` I can pull up the full list for you. There are over **200 JPGs** and **50 GIFs** available, including special ones for codes like **200, 403, and 500**. Would you like to see a specific one? ``` ## Capabilities ### Fetch random duck images Get a random duck image or GIF to lighten the mood instantly. ### Show HTTP status ducks Visualize web errors with ducks that represent specific status codes. ### Retrieve specific ducks Get a specific duck image by its unique number and file type. ### Browse duck library See a full list of all available duck filenames in the collection. ### Upload new ducks Submit your own duck images for review by the community. ### Get direct image URLs Get a direct link to a random duck image for easy sharing. ## Use Cases ### Explaining errors to clients A developer wants to explain a 403 error to a non-technical client. They ask the agent to show the duck for that specific code to make the conversation less tense. ### Breaking the ice in Slack A team lead notices the chat is getting too serious during a long sprint. They ask the agent to drop a random duck to liven up the mood. ### Finding specific assets A content creator needs a specific duck from the library to include in a project guide. They use the agent to browse the list and pull the right one. ### Adding personality to AI An AI enthusiast wants their agent to feel less like a bot. They ask the agent to show a random quack whenever they start a new task. ## Benefits - Make debugging less dry by using get_http_duck to visualize errors with a bit of humor. - Boost team morale during standups by asking your agent to get_quack to break the ice. - Access a huge library of unique visuals using list_ducks to find the right vibe for your project. - Get direct links with get_random_img_url for easy sharing in Slack or Discord channels. - Contribute to the community by using upload_duck to share your own duck creations with others. ## How It Works The bottom line is that it turns dry web dev concepts into fun visual content instantly. 1. Connect this Connector to your AI client using the public token. 2. Ask your agent to find a duck, an HTTP status visual, or a specific image. 3. Get a direct link to the duck image or GIF immediately. ## Frequently Asked Questions **Can I use the RandomDuck MCP to make my AI agent more fun?** Yes, it adds a lot of personality. Your agent can pull up funny duck images and GIFs to break up long technical conversations. **Does RandomDuck work with Claude or Cursor?** It works with any MCP-compatible client, including Claude, Cursor, Windsurf, and VS Code. **How do I get a duck for a specific error code?** Just ask your agent to show the duck for a specific code, like a 404 or 500. It will provide a direct link to the corresponding visual. **Is there a cost to using RandomDuck?** No, there is no cost for public access. You just need to use 'public' as your token when connecting. **Can I add my own ducks to the collection?** Yes, you can submit your own duck images for review and potentially have them added to the public library. **What kind of ducks are in the library?** The library includes over 200 JPG images and 50 GIFs, including special ones for common web development status codes. **Can I get a duck for a specific HTTP error code?** Yes! Use the `get_http_duck` tool and provide the status code (e.g., 404 or 500). The agent will return the URL of a duck representing that specific HTTP state. **How do I see all the ducks available in the library?** You can use the `list_ducks` tool. It will return lists of all available JPG and GIF filenames, as well as the supported HTTP status codes. **Can I upload my own duck images to the server?** Absolutely. Use the `upload_duck` action with your base64 encoded image data. Your submission will be sent for review by the community moderators.