Terminal.shop MCP Server

# Terminal.shop MCP Server This project implements a mcp server for interacting with the terminal.shop. It allows ai assistants to seamlessly browse products, manage shopping carts, place orders, and handle subscriptions through Terminal.shop's API. ## Features - **Product Management**: Browse and search Terminal.shop's coffee products - **Cart Operations**: Add items to cart, set shipping address and payment method - **Order Management**: Place orders and view order history - **Subscription Handling**: Create and manage recurring coffee subscriptions - **User Profile**: Update user information and manage shipping addresses - **Payment Methods**: Secure handling of payment information ## Setup ### Prerequisites - Node.js - A Terminal.shop account - A Terminal.shop API token ### Installation 1. Clone this repository 2. Install dependencies: ```bash npm install ``` 4. Connect to Terminal.shop and create a new token: ```bash ssh terminal.shop -t tokens ``` 5. Open claude.app, go to settings, click 'developer' option and 'edit config': ``` { "mcpServers": { "terminal-shop-mcp": { "command": "node", "args": ["path_to_folder/server.js"], "env": { "TERMINAL_API_TOKEN": "token here" } } } } ``` 6. Restart claude.app, and make sure you see hammer icon under input 7. Ask claude to get list of products or create a new address, subscription etc ## Available Resources The MCP server provides the following resources: - `terminal://products` - List all available products - `terminal://product/{id}` - Get details for a specific product - `terminal://orders` - View order history - `terminal://profile` - Access user profile information - `terminal://addresses` - Manage shipping addresses - `terminal://cards` - Manage payment methods - `terminal://cart` - View current shopping cart - `terminal://subscriptions` - Manage coffee subscriptions ## Tools The server provides various tools for interacting with Terminal.shop: ### Product Tools - `search-products` - Search for products by keyword - `get-product-details` - Get detailed information about a specific product ### Cart Tools - `add-to-cart` - Add a product variant to the cart - `set-cart-address` - Set the shipping address for the cart - `set-cart-card` - Set the payment method for the cart - `clear-cart` - Empty the shopping cart - `checkout` - Convert the cart to an order ### Order Tools - `create-order` - Create an order directly without using the cart ### User Management Tools - `update-profile` - Update user profile information - `create-address` - Add a new shipping address - `delete-address` - Remove a shipping address - `collect-card` - Generate a secure URL for adding payment information - `create-card` - Add a card using a Stripe token - `delete-card` - Remove a payment method ### Subscription Tools - `create-subscription` - Start a new coffee subscription - `cancel-subscription` - Cancel an existing subscription ### Account Tools - `create-token` - Create a new personal access token - `delete-token` - Delete a personal access token - `get-app-data` - Fetch all account data at once ## Prompt Templates The server includes several prompt templates to help AI assistants provide better responses: - `browse-products` - Guide for browsing and finding products - `manage-cart` - Help with shopping cart management - `place-order` - Assistance with placing an order - `manage-subscription` - Support for subscription management - `manage-profile` - Guide for profile and address management ## API Documentation This MCP server is built on top of the Terminal.shop API. For detailed information about the underlying API, refer to the Terminal API documentation. ## Security Considerations - The server handles sensitive payment information through secure URLs rather than directly processing card details - API tokens are stored in environment variables to prevent exposure - User data is handled according to Terminal.shop's security practices ## License This project is licensed under the MIT License - see the LICENSE file for details.