Connects GPT-4 to a merchant store API, allowing AI to query and update store data for a specific merchant, including listing stores, searching for relevant stores, and adding new stores with descriptions and tags.
AI_SYNC Tooling with OpenAI + MCP
This project connects GPT-4 to a backend merchant store API using the Model Context Protocol (MCP). It allows querying and updating store data under a specific merchant class.
⚠️ Note: The server is currently hardcoded to work with the
Tnc_Storemerchant ID. Only data under this class is accessible to the AI.
⚙️ Setup Instructions
1. Clone the Repository
2. Create a .env File
Inside the project root, create a .env file containing your OpenAI API key:
3. Set Up the Python Environment with uv
If you haven’t installed uv, do so with:
Then set up and activate the virtual environment:
This will automatically install dependencies based on the uv.lock file.
4. Start the Merchant API Server
Ensure the backend server (AI_SYNC) is running locally on:
Required POST endpoints:
/MerchantStore/findAllStores/MerchantStore/findStore/MerchantStore/addNewStore
5. Run the Tooling System
To launch the client and tool server together:
server.pyprovides tool definitions via MCPclient.pyconnects to GPT-4 and routes user queries
Related MCP server: Shopify MCP Server
💬 Example Queries
⚠️ For multiline input, paste it as a single line. Shift+Enter will submit prematurely in most terminals.
📁 Basic Project Structure
✅ Available Tools
Tool Name | Description |
| List all stores for
|
| Natural language search for relevant stores |
| Add a store with full description and tags |
🔒 Notes
Only data for
Tnc_Storeis accessibleRequires OpenAI GPT-4 (
gpt-4o) and a functioning backend APIRuns entirely locally using standard input/output