fake-store-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@fake-store-mcp Show me the first 5 products"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Fake Store MCP Server
A Model Context Protocol (MCP) server that provides AI assistants like Claude with access to the Fake Store API - a free REST API for e-commerce prototyping and testing.
Features
9 Ready-to-Use Tools for products, carts, and users
Full TypeScript Support with strict type safety
Production-Ready with retry logic and error handling
Zero Configuration - works out of the box
Beginner-Friendly - great for learning MCP development
Related MCP server: Shopify Storefront MCP Server
Available Tools
Products
list_products- Get all products with pagination and sortingget_product- Get detailed product information by IDlist_categories- Get all available product categoriesget_products_by_category- Filter products by category
Carts
list_carts- Get all shopping cartsget_cart- Get cart details by IDget_user_carts- Get all carts for a specific user
Users
list_users- Get all usersget_user- Get user details by ID
Installation
For Claude Desktop
Install the package:
npm install -g fake-store-mcpConfigure Claude Desktop:
Edit your Claude Desktop configuration file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.jsonLinux:
~/.config/Claude/claude_desktop_config.json
Add the following configuration:
{
"mcpServers": {
"fake-store": {
"command": "npx",
"args": ["-y", "fake-store-mcp"]
}
}
}Alternative (if installed globally):
{
"mcpServers": {
"fake-store": {
"command": "fake-store-mcp"
}
}
}Restart Claude Desktop
The tools will now be available in your Claude conversations!
For Other MCP Clients
If you're using another MCP-compatible client, you can run the server directly:
npx fake-store-mcpOr install it locally in your project:
npm install fake-store-mcpUsage Examples
Example 1: Browsing Products
User: "Show me the first 5 products from the store"
Claude: Uses list_products tool with limit: 5
Example 2: Product Search
User: "What electronics products are available?"
Claude: Uses list_categories first, then get_products_by_category with category: "electronics"
Example 3: User Cart Analysis
User: "Show me what user 1 has in their shopping carts"
Claude: Uses get_user_carts with userId: 1
Example 4: Product Details
User: "Tell me more about product ID 5"
Claude: Uses get_product with id: 5
Tool Parameters
list_products
{
limit?: number; // Limit number of results
sort?: 'asc' | 'desc'; // Sort order
}get_product
{
id: number; // Product ID (required)
}list_categories
No parameters required.
get_products_by_category
{
category: string; // Category name (required)
limit?: number; // Limit number of results
sort?: 'asc' | 'desc'; // Sort order
}list_carts
{
limit?: number; // Limit number of results
sort?: 'asc' | 'desc'; // Sort order
}get_cart
{
id: number; // Cart ID (required)
}get_user_carts
{
userId: number; // User ID (required)
}list_users
{
limit?: number; // Limit number of results
sort?: 'asc' | 'desc'; // Sort order
}get_user
{
id: number; // User ID (required)
}Development
Prerequisites
Node.js 18 or higher
npm or yarn
Setup
# Clone the repository
git clone https://github.com/ckaraca/fake-store-mcp.git
cd fake-store-mcp
# Install dependencies
npm install
# Build the project
npm run build
# Run in development mode (auto-rebuild on changes)
npm run devProject Structure
fake-store-mcp/
├── src/
│ ├── index.ts # MCP server entry point
│ ├── tools/
│ │ ├── products.ts # Product tools
│ │ ├── carts.ts # Cart tools
│ │ └── users.ts # User tools
│ ├── api/
│ │ ├── client.ts # HTTP client with retry logic
│ │ └── types.ts # TypeScript type definitions
│ └── utils/
│ └── error-handler.ts # Error handling utilities
├── dist/ # Compiled output
└── package.jsonContributing
Contributions are welcome! This project is designed to be beginner-friendly and serves as a reference for learning MCP server development.
How to Contribute
Fork the repository
Create a feature branch (
git checkout -b feature/amazing-feature)Commit your changes (
git commit -m 'Add amazing feature')Push to the branch (
git push origin feature/amazing-feature)Open a Pull Request
License
MIT License - see the LICENSE file for details.
About Fake Store API
This server integrates with fakestoreapi.com, a free REST API for e-commerce testing and prototyping. The API provides:
20 sample products across 4 categories
10 sample users
7 sample shopping carts
No authentication required
No rate limits
Resources
Troubleshooting
Server not showing in Claude Desktop
Verify the configuration file path is correct
Ensure the JSON is valid (no trailing commas)
Restart Claude Desktop completely
Check Claude Desktop logs for errors
"Command not found" error
Make sure the package is installed globally:
npm install -g fake-store-mcpNetwork errors
The server requires internet access to reach fakestoreapi.com. Check your network connection and firewall settings.
Acknowledgments
Thanks to Fake Store API for providing the free API
Built with the MCP TypeScript SDK
Inspired by the MCP community
Made with ❤️ for the MCP community
If you find this useful, please give it a ⭐️ on GitHub!
Available Tools
9 toolsget_cartA
Get detailed information about a specific cart by its ID.
Inputs: id (required).
get_productB
Get detailed information about a specific product by its ID.
Inputs: id (required).
get_products_by_categoryA
Get all products in a specific category. Supports pagination with limit and sorting.
Inputs: category (required), sort, limit.
get_userB
Get detailed information about a specific user by their ID.
Inputs: id (required).
get_user_cartsA
Get all shopping carts for a specific user by their user ID.
Inputs: userId (required).
list_cartsA
Get all shopping carts. Supports pagination with limit and sorting.
Inputs: sort, limit.
list_categoriesA
Get all available product categories.
Inputs: no named parameters.
list_productsA
Get all products from the store. Supports pagination with limit and sorting.
Inputs: sort, limit.
list_usersB
Get all users. Supports pagination with limit and sorting.
Inputs: sort, limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool targets a distinct resource and action: products, categories, carts, and users each have list/get operations, with get_products_by_category and get_user_carts providing specific filtered views. There is no overlap or ambiguity between tools.
All tools follow a consistent snake_case verb_noun pattern: list_* for collections and get_* for individual items. The compound names like get_products_by_category and get_user_carts remain readable and fit the same convention.
With 9 tools, the server is well-scoped for a fake store API covering products, categories, carts, and users. Every tool serves a clear purpose without redundancy or bloat.
The coverage is complete for read-only browsing: all resources have list and detail retrieval, with category and user-cart filtering. However, there are no create, update, or delete operations, which would be expected for full lifecycle management, but this may be intentional for a fake store demo.
Maintenance
Related MCP Connectors
Manage your NanoCart store from any AI agent: products, orders, coupons, subscribers, reports.
Enable AI assistants to interact seamlessly with Feeef e-commerce stores, products, and orders usi…
AI shopping gateway for product search, inventory, carts, and merchant-hosted checkout.
AI-powered commerce API for luxury skincare shopping. Enables AI agents to search products, browse collections, manage shopping carts, and generate checkout URLs for the Regenique Elegance Shopify store.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides seamless access to the Fake Store API for AI assistants with 18 CRUD tools for managing e-commerce data including products, carts, and users. Perfect for e-commerce demos, testing, and learning MCP development with zero configuration required.185 npmMIT
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to query and interact with Shopify store data via the Storefront API, including products, collections, carts, and customer information.9-
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to interact with WooCommerce stores via the WooCommerce REST API, supporting operations like listing products, orders, and customers.134 npmMIT
- AlicenseAqualityDmaintenanceEnables AI agents to search products, lookup barcodes, and manage shopping carts and wishlists using free e-commerce APIs.8MIT