# Tumblr MCP

> Tumblr MCP connects your AI agent directly to Tumblr's content infrastructure. Use it to analyze a blog’s performance, find trending topics by searching specific tags, and list post histories for any account. It lets you manage complex social monitoring tasks—from checking an avatar URL to pulling the full details on individual posts—all through natural conversation.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** blogging, content-discovery, social-networking, multimedia, publishing, community

## Description

Managing a presence on Tumblr used to mean jumping between analytics dashboards and content feeds just to gather enough data for a strategy meeting. Now, your AI agent handles that complexity. You can ask it to find out everything about a specific blog's history or pull all the latest posts matching a certain theme. Need to know what’s popular right now? Just tell your agent to search across tags; it pulls those trends immediately. The whole process is managed through natural conversation, giving you deep oversight of your microblogging activity without ever opening the official site interface. Because this MCP sits in the Vinkius catalog, you connect once and get access to these powerful blogging tools alongside hundreds of others.

## Tools

### get_blog_avatar
Retrieves only the URL needed for a blog's profile picture.

### get_blog_info
Gathers general data about any given Tumblr blog, including its name and status.

### get_post
Pulls all available metrics and details for one specific post ID.

### list_blog_posts
Generates a list of articles from a known blog, letting you filter by content type like photo or text.

### list_tagged_posts
Searches the entire platform and lists all recent posts that share a specific hashtag.

## Prompt Examples

**Prompt:** 
```
Show me the latest posts tagged with 'illustration'.
```

**Response:** 
```
I've retrieved the latest tagged posts. Here are some beautiful illustrations trending right now from creators across Tumblr. Would you like the details for any specific post?
```

**Prompt:** 
```
List all photo posts from the blog 'officialtumblr'.
```

**Response:** 
```
I've fetched the photo posts from 'officialtumblr'. You have 5 recent images including anniversary graphics and community features. Shall I retrieve the full description for the latest one?
```

**Prompt:** 
```
Get information about the blog 'staff'.
```

**Response:** 
```
Fetching blog info... The 'staff' blog is the official Tumblr internal blog. It has over 1M followers and focuses on product updates and platform news. Would you like to see their latest posts?
```

## Capabilities

### Check blog identity details
Retrieve basic information, like the name or follower count, for any Tumblr account.

### Find a blog's profile picture
Get the URL needed to display an avatar image for a specific blog.

### Search posts by topic tag
List all recent content across Tumblr that shares a particular hashtag or keyword.

### Pull content from a specific account
Generate a list of published articles from one designated blog, allowing you to filter by content type.

### Get deep details on an article
Fetch complete metrics and all available data for one single post.

## Use Cases

### Identifying new content angles
A brand manager needs to know what topics are gaining traction. They ask their agent, 'Show me the latest posts tagged with sustainable fashion.' The agent uses `list_tagged_posts` and returns a curated feed of ideas, giving them instant inspiration.

### Auditing an account's content history
A marketing team needs to review all photo blog posts from the 'official brand' account. They instruct their agent to use `list_blog_posts` and filter by 'photo', getting a clean list of everything published in that format.

### Quick competitor snapshot
A user wants to know how big a rival blog is before starting. They ask the agent for basic information, and it uses `get_blog_info` to immediately provide key stats like follower count and general metadata.

### Deep-dive post analysis
A user finds one specific post they suspect is performing well. They ask the agent to pull all data on that ID, triggering `get_post`, which returns engagement metrics, content details, and more for immediate analysis.

## Benefits

- Instantly discover what's hot by using `list_tagged_posts`. Instead of manually browsing tag feeds, your agent searches the entire platform and gives you a list of posts matching any topic.
- Conduct deep competitive audits. You can use `get_blog_info` to get key statistics on a rival blog, or use `list_blog_posts` to track their content output over time.
- Save hours analyzing individual pieces. Instead of manually clicking into every post to check its stats, you just ask your agent and it uses `get_post` to pull the complete data set for you.
- Streamline cross-platform reporting. You can quickly get a list of posts from multiple accounts using `list_blog_posts`, ensuring all your content sources are accounted for in one query.
- Build structured knowledge bases. By combining `get_blog_avatar` and `get_blog_info`, you build out a clean index of key community players for research purposes.

## How It Works

The bottom line is you talk naturally to your agent, and it uses these specific tools to pull structured Tumblr data for you.

1. Subscribe to this MCP and enter your Tumblr API Consumer Key in the Vinkius Marketplace.
2. Connect your preferred AI agent (like Cursor or Claude) to the Vinkius platform.
3. Ask your agent a question like, 'List all photo posts from the blog X,' and it handles the data retrieval.

## Frequently Asked Questions

**How do I connect the Tumblr MCP?**
You first subscribe to this MCP on Vinkius and must provide your specific Tumblr API Consumer Key. Once that key is saved, your AI agent can access all the tools.

**Can the Tumblr MCP find posts from a non-existent blog?**
No. The agent requires an active hostname or account name to query data using `get_blog_info` or `list_blog_posts`. It won't guess.

**What if I need data for a specific post? Which tool do I use?**
You must use the `get_post` tool. This requires you to provide the unique ID of the article, which gives you full access to its engagement metrics.

**Is this MCP only for photos and text posts?**
No. While you can list content types using `list_blog_posts`, the agent pulls general metadata that covers all multimedia formats, including quotes and videos.

**Can I use Tumblr MCP to find out about a competitor's account?**
Yes. You can get an initial overview of their profile using `get_blog_info` or check their recent posts with `list_blog_posts`.