# Dog CEO MCP

> Dog CEO is an MCP that connects your AI agent to a massive collection of dog images and breed data. It lets you get random pictures, list every registered breed, or fetch specific images for breeds like Retrievers or Hounds. Perfect for developers needing visual placeholders or content creators building pet-themed sites.

## Overview
- **Category:** lifestyle
- **Price:** Free
- **Tags:** dogs, breeds, animals, images, pet-data

## Description

This connector gives your AI agent instant access to the internet’s largest open-source database of canine imagery and facts. You can ask it to pull a random dog photo, fetch images based on a specific breed name, or even get a full list of every registered breed available in the system. It's built for anyone who needs reliable visual assets or structured pet data without opening multiple tabs. The whole thing runs through your AI client, making sure you never have to leave your chat window just to find a cute pup picture. You connect this MCP via Vinkius and it instantly becomes part of your agent’s toolkit, turning complex data retrieval into simple conversation.

## Tools

### get_dog_by_breed
It retrieves an image of a dog once you specify its exact breed name.

### list_dog_breeds
It outputs the complete, organized list of all known dog breeds and sub-breeds.

### get_random_dog_image
This tool instantly generates and returns a random picture of any dog.

## Prompt Examples

**Prompt:** 
```
Show me a random dog picture.
```

**Response:** 
```
Coming right up! Here is a random dog for you. Isn't it adorable? I can also find images for specific breeds if you're interested.
```

**Prompt:** 
```
Find 3 pictures of 'Golden Retrievers'.
```

**Response:** 
```
Searching for Golden Retrievers... I've retrieved 3 high-quality images of this friendly and energetic breed. I can provide the direct image URLs for you.
```

**Prompt:** 
```
List all sub-breeds for 'Hounds'.
```

**Response:** 
```
Retrieving the list of sub-breeds for Hounds... I found several varieties including the Afghan, Basset, Blood, English, Ibizan, and Walker hounds. Would you like to see a picture of a specific one?
```

## Capabilities

### Get immediate random dog images
It pulls an instant, high-quality picture of any dog breed.

### List all available dog breeds and sub-breeds
It outputs a complete, structured list of every recognized canine type in the database.

### Fetch images for specific breeds
You provide a breed name, and it returns corresponding photos.

### Build pet-themed apps with data
It provides the foundation of structured data needed for developing pet-related applications or websites.

## Use Cases

### Building a Pet Portfolio Site
A developer needs placeholder images for 10 different dog types. Instead of searching stock photo sites, they ask their agent to run `get_random_dog_image` ten times, getting diverse visuals instantly.

### Validating Content Listings
A content manager is writing an article comparing hounds and retrievers. They first call `list_dog_breeds` to confirm the correct spelling of all sub-breeds, then use `get_dog_by_breed` for accurate images.

### Quick Prototype Design
A designer wants a quick visual mock-up showing a dog owner selecting a breed. They ask the agent to get an image using `get_random_dog_image`, getting instant, usable content for testing.

### Building a Breed Directory
A specialized data team needs all available breeds listed in one place. They simply prompt the agent to use `list_dog_breeds` and get a clean list they can copy into their database structure.

## Benefits

- Instant visual assets: Need a random placeholder image? Just use `get_random_dog_image` to pull one immediately without leaving your chat.
- Structured data prep: Instead of guessing what breeds exist, call `list_dog_breeds`. This gives you the official list needed for complex filtering or database population.
- Targeted content retrieval: If you need a specific look—like an English Hound—use `get_dog_by_breed` to pull that exact image directly into your workflow.
- Development acceleration: Stop spending time searching for placeholder assets. Use this MCP to integrate dog imagery right into your prototyping tools.
- Conversation flow: The agent handles the complexity; you just talk to it, whether you're listing breeds or pulling a single picture.

## How It Works

The bottom line is you just talk to your agent; it handles fetching and formatting the data automatically.

1. Subscribe to this MCP through Vinkius.
2. Connect your preferred AI client (Claude, Cursor, etc.) to the catalog.
3. Ask your agent for a dog picture or breed list in natural conversation.

## Frequently Asked Questions

**Can I get a photo of a specific breed like 'Husky'?**
Yes! Use the `get_dog_by_breed` tool and set the `breed` parameter to 'husky'. It will return a random image of that breed.

**How do I list all available sub-breeds for a breed like 'Retriever'?**
Use the `list_sub_breeds` tool and provide 'retriever' as the breed. It will return a list of all sub-breeds like 'golden', 'flat-coated', etc.

**Are there any copyrights on these dog images?**
The Dog CEO API sources images from various open repositories. While most are free to use, you should check the source links for specific licensing if using them for commercial purposes.

**How do I use get_random_dog_image if I don't have an API key?**
You don't need one because this MCP provides public access. You can immediately start using random dog photos across any compatible client without worrying about keys or credentials.

**Are there rate limits when I use list_dog_breeds for large projects?**
The MCP manages standard usage rates internally. You can rely on the service to handle high volumes of calls, ensuring consistent performance whether you check a few breeds or run continuous workflows.

**What data format does get_dog_by_breed provide for a specific breed?**
It returns structured output containing both the image URL and relevant metadata. This structure makes it easy for your agent to consume the asset directly into records or display them in an interface.

**Can I use get_random_dog_image with different AI clients?**
Yes, it works across all MCP-compatible clients. Just connect your preferred agent—be it Cursor or Windsurf—and the ability to fetch random dog photos is instantly available through natural conversation.

**If I use get_dog_by_breed for an invalid name, how does the MCP handle the error?**
The MCP returns a clear, descriptive error message indicating that the breed was not found. Your agent can catch this specific failure and prompt the user to try another valid breed instead of failing entirely.