# Flickr MCP

> Flickr allows you to search millions of community photos and extract deep metadata about any image. Find visuals using tags, specific dates, or geographic coordinates. Get titles, descriptions, and user details for public photosets and individual pictures.

## Overview
- **Category:** image-video
- **Price:** Free
- **Tags:** photography, image-search, metadata, albums, flickr-api

## Description

Need to dig through massive photo libraries but don't want the manual clicking? This MCP connects your agent directly to one of the largest global photo databases. You can search for images using simple tags or even by precise location coordinates. Want to know who posted it, or what camera was used? Fetch detailed metadata and user profiles in a single query. When you connect this MCP through Vinkius, your AI client treats the Flickr API like just another set of data sources available at your fingertips, letting your agent handle all the heavy lifting.

## Tools

### get_person_info
Pulls basic profile details like locations and stats for a Flickr user.

### get_photo_info
Retrieves the full metadata package—title, description, technical specs—for a single photo ID.

### list_photosets
Lists all public albums associated with a specific user account.

### search_photos
Searches the entire Flickr library using keywords, tags, or defined date ranges.

### test_echo
Reflects back all parameters you pass to it; use this for testing connectivity.

## Prompt Examples

**Prompt:** 
```
Search for photos of 'mountains' with the tag 'landscape'.
```

**Response:** 
```
I've searched Flickr for 'mountains' with the tag 'landscape'. I found several high-quality images. Would you like the details for any specific photo ID?
```

**Prompt:** 
```
Get the metadata and description for photo ID 534211092.
```

**Response:** 
```
Fetching info for photo 534211092... This photo is titled 'Golden Gate at Sunset' by user 'sf_photog'. It was taken with a Sony A7III and has 1,200 views.
```

**Prompt:** 
```
List all albums for the user with ID 12345678@N01.
```

**Response:** 
```
I found 3 public albums for this user: 'Summer Vacation 2023', 'Street Photography', and 'Macro Shots'. Which one would you like to explore?
```

## Capabilities

### Search by content or location
Find photos across the entire platform using keywords, tags, or specific geographic bounding boxes.

### Extract photo details
Retrieve full metadata for any public image, including its title, description, and technical camera specs.

### Map user collections
List all the publicly shared albums belonging to a specific Flickr user account.

### Gather user data
Pull profile information, location history, and general statistics for any known Flickr user.

## Use Cases

### Curating a historical gallery
A researcher needs photos from New Orleans between 1920 and 1930. They ask their agent to run `search_photos` using the date range filter and location bounding boxes, gathering hundreds of visual references instantly.

### Competitive content analysis
A marketing team wants to see what photos competitors are posting. They use `list_photosets` on a known user ID to find all public albums, then run `get_photo_info` on the top images to pull metadata and understand their visual narrative.

### Building a location data tool
A developer needs to verify if photos exist at a precise spot. They use `search_photos` with latitude/longitude coordinates to check for relevant content, then pass the resulting IDs into `get_photo_info`.

### User profiling for inspiration
A creative director needs mood boards from a niche user. They first run `get_person_info` to verify the user exists, and then use `list_photosets` to get all their collection titles.

## Benefits

- Stop guessing what images exist. Use `search_photos` to find visuals using specific tags, text searches, or precise geographic coordinates.
- Don't waste time copying data fields. With `get_photo_info`, you get the full technical metadata—titles, descriptions, and camera models—for any public photo ID.
- Need to know what a user posted? You can use `list_photosets` to pull all their publicly shared albums in one go.
- Build profiles on people. Use `get_person_info` to gather basic statistics and location data about the Flickr user who posted content.
- Test connectivity instantly. If you're building something complex, run a simple check with `test_echo` before deploying your final query.

## How It Works

The bottom line is you stop building custom API connectors for image services; your agent just knows how to use this one.

1. Subscribe to this MCP and input your personal Flickr API key into the Vinkius catalog.
2. Your AI client sends a query (like 'find all photos from NYC last month') to the connected service.
3. The MCP executes the request, processes the data, and passes back structured results detailing the photos or user info.

## Frequently Asked Questions

**How does `search_photos` work with locations?**
`search_photos` allows you to filter results using bounding boxes (latitude and longitude). This lets your agent find visual content from a precise physical area, not just based on keywords.

**What can I get using `list_photosets`?**
`list_photosets` returns all the public albums belonging to a specific user. This lets you map out the complete scope of content that individual has curated for public viewing.

**Do I need `get_photo_info` every time?**
You only need `get_photo_info` when you've found a photo ID and require its deep technical metadata. A simple search might just give you the basics.

**`test_echo` is for what?**
`test_echo` is purely for testing your setup. It reflects back all parameters you pass to it, confirming that your MCP connection and API keys are working correctly before running a real query.

**What do I need to set up before using `get_person_info`?**
You must provide a valid Flickr API Key. This key authenticates your connection and ensures that your agent has the necessary permissions to retrieve user-specific data from the platform.

**If I run complex searches with `search_photos`, how are rate limits handled?**
Flickr enforces usage quotas on API calls. Your AI client manages standard throttling, but if you exceed your key's allotted limit, the request will fail until the quota resets or you adjust your permissions.

**What specific technical details does `get_photo_info` retrieve?**
It pulls detailed metadata beyond titles and descriptions. This includes camera models, lens information, GPS coordinates (if provided), and the exact date/time the photo was taken.

**Is there a way to get user profile details using `list_photosets`?**
No, `list_photosets` only returns public album IDs and names. To gather detailed statistics or location data about the owner of those albums, you need to use the dedicated `get_person_info` tool.

**Can I search for photos within a specific geographic area?**
Yes. Use the `search_photos` tool with the `lat` and `lon` parameters for radial queries, or the `bbox` parameter to define a specific rectangular bounding box.

**How do I get the username and location of a Flickr member?**
You can use the `get_person_info` tool by providing the user's NSID (user_id). It will return their profile details, including username, real name, and location if public.

**Is there a way to verify my API key is working correctly?**
Yes, you can use the `test_echo` tool. It simply echoes back any parameters you send, allowing you to confirm that the connection to the Flickr API is active.