home / mcp / jsonplaceholder mcp server

JSONPlaceholder MCP Server

Provides MCP access to the JSONPlaceholder API with tools, prompts, and data resources.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "danielpdev-mcp-jsonplaceholder": {
      "command": "/Users/danielpopa/Projects/work/mcp-server/cursor_runner.sh",
      "args": []
    }
  }
}

You can use this MCP server to access the JSONPlaceholder fake REST API through a modern MCP workflow. It exposes Tools, Resources, and Prompts that let you fetch data, simulate changes, and analyze content, all in a way that’s friendly to large language models and automated clients.

How to use

Connect to the JSONPlaceholder MCP server from your MCP client to explore posts, users, comments, albums, photos, and todos. Use the provided Tools to retrieve data, create simulated content, and search posts. Load Resources to reason about specific data items, and apply Prompts to generate analyses and summaries. Start by ensuring your client can reach the MCP endpoint and then pick a workflow that matches your task, such as loading all posts as context, inspecting a user profile, or generating an analysis of a post.

How to install

Prerequisites: Python 3.10 or newer, and the uv package manager.

1. Obtain the MCP server package or project files for JSONPlaceholder MCP Server.

2. Prepare your environment with uv installed. If you already have uv, skip this step. If not, install uv according to your system package manager or Python environment setup.

3. Run the MCP server startup script or command as shown in the configuration example. The following snippet demonstrates the MCP server entry you will add to your client configuration.

{
  "mcpServers": {
    "jsonplaceholder": {
      "command": "/Users/danielpopa/Projects/work/mcp-server/cursor_runner.sh",
      "args": []
    }
  }
}

Additional sections

Configuration overview: This MCP server is built with FastMCP and offers a cohesive set of data access points, actions, and templates to work with JSONPlaceholder data.

Security and access: No API key is required for JSONPlaceholder, as it is a free public API. Your MCP client will access the provided endpoints without additional authentication for this mock data set.

Notes on usage patterns: Use Tools to perform operations like retrieving posts, users, comments, albums, photos, and todos. Use Resources to fetch data as structured context, and use Prompts to generate analyses or summaries based on specific IDs or content.

Available tools

get_posts

Retrieve all posts or a specific post by ID

get_users

Retrieve all users or a specific user by ID

get_comments

Retrieve comments, optionally filtered by post ID

get_albums

Retrieve albums, optionally filtered by user ID

get_photos

Retrieve photos, optionally filtered by album ID

get_todos

Retrieve todos, optionally filtered by user ID

create_post

Create a new post (simulated)

search_posts

Search posts by title or body content

analyze_post

Generate analysis prompt for a specific post

user_profile_summary

Create comprehensive user profile analysis