MCP Server Starter
The server is designed to surface an online store's orders and products, and the README documents extending it to real Shopify data by rewriting the StoreRepository data-access layer to call the Shopify Admin GraphQL API (with read-only scopes such as read_orders, read_products, read_inventory). This would let the tools fetch order details, list recent orders by status, find low-stock products, and search products against a live Shopify store instead of the bundled sample JSON.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
MCP Server Starter
A small, read-only Model Context Protocol (MCP) server in Python that lets an AI assistant such as Claude query an online store's orders and products. It is a clean starting point for connecting an AI assistant to a real business system.
Built by Usama Afzall, Website Prism. Portfolio: usama.websiteprism.com.
What is MCP?
The Model Context Protocol is an open standard that lets AI applications connect to external tools and data sources through one consistent interface. An MCP server describes what it can do (tools, resources, prompts), and an MCP client such as Claude Desktop discovers and uses those capabilities.
Related MCP server: WooCommerce Insights MCP
What this server exposes
Type | Name | Purpose |
Tool |
| Full details of one order, with product titles. Accepts |
Tool |
| Newest orders first. |
Tool |
| Products at or below a stock level (default 10), lowest first. |
Tool |
| Case-insensitive keyword search over title, SKU, description, category and tags. All words must match. |
Resource |
| JSON snapshot: order counts by status, revenue, out-of-stock SKUs, low-stock count. |
Prompt |
| A ready-made instruction that tells the assistant how to produce a weekly review using the tools above. |
The data is fictional and lives in sample_data.json (12 orders, 10 products).
Install and run
Requires Python 3.10 or newer.
git clone https://github.com/Usama-Afzall/mcp-server-starter.git
cd mcp-server-starter
python3 -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -r requirements.txt
python test_server.py # end-to-end test over stdio
python server.py # starts the server on stdioserver.py waits for an MCP client on stdin, so running it directly will appear to do nothing. That is expected. To use a different data file, set the STORE_DATA_FILE environment variable.
Claude Desktop configuration
Add this to your claude_desktop_config.json, replacing the paths with absolute paths on your machine (use the Python from your virtual environment so the mcp package is found), then restart Claude Desktop:
{
"mcpServers": {
"store-assistant": {
"command": "/ABSOLUTE/PATH/TO/mcp-server-starter/.venv/bin/python",
"args": ["/ABSOLUTE/PATH/TO/mcp-server-starter/server.py"]
}
}
}Then try: "Which products are low on stock?", "Show me the three most recent paid orders", or use the weekly_store_review prompt.
Test with the MCP Inspector
npx @modelcontextprotocol/inspector python server.pyThis opens a local web UI where you can list and call the tools, read the resource and render the prompt. It requires Node.js and was not part of the automated test in this repository.
Extend to real Shopify data
The code is split on purpose. StoreRepository in server.py is the data access layer and contains no MCP code. The decorated functions below it are the MCP layer.
Create a Shopify custom app and an Admin API access token with read-only scopes only (for example
read_orders,read_products,read_inventory).Store the shop domain and token in environment variables, never in source control.
Rewrite the
StoreRepositorymethods to call the Shopify Admin GraphQL API and map the responses into the same dictionary shapes the sample data uses. The docstring on the class lists the starting points.Keep the input validation in the MCP layer. Run
test_server.pyagainst a development store or recorded fixtures.
Check the current Shopify Admin API documentation for exact field names and API versions. This repository does not call Shopify.
Security notes
Read-only by design. No tool creates, edits or deletes anything.
All inputs are validated with clear error messages: order ids are pattern-checked, limits and thresholds are range-checked, statuses are checked against an allowed list, and search text has a length cap.
Use least-privilege API tokens. Grant only the read scopes the tools need, and rotate tokens.
Never expose write tools (refunds, cancellations, price changes) without an explicit human confirmation step.
Treat tool output as sensitive. Real orders contain customer names and emails, so decide what to return and consider redacting personal data.
Limitations
Sample data only. Nothing here is connected to a live store.
Data is loaded once at startup, so edits to the JSON file need a server restart.
No pagination, authentication, rate limiting or caching. Results are capped by
limitonly on order listings.Search is simple substring matching, not ranked or fuzzy.
Revenue in the summary is a simple sum of paid and fulfilled order totals in USD. It ignores tax, shipping, discounts and refund partials.
Runs over stdio for local use. A hosted, multi-user deployment would need a network transport and proper authentication.
Tested with
mcp1.30.0 and 2.3.0 on Python 3.13. ThemcpSDK changes between major versions, so pin a version for production.
License
Source-available, not open source. You may read and evaluate this code, but commercial or production use requires a written licence from Usama Afzall. See LICENSE and https://usama.websiteprism.com/contact.
Need this customized? https://usama.websiteprism.com/contact
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Read-only Amazon profit, fee, ACoS, and geo-holdout MCP tools for Claude, ChatGPT, and agents.
Read and edit your Andavor store: catalog, product manuals, AI instructions, rules and sales totals.
Connect AI to store orders, products and inventory with scoped access and human approvals.
Run storefronts, listings, orders, content, fulfillment, and analytics through AI.
Related MCP Servers
- AlicenseAqualityDmaintenanceA read-only MCP server that lets AI assistants answer Shopify store operations questions via tools like get_shop, list_products, get_product, and list_orders.4MIT
- FlicenseNot gradedqualityCmaintenanceEnables secure, read-only access to WooCommerce store data through MCP-compatible assistants, letting users query products, orders, sales summaries, and inventory alerts without exposing store credentials.-
- AlicenseNot gradedqualityCmaintenanceConnects Claude, ChatGPT, Cursor, or any MCP client to a Shopify store, enabling read-only access to themes, Liquid files, catalogue data, and store configuration through 122 tools.2Apache 2.0
- AlicenseAqualityBmaintenanceEnables safe, read-only analysis of e-commerce data, including semantic product search, sales summaries, top products, customer orders, and low-stock alerts, through MCP tools and a LangGraph agent.5MIT