The Terminal.shop MCP Server enables AI assistants to interact with Terminal.shop for managing a user's shopping experience, including:
- Product Management: Browse, search, and get detailed product information.
- Cart Operations: Add items, set shipping address and payment method, clear cart, and checkout.
- Order Management: Place orders directly and view order history.
- Subscription Handling: Create and cancel coffee subscriptions with scheduling options.
- User Profile: Update user information and manage shipping addresses.
- Payment Methods: Securely collect and manage payment information.
- Account Tools: Create and delete personal access tokens, fetch all account data.
Serves as the runtime environment for the Terminal.shop MCP server, enabling product browsing, cart management, order placement, and subscription handling through Terminal.shop's API.
Facilitates secure payment processing for Terminal.shop, allowing for adding payment methods using Stripe tokens and collecting card information through secure URLs.
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
- Clone this repository
- Install dependencies:
- Connect to Terminal.shop and create a new token:
- Open claude.app, go to settings, click 'developer' option and 'edit config':
- Restart claude.app, and make sure you see hammer icon under input
- 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 productsterminal://product/{id}
- Get details for a specific productterminal://orders
- View order historyterminal://profile
- Access user profile informationterminal://addresses
- Manage shipping addressesterminal://cards
- Manage payment methodsterminal://cart
- View current shopping cartterminal://subscriptions
- Manage coffee subscriptions
Tools
The server provides various tools for interacting with Terminal.shop:
Product Tools
search-products
- Search for products by keywordget-product-details
- Get detailed information about a specific product
Cart Tools
add-to-cart
- Add a product variant to the cartset-cart-address
- Set the shipping address for the cartset-cart-card
- Set the payment method for the cartclear-cart
- Empty the shopping cartcheckout
- 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 informationcreate-address
- Add a new shipping addressdelete-address
- Remove a shipping addresscollect-card
- Generate a secure URL for adding payment informationcreate-card
- Add a card using a Stripe tokendelete-card
- Remove a payment method
Subscription Tools
create-subscription
- Start a new coffee subscriptioncancel-subscription
- Cancel an existing subscription
Account Tools
create-token
- Create a new personal access tokendelete-token
- Delete a personal access tokenget-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 productsmanage-cart
- Help with shopping cart managementplace-order
- Assistance with placing an ordermanage-subscription
- Support for subscription managementmanage-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.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
Allows AI assistants to seamlessly interact with Terminal.shop to browse products, manage shopping carts, place orders, and handle subscriptions through Terminal.shop's API.
- Features
- Setup
- Available Resources
- Tools
- Prompt Templates
- API Documentation
- Security Considerations
- License
Related Resources
Related MCP Servers
- -securityFlicense-qualityEnables AI assistants to interact with Metabase databases and dashboards, allowing users to list and execute queries, access data visualizations, and interact with database resources through natural language.Last updated -25JavaScript
- -securityFlicense-qualityEnables AI assistants to interact with Metabase, providing access to dashboards, questions, databases, and tools for executing queries and viewing data through natural language.Last updated -JavaScript
- -securityAlicense-qualityAllows AI assistants to safely execute common Unix/macOS terminal commands through a controlled interface with comprehensive security features.Last updated -PythonMIT License
TailorKit MCPofficial
AsecurityFlicenseAqualityConnects AI assistants to the TailorKit API, enabling them to manage customizable product templates for e-commerce platforms through natural language conversations.Last updated -455TypeScript