Skip to main content
Glama

Fake Store MCP Server

NPM Version License: MIT

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 sorting

  • get_product - Get detailed product information by ID

  • list_categories - Get all available product categories

  • get_products_by_category - Filter products by category

Carts

  • list_carts - Get all shopping carts

  • get_cart - Get cart details by ID

  • get_user_carts - Get all carts for a specific user

Users

  • list_users - Get all users

  • get_user - Get user details by ID

Installation

For Claude Desktop

  1. Install the package:

npm install -g fake-store-mcp
  1. Configure Claude Desktop:

Edit your Claude Desktop configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • Linux: ~/.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"
    }
  }
}
  1. 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-mcp

Or install it locally in your project:

npm install fake-store-mcp

Usage Examples

Example 1: Browsing Products

User: "Show me the first 5 products from the store"

Claude: Uses list_products tool with limit: 5

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 dev

Project 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.json

Contributing

Contributions are welcome! This project is designed to be beginner-friendly and serves as a reference for learning MCP server development.

How to Contribute

  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 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

  1. Verify the configuration file path is correct

  2. Ensure the JSON is valid (no trailing commas)

  3. Restart Claude Desktop completely

  4. Check Claude Desktop logs for errors

"Command not found" error

Make sure the package is installed globally:

npm install -g fake-store-mcp

Network errors

The server requires internet access to reach fakestoreapi.com. Check your network connection and firewall settings.

Acknowledgments


Made with ❤️ for the MCP community

If you find this useful, please give it a ⭐️ on GitHub!

Available Tools

9 tools
get_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

    A3.8/5.0

    Scored across 9 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers