Crossmint Checkout MCP Server

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. However, simply changing the TOKEN variable to "usdc" in src/index.ts enables purchases with stablecoins.

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
   git clone https://github.com/Crossmint/mcp-crossmint-checkout.git cd mcp-crossmint-checkout
2. Install dependencies
   npm install
3. Create .env file
   cp .env.template .env
4. Obtain Crossmint API key
   • Login to Crossmint 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 informationSpecify 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. productionKeep 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
   npm run generate-agent-wallet
8. Transfer credits to agent walletTo transfer 5 credits from the company's wallet to a user identified via userId "johnjoe", run the following
   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
   npm run update-claude-config
10. Build the project
    npm run build
11. Run the server
    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:' or 'amazon:', while Shopify products as 'shopify::'.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.