MCP Blog API
Allows interaction with a mock blog API service, providing tools for fetching blogs, searching blogs by title, and adding new blog posts.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Blog API search for blogs about Python programming"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Blog API
A simple blog API service built with FastMCP and httpx. This project supports uv for fast, reliable Python package management and environment setup.
Description
This project provides a set of API tools to interact with a mock blog API service. It allows users to fetch all blogs, search for blogs by title, and add new blog posts. The project includes a uv.lock file for reproducible dependency management.
Related MCP server: MCP Blog Server
Features
Fetch all blogs from the mock API
Search for blogs by title
Add new blog posts
Requirements
Python 3.13 or higher
httpx 0.28.1 or higher
mcp 1.9.0 or higher
Installation
Using uv (Recommended)
# Clone the repository
git clone https://github.com/yourusername/mcp-blog.git
cd mcp-blog
# Install dependencies with uv
uv pip install -e .Using pip
# Clone the repository
git clone https://github.com/yourusername/mcp-blog.git
cd mcp-blog
# Install dependencies
pip install -e .Usage
# Import the MCP server
from main import mcp
# Get all blogs
blogs = mcp.tools.get_blogs()
# Search for blogs by title
search_results = mcp.tools.search_blogs(query="Python")
# Add a new blog
new_blog = mcp.tools.add_blog(title="My New Blog", body="This is the content of my new blog post.")Running the Server
Using uv (Recommended)
uv python main.pyUsing standard Python
python main.pyEnvironment Management
Using uv (Recommended)
uv provides fast environment management for Python projects. Here's how to create and manage a virtual environment for this project:
# Create a new virtual environment
uv venv
# Activate the virtual environment
# On Unix/macOS
source .venv/bin/activate
# On Windows
.venv\Scripts\activate
# Install dependencies in the virtual environment
uv pip install -e .
# Update dependencies
uv pip syncAPI Reference
get_blogs()
Fetches all blogs from the mock API.
search_blogs(query: str)
Searches for blogs by title using the mock API.
add_blog(title: str, body: str)
Adds a new blog to the mock API.
License
[Add your license information here]
Contributing
[Add contribution guidelines here]
Available Tools
3 toolsadd_blogC
Add a new blog to the mock API.
Inputs: title (required), body (required).
get_blogsB
Fetch all blogs from the mock API.
Inputs: no named parameters.
search_blogsC
Search for blogs by title using the mock API.
Inputs: query (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: add_blog creates new blogs, get_blogs retrieves all blogs, and search_blogs finds blogs by title. There is no overlap in functionality, making tool selection straightforward for an agent.
All tool names follow a consistent verb_noun pattern with snake_case: add_blog, get_blogs, and search_blogs. This predictability enhances readability and usability across the tool set.
With only 3 tools, the set feels thin for a blog API that typically requires CRUD operations. While the tools cover creation and retrieval, the absence of update and delete tools limits the server's scope, making it borderline appropriate.
The tool set is significantly incomplete for a blog API domain. It lacks update_blog and delete_blog tools, preventing full lifecycle management. This gap will likely cause agent failures when attempting to modify or remove blogs.
Maintenance
Related MCP Connectors
Blog MCP server for AI agents. One signup call returns a blog, an API key and a live URL; then your agent publishes markdown posts and gets public URLs back. Your agent does the writing; you get a dashboard for stats.
Create, edit, organize, publish, and configure JustBlogged blogs from MCP clients.
Hosted MCP for BlogBat: read, write, generate, and publish blog articles and content.
Hosted MCP for BlogBat: read, write, generate, and publish blog articles and content.
Related MCP Servers
- AlicenseAqualityFmaintenanceMCP server that gives AI agents full blog management over a Lontar headless blogging API, enabling listing, reading, drafting, publishing, updating, and deleting posts.8MIT
- FlicenseDqualityDmaintenanceMCP server for blog management that provides tools to get, search, and create blog posts via a mock API.3-
- FlicenseNot gradedqualityDmaintenanceDemonstrates a simple MCP client-server setup using fastmcp, with an advanced blog server featuring dynamic resources, tools for post creation and publishing workflows, caching, and async operations.-
- AlicenseNot gradedqualityDmaintenanceExposes a blog CRUD API (posts and comments) as MCP tools, with an integrated AI chatbot agent powered by Ollama Gemma2 for natural language interaction.7 npmISC