# Tumblr MCP > Tumblr MCP Server connects your AI client directly to the Tumblr API. Use it to pull structured data about blogs and posts—list all content under a specific tag, check a blog's avatar details, or fetch complete metadata for any individual post. It’s built for content creators who need to manage social blogging and track trends without clicking through endless feeds. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** blogging, content-discovery, social-networking, multimedia, publishing, community ## Description The `Tumblr MCP Server` connects your AI client straight into the Tumblr API. It lets you pull structured data about blogs and posts—you can list all content under a specific tag, check an account's avatar details, or fetch complete metadata for any individual post. You use this when you need to manage social blogging activity and track trends without clicking through endless feeds. ### Reading Up on Accounts and Profiles If you wanna know the general scoop on a blog, start with `get_blog_info`. This tool pulls comprehensive information about an entire Tumblr account. It gives you much more than just a name; it provides detailed metadata that paints a full picture of the profile itself. You can use this to get background context on any specified blog. When all you need is the visual identity, `get_blog_avatar` handles that. Just give it the blog's hostname and it'll grab the avatar URL for you. It’s quick work; you don't gotta dig around just to find a profile picture link. ### Content Discovery: Searching and Listing Posts You can pull lists of posts in two main ways: by source or by subject. If you know exactly which blog you wanna check out, `list_blog_posts` lets you pull multiple published posts from that specific account. It’s smart because it lets you filter those results by content type—whether it's photos, text blocks, quotes, or something else. This keeps your data clean and targeted. If you don't know the source but you know what you want to find, use `list_tagged_posts`. You just drop in a tag name, and this tool searches across the whole platform for every post that matches that keyword. It’s how you track down trends or see what everyone else is posting about right now. ### Deep Dive into Specific Content Sometimes you need more than just a list; you gotta get the full story on one piece of content. `get_post` fetches all available data for a single, specific post ID. This is perfect when you're doing detailed analysis—you can pull exact content details or check engagement metrics attached to that one item. So, whether you’re pulling general account metadata with `get_blog_info`, grabbing the avatar link with `get_blog_avatar`, listing filtered posts from a single source using `list_blog_posts`, searching for trends across Tumblr with `list_tagged_posts`, or digging into every detail of one item with `get_post`, you've got what you need to manage and analyze your microblogging data directly through your agent. You never gotta leave the terminal. ## Tools ### get_blog_avatar Retrieves the avatar URL for a specified Tumblr blog. ### get_blog_info Gets detailed information about an entire Tumblr blog account. ### get_post Fetches all details for a single, specific post ID. ### list_blog_posts Lists multiple published posts from one specified blog, allowing filters by content type. ### list_tagged_posts Searches and lists posts across the platform based on a provided tag name. ## 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 ### Retrieve Blog Details Gets general metadata, including the avatar URL, for any specified Tumblr blog. ### Search by Tag Lists and searches for all posts across Tumblr that match a given tag name. ### List Blog Posts Pulls a list of published posts from one specific blog, letting you filter the results by content type (photo, text, etc.). ### Fetch Specific Post Data Grabs all available data for a single post ID, perfect for detailed analysis. ### Get Blog Information Retrieves comprehensive information about a specific Tumblr blog account. ## Use Cases ### Finding inspiration for a new campaign A marketer needs to see what kind of illustrations are hot right now. Instead of manually clicking through feeds, they ask their agent to run `list_tagged_posts` with the tag 'illustration'. The agent returns a list of 20 recent examples, giving them immediate source material. ### Building a competitive analysis report A strategist wants to compare three competitors' latest activity. They use `list_blog_posts` on each competitor’s blog name in one prompt. The agent returns structured lists of the last 15 posts, making side-by-side comparison simple. ### Validating a client link A writer is about to publish an article referencing 'officialtumblr.' Instead of going to Tumblr and checking, they ask their agent to run `get_blog_info` first. The agent confirms the blog's official status and follower count immediately. ### Curating a themed content roundup A community manager is building a roundup of top tech blogs. They ask their agent to run `get_blog_avatar` on 10 different names. The agent confirms the profile picture and basic info for every single blog in one batch, saving hours of manual verification. ## Benefits - Stop manually checking blog feeds. You can run `list_tagged_posts` to instantly pull all content matching a tag, letting you see what’s trending across Tumblr without searching. - No more guessing if an account is real. Use `get_blog_info` to get the full metadata for any blog and confirm its status before citing it in a report. - Need to analyze post performance? Run `get_post` on specific IDs. You get all the raw data—engagement counts, content type, etc.—in one go. - Pulling a curated list of posts is fast. `list_blog_posts` lets you grab multiple entries from a known blog while filtering by whether they are photos, quotes, or text. - When you need to confirm branding details before publication, just use `get_blog_avatar`. It pulls the exact URL for any blog's profile picture. ## How It Works The bottom line is: it lets your AI client talk to Tumblr's backend like it’s a local database query—no messy browser clicking required. 1. Subscribe to the server and enter your Tumblr API Consumer Key (you find this in your developer apps). 2. Tell your AI client what you need. For example: 'List all photo posts from the blog X' or 'What's trending with #illustration?' 3. The agent runs the necessary tool (`list_blog_posts`, `list_tagged_posts`, etc.) and gives you a clean, actionable list of data. ## Frequently Asked Questions **How do I find all posts about 'tech' using the Tumblr MCP Server?** You use `list_tagged_posts`. Just tell your agent to run that tool for the tag '#tech'. It will pull all available content matching that specific hashtag across the platform. **Can I check a blog's profile picture with get_blog_avatar?** Yep. `get_blog_avatar` takes the blog name and returns the direct URL for their avatar. You don't have to navigate there just to grab the image link. **Which tool do I use if I only want to list posts from one specific blog?** You need `list_blog_posts`. It requires you to name the blog and optionally filter by content type (like 'photo' or 'text') so you get exactly what you asked for. **Is there a tool to analyze engagement metrics for a post?** You use `get_post`. This tool fetches all the deep data available on a single post, including details needed for basic engagement analysis. **When I use get_blog_info, what kind of metadata can I pull about a blog?** It retrieves comprehensive details for any Tumblr blog. Beyond just the avatar URL, you get general information like the full name and follower count. This helps gauge the overall size and focus of the community. **What unique identifier does the tool need to use get_post?** You must provide a specific post ID. Using this ID pulls all content for that single entry—including full text, media links, and detailed engagement metrics—so you don't miss any context. **Do I need to worry about rate limits when running list_tagged_posts?** Yes, the server respects Tumblr’s API rate limitations. If you try searching for too many tags or run repeated searches quickly, your agent might hit a limit and pause execution. **What credentials are required before I can use list_blog_posts?** You must supply your Tumblr API Consumer Key during setup. This key authorizes the connection, allowing your AI client to run any of the available tools on behalf of the account. **Can I search for posts matching a specific tag across Tumblr?** Yes! Use the `list_tagged_posts` tool and provide your tag. Your agent will retrieve the latest posts from across the platform that use that specific tag. **How do I see the posts from a specific blog like 'officialtumblr'?** Run the `list_blog_posts` query with the blog name. You can optionally filter by type (e.g., 'photo' or 'quote') to see only the content you're interested in. **Is it possible to retrieve the avatar URL of a blog via AI?** Absolutely. Use the `get_blog_avatar` tool and provide the blog name. You can also specify an optional size to get the image URL that best fits your needs.