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:

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

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.