Terminal.shop

🚀 Terminal Shop MCP Server

This project implements an MCP server that interacts with Terminal.shop. It enables AI assistants to seamlessly browse products, manage shopping carts, place orders, and handle subscriptions through Terminal.shop's API.

🚀 Quick Start

This MCP server allows AI assistants to interact with Terminal.shop, enabling seamless operations such as product browsing, shopping cart management, order placement, and subscription handling.

✨ Features

• Product Management: Browse and search for coffee products on Terminal.shop.
• Shopping Cart Operations: Add items to the cart, set delivery addresses, and choose payment methods.
• Order Management: Place orders and view order history.
• Subscription Handling: Create and manage coffee subscriptions.
• User Profile: Update user information and manage delivery addresses.
• Payment Methods: Securely handle payment information.

📦 Installation

Prerequisites

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

Installation Steps

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 the "Developer" option, then "Edit Configuration":

{
  "mcpServers": {
    "terminal-shop-mcp": {
      "command": "node",
      "args": ["path_to_folder/server.js"],
      "env": {
        "TERMINAL_API_TOKEN": "Your token here"
      }
    }
  }
}

6. Restart claude.app and ensure you see the hammer icon below the input box.
7. Ask claude to get the product list, create a new address, subscription, etc.

💻 Usage Examples

Available Resources

The resources provided by this MCP server are as follows:

• terminal://products - List all available products.
• terminal://product/{id} - Get detailed information about a specific product.
• terminal://orders - View order history.
• terminal://profile - Access user profile information.
• terminal://addresses - Manage delivery addresses.
• terminal://cards - Manage payment methods.
• terminal://cart - View the 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 related to keywords.
• get-product-details - Get detailed information about a specific product.

Shopping Cart Tools

• add-to-cart - Add product variants to the shopping cart.
• set-cart-address - Set the delivery address for the shopping cart.
• set-cart-card - Set the payment method for the shopping cart.
• clear-cart - Empty the shopping cart.
• checkout - Convert the shopping cart into an order.

Order Tools

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

User Management Tools

• update-profile - Update user profile information.
• create-address - Add a new delivery address.
• set-default-address - Set the default delivery address.
• remove-address - Delete a delivery address.

Subscription Tools

• subscribe - Create a new subscription.
• get-subscriptions - View all subscriptions.
• cancel-subscription - Cancel a subscription.
• update-subscription - Update subscription information.
• add-payment-method - Add a new payment method to a subscription.
• remove-payment-method - Delete a payment method from a subscription.

Prompt Templates

• Product Prompts: Assist users in finding specific products or recommending popular products.
• Shopping Cart Prompts: Guide users in managing shopping cart operations, such as adding and removing items.
• Order Prompts: Help users view order status and history.
• Subscription Prompts: Provide guidance on creating, updating, and canceling subscriptions.

📚 Documentation

The complete API documentation can be found in the Terminal.shop Developer Documentation.

🔧 Technical Details

Security Considerations

• All sensitive information (e.g., API tokens) must be handled securely to prevent leakage.
• Ensure that all network requests use HTTPS to guarantee transmission security.
• Regularly update software and dependencies to protect against known security vulnerabilities.

📄 License

This project is licensed under the MIT License.