README.md•4.54 kB
# Crossmint Checkout MCP Server
Crossmint's Checkout allows programmatic purchase of physical and virtual goods and services,
with programmable money. It enables your AI agent to reliably purchase over 1 billion items,
without any cost overhead, nor hassle and unreliability of having to use virtual debit cards and browser
use to pay in online forms.
If your agent can obtain an item SKU/identifier, this API can let it buy it.
## Capabilities
This MCP server takes an item identifier (from URL to SKUs) and allows you to execute a purchase of it
in a single API call.
These purchases are real:
- The item is delivered with expedited shipping
- A receipt is generated
- Sales tax is properly collected
- Returns and refunds are allowed
### Available Inventory
- **Amazon** (US only)
- Prime shipping included
- **Shopify** (Global)
- Buy anything from any shopify store
Coming soon:
- Flights
- Hotels
- Dining
- Tickets
## How are purchases paid
This MCP server is configured to perform purchases with Crossmint credits. Please [contact us](support@crossmint.io) if you are interested to learn more. To use USDC instead of credits:
1. Change TOKEN variable to "usdc" in src/index.ts
2. Change the CREDIT_TOKEN_ADDRESS to the USDC address on ethereum `0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48`
### How to get a company treasury wallet
Crossmint will create a wallet for your company and share with you the wallet address.
### How to get credits
Crossmint will securely transfer credits to the company wallet. The company will then be able to transfer credits to agent wallets whenever agents want to top up their wallet or complete a transaction.
## Setup
1. **Clone the repository**
```bash
git clone https://github.com/Crossmint/mcp-crossmint-checkout.git
cd mcp-crossmint-checkout
```
2. **Install dependencies**
```bash
npm install
```
3. **Create .env file**
```bash
cp .env.template .env
```
4. **Obtain Crossmint API key**
- Login to [Crossmint Console](https://www.crossmint.com/signin?callbackUrl=/console) and navigate to Integrate > API Keys > Create new server key
- Select scopes: `orders.create`, `orders.read`, `wallets:transactions.create`, `wallets.create`, `wallets.read`, `wallets.balance:read`.
- Copy API key and paste it in your .env file
5. **Fill in user & delivery information**
Specify the user's id as well as their name, shipping address, and email in the .env file. Also make sure to fill in your company's wallet address.
6. **Test vs. production**
Keep the `ENV` variable in your .env file to "test" so you can test orders. Change it to "prod" to complete real orders.
7. **Generate an agent wallet**
```bash
npm run generate-agent-wallet
```
8. **Transfer credits to agent wallet**
To transfer 5 credits from the company's wallet to a user identified via userId "johnjoe", run the following
```bash
npm run transfer-credits -- 5 johndoe
```
If instead you uniquely identify users via email, you can adjust the user locator in `generate-wallet.js` and `credit-transfer.js`
9. **Update Claude's configuration**
```bash
npm run update-claude-config
```
10. **Build the project**
```bash
npm run build
```
11. **Run the server**
```bash
npm run crossmint-checkout
```
## Use it with Claude
Ask Claude to:
1. Describe the product you are looking for and ask for its Amazon.com link, i.e. "I'm looking to buy non-flavored LaCroix sprankling water! Can you look up available listings on Amazon and find something under $5? Share the Amazon link when you are done."
2. Ask Claude to buy it for you, i.e. "Buy this https://www.amazon.com/Sparkling-Naturally-Essenced-Calories-Sweeteners/dp/B00O79SKV6"
3. Check your email for the purchase receipt
## Tools
1. `create-order`
Creates a new order for a specified product. Amazon products are specified as 'amazon:<amazon_product_id>' or 'amazon:<asin>', while Shopify products as 'shopify:<product-url>:<variant-id>'.
Example Prompt:
> "Buy me this https://www.amazon.com/Sparkling-Naturally-Essenced-Calories-Sweeteners/dp/B00O79SKV6"
2. `check-order`
Checks the status of an existing order.
Example Prompt:
> "What's the status of my order?
3. `get-usd-balance`
Gets the USD balance of the wallet.
Example Prompt:
> "What's my wallet's balance?"
## Support
Reach out directly to Crossmint via support@crossmint.io with any questions.