get_postsLABSCO SUMMARY
Something safe to point a new client at.
The value is not the data, which is fictional. It is that all three MCP primitives are implemented over it, so you can find out whether your client really handles resources and prompts or only tools.
What it is
A FastMCP server over JSONPlaceholder, the free fake REST API used for testing and prototyping. It implements all three MCP primitives — tools, resources and prompts — against that data.
What you get
- Posts, users, comments, albums, photos and todos retrieved, whole or by ID
- Comments filtered by post, albums by user, photos by album, todos by user
- Posts searched by title or body content
- A post created, simulated the way JSONPlaceholder does it
- Resources at posts://all, posts://{post_id}, users://all and users://{user_id}
- Prompts for analysing a post and for summarising a user profile
Requirements
Python 3.10 or newer and the uv package manager; uv sync, then run server.py. No key — JSONPlaceholder is public and the data is invented.
Setup effort
Build from source
USE CASES
Checking whether a new MCP client handles resources
Load posts://all or users://5 and see whether the client surfaces it at all.
Testing tool calls against a predictable API
Fetch posts and users where you already know exactly what should come back.
Prototyping a UI against realistic nested data
Pull comments for a post, or photos for an album, and build against the shape.
Trying a write path without consequences
Create a post; JSONPlaceholder simulates it rather than storing anything.
Exercising search behaviour
Search posts by title or body content.
Checking prompt support end to end
Run the post-analysis or user-profile prompt through your client and see what it does with it.
8 tools
Listed in project docs. Your client may show a different list.
get_usersget_commentsget_albumsget_photosget_todoscreate_postsearch_postsBEFORE YOU INSTALL
What to know first
Tools you get
8 tools named in the project's documentation. Four resources (posts://all, posts://{post_id}, users://all, users://{user_id}) and two prompts (analyze_post, user_profile_summary) sit alongside the tools.
Requires
Python 3.10+
INSTALLATION
Connect your client
Server setup
git clone https://github.com/danielpdev/mcp-JSONPlaceholder
cd mcp-JSONPlaceholder
uv sync
uv run python server.pyMCP Clients
Claude Desktop
uv run mcp install server.py --name "JSONPlaceholder API"