pashaydev terminal.shop.mcp

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.

• 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

• Node.js
• A Terminal.shop account
• A Terminal.shop API token

1. Clone this repository

2. Install dependencies:

   npm install

3. Connect to Terminal.shop and create a new token:

   ssh terminal.shop -t tokens

4. 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"
      }
    }
  }
}

1. Restart claude.app, and make sure you see hammer icon under input

2. Ask claude to get list of products or create a new address, subscription etc

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

The server provides various tools for interacting with Terminal.shop:

• search-products - Search for products by keyword
• get-product-details - Get detailed information about a specific product

• 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

• create-order - Create an order directly without using the cart

• 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

• create-subscription - Start a new coffee subscription
• cancel-subscription - Cancel an existing subscription

• create-token - Create a new personal access token
• delete-token - Delete a personal access token
• get-app-data - Fetch all account data at once

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

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.

• 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

This project is licensed under the MIT License - see the LICENSE file for details.