JSONPlaceholder

A free public REST API for testing and prototyping, powered by JSONPlaceholder.

A modern Model Context Protocol (MCP) server built with FastMCP that provides access to the JSONPlaceholder API - a free fake REST API for testing and prototyping.

This MCP server providesResources,Tools, andPromptsfor interacting with JSONPlaceholder:

- 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

- posts://all- Get all posts as a resource
- posts://{post_id}- Get a specific post as a resource
- users://all- Get all users as a resource
- users://{user_id}- Get a specific user as a resource

- analyze_post- Generate analysis prompt for a specific post
- user_profile_summary- Create comprehensive user profile analysis

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

- Clone or download this project
- The project is already configured with uv. Simply run:

MCP Inspector(recommended for development):

This opens an interactive web interface to test all tools, resources, and prompts.

uv run mcp install server.py --name "JSONPlaceholder API"

Once connected to an MCP client, you can:

- "Get all posts from JSONPlaceholder"
- "Show me user details for user ID 1"
- "Search for posts containing 'dolor'"
- "Create a new post titled 'Test' with body 'Hello World' for user 1"

- The client can loadposts://allto get all posts as context
- Loadusers://5to get user 5's details as background information

- Use the "analyze_post" prompt with post ID 1 for detailed post analysis
- Use "user_profile_summary" with user ID 2 for comprehensive user profiling

This server uses the JSONPlaceholder API (https://jsonplaceholder.typicode.com/), which provides:

An MCP server and client implementation for the Swagger Petstore API.