Hashnode Universal MCP Server

What is Hashnode Universal MCP Server about?

The server implements a Model Context Protocol (MCP) compliant layer that abstracts Hashnode’s functionality behind a single, consistent API, enabling seamless integration with other MCP‑compatible services.

How to use Hashnode Universal MCP Server?

1. Prerequisites – Install Python 3.11+ and the uv package manager.
2. Setup – Run uv sync to install dependencies, then activate the virtual environment (source .venv/bin/activate on Unix or .venv\Scripts\Activate on Windows).
3. Start the inspector – Execute mcp dev src/universal_mcp_hashnode/server.py and note the displayed address/port.
4. Install the application – Run mcp install src/universal_mcp_hashnode/server.py.
5. Access – The service can now be called via the MCP endpoint or through the UI at https://agentr.dev/apps after enabling Hashnode.

Key Features

• Full compliance with the MCP specification for compatibility with other MCP services.
• Python‑first implementation using the uv dependency manager for fast, reproducible environments.
• Ready‑to‑use tools list documented in src/universal_mcp_hashnode/README.md.
• Simple local development workflow with mcp dev and mcp install commands.
• MIT licensed, allowing unrestricted reuse and modification.

Use Cases

• Build AI agents that need to create, fetch, or update Hashnode posts and comments.
• Integrate Hashnode data into knowledge‑bases or analytics pipelines without handling direct API calls.
• Enable rapid prototyping of social‑media‑aware applications within the MCP ecosystem.
• Centralize authentication and rate‑limit handling for multiple Hashnode‑related tools.

FAQ

Q: Do I need an API key? A: Yes. Set your Hashnode API token in the .env file (e.g., HASHNODE_API_KEY). The server reads it at runtime.

Q: Can I deploy this to production? A: Absolutely. After local testing, containerize the service or run it directly with a process manager; ensure the environment variables are securely provided.

Q: Is there a Docker image available? A: Not provided in the repo, but you can build one using a standard Python base image and the same uv sync steps.

Q: How does this differ from calling Hashnode’s REST API directly? A: The MCP layer normalizes request/response formats and makes the service interchangeable with other MCP‑compatible tools, simplifying multi‑service orchestration.

Q: Where can I find the list of supported tools? A: In src/universal_mcp_hashnode/README.md within the repository.

Hashnode Universal MCP Server

This repository contains an implementation of an Hashnode Universal MCP (Model Context Protocol) server. It provides a standardized interface for interacting with Hashnode's tools and services through a unified API.

The server is built using the Universal MCP framework.

This implementation follows the MCP specification, ensuring compatibility with other MCP-compliant services and tools.

Usage

You can start using Hashnode directly from agentr.dev. Visit agentr.dev/apps and enable Hashnode.

If you have not used universal mcp before follow the setup instructions at agentr.dev/quickstart

Available Tools

The full list of available tools is at ./src/universal_mcp_hashnode/README.md

Local Development

📋 Prerequisites

Ensure you have the following before you begin:

• Python 3.11+ (recommended)
• uv (install globally with pip install uv)

🛠️ Setup Instructions

Follow the steps below to set up your development environment:

1. Sync Project Dependencies

   uv sync
   

   This installs all dependencies from pyproject.toml into a local virtual environment (.venv).

2. Activate the Virtual Environment

   For Linux/macOS:

   source .venv/bin/activate
   

   For Windows (PowerShell):

   .venv\Scripts\Activate
   

3. Start the MCP Inspector

   mcp dev src/universal_mcp_hashnode/server.py
   

   This will start the MCP inspector. Make note of the address and port shown in the console output.

4. Install the Application

   mcp install src/universal_mcp_hashnode/server.py
   

📁 Project Structure

.
├── src/
│   └── universal_mcp_hashnode/
│       ├── __init__.py       # Package initializer
│       ├── server.py            # Server entry point
│       ├── app.py            # Application tools
│       └── README.md         # List of application tools
├── tests/                    # Test suite
├── .env                      # Environment variables for local development
├── pyproject.toml            # Project configuration
└── README.md                 # This file

📄 License

This project is licensed under the MIT License.

---

Generated with MCP CLI — Happy coding! 🚀