Fake Store API MCP Server

A Model Context Protocol (MCP) server that provides seamless access to the Fake Store API for AI assistants. Perfect for e-commerce demos, testing, and learning MCP development.

Features

• 🛍️ Complete E-commerce Data Access: Products, carts, and users

• 🔧 18 MCP Tools: Full CRUD operations for all resources

• 📦 Easy Integration: Works with Claude Desktop, Plugged.in, and other MCP clients

• 🚀 Zero Configuration: Works out of the box with Fake Store API

• 📝 TypeScript: Fully typed for better development experience

• ✅ Input Validation: Comprehensive parameter validation

Installation

NPX (Recommended)

From Source

Configuration

Claude Desktop

Add this to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

Plugged.in

Add this server configuration in Plugged.in MCP settings:

Available Tools

Products (7 tools)

• fakestore_get_products - Get all products with optional limit and sorting

• fakestore_get_product - Get a single product by ID

• fakestore_get_categories - Get all product categories

• fakestore_get_products_by_category - Get products in a specific category

• fakestore_add_product - Add a new product (simulation)

• fakestore_update_product - Update an existing product (simulation)

• fakestore_delete_product - Delete a product (simulation)

Carts (6 tools)

• fakestore_get_carts - Get all carts with optional limit and sorting

• fakestore_get_cart - Get a single cart by ID

• fakestore_get_user_carts - Get all carts for a specific user

• fakestore_add_cart - Add a new cart (simulation)

• fakestore_update_cart - Update an existing cart (simulation)

• fakestore_delete_cart - Delete a cart (simulation)

Users (5 tools)

• fakestore_get_users - Get all users with optional limit and sorting

• fakestore_get_user - Get a single user by ID

• fakestore_add_user - Add a new user (simulation)

• fakestore_update_user - Update an existing user (simulation)

• fakestore_delete_user - Delete a user (simulation)

Usage Examples

With Claude Desktop

Get all products:

Search by category:

Get user's cart:

Product analysis:

Programmatic Usage

Data Structure

Product

Cart

User

Development

Important Notes

• Simulation: The Fake Store API is read-only. POST, PUT, and DELETE operations return simulated responses but don't persist data.

• Rate Limits: The public API has no strict rate limits, but please be respectful.

• Data: All data is fake and for testing purposes only.

Troubleshooting

Server not appearing in Claude Desktop

1. Ensure the configuration file is valid JSON

2. Restart Claude Desktop completely

3. Check the Claude Desktop logs for errors

Tools not working

1. Verify you have an active internet connection (API requires connectivity)

2. Check if fakestoreapi.com is accessible

3. Review error messages in Claude Desktop logs

Contributing

Contributions are welcome! Please:

1. Fork the repository

2. Create a feature branch (git checkout -b feature/amazing-feature)

3. Commit your changes (git commit -m 'Add amazing feature')

4. Push to the branch (git push origin feature/amazing-feature)

5. Open a Pull Request

License

MIT License - see LICENSE file for details.

Resources

• Fake Store API Documentation

• Model Context Protocol Documentation

• MCP TypeScript SDK

Support

• 🐛 Report Issues

• 💬 Discussions

• 📧 Email: your.email@example.com

Built with ❤️ for the MCP community