About jsonplaceholder-mcp
jsonplaceholder-mcp is an MCP server for accessing the JSONPlaceholder API, aimed at developers who need sample data in MCP workflows. The README mentions users, posts, albums, and related data.
Key features
- 01Access the JSONPlaceholder API
- 02Retrieve user data
- 03Read post data
- 04Read album data
Use cases
- 01Retrieve a user list in an MCP workflow
- 02Read sample posts and album data
MCP support
The server provides JSONPlaceholder API data to MCP clients through tools; the README mentions users, posts, albums, and related endpoints.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEJsonPlaceHolder MCP Application
A comprehensive Model Context Protocol (MCP) server that interacts with the JsonPlaceholder (https://jsonplaceholder.typicode.com)API to provide access to users, posts, albums, and related data.
🚀 Features
This MCP Server provides a set of tools to interact with various endpoints of the JSONPlaceholder API:
👤 User Tools
- Get Users: Retrieve a list of all users
- Get User by ID: Fetch details of a specific user
- Get User Posts: Retrieve all posts created by a specific user
- Get User Albums: Fetch all albums created by a specific user
- Get User Todos: Retrieve all todos associated with a specific user
📝 Post Tools
- Get Posts: Retrieve a list of all posts
- Get Post by ID: Fetch details of a specific post
- Get Post Comments: Retrieve all comments on a specific post
🖼️ Album Tools
- Get Albums: Retrieve a list of all albums
- Get Album by ID: Fetch details of a specific album
- Get Album Photos: Retrieve all photos in a specific album
🛠️ Technical Details
This application is built using:
- TypeScript
- Zod for schema validation
- Fetch API for data retrieval
Usage with Claude Desktop
Docker
-
Build
docker build -t json-place-holder .
-
Add this to claude_desktop_config.json
{
"mcpServers": {
"JsonPlaceHolder Notes Server": {
"command": "docker",
"args": ["run", "-i", "--rm", "json-place-holder"]
}
}
}
NPX
- Install the libraries
npm run install
- Build the server
npm run build
- Add this to claude_desktop_config.json
Note: For Windows use path :absolute_path\\dist\\index.js
{
"mcpServers": {
"JsonPlaceHolder MCP Server": {
"command": "node",
"args": [
"absolute_path/dist/index.js"
]
}
}
}
Or Inspect Locally
npm run inspect
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.