> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paywithsoap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Soap MCP Server

> Learn how to quickly integrate Soap using our MCP Server

## Overview

Soap MCP provides an easy way to integrate Soap's payments, compliance, and fraud workflows into your application using AI coding tools such as Cursor.

## Soap MCP Server Installation

<AccordionGroup>
  <Accordion title="Video walkthrough">
    <iframe src="https://screen.studio/share/lZXwO5XC" width="100%" height="400" frameBorder="0" allowFullScreen />
  </Accordion>

  <Accordion title="Step By Step Instructions">
    <Steps>
      <Step title="Click on the dropdown in the 'Copy Page'">
        <img src="https://mintcdn.com/soappaymentsinc/mIoCy_uIYgnWWlj8/images/first-step-mcp.png?fit=max&auto=format&n=mIoCy_uIYgnWWlj8&q=85&s=59a89b138174f4eb7d68e34116292d11" alt="Screenshot showing the Copy Page dropdown with IDE selection options" width="765" height="154" data-path="images/first-step-mcp.png" />
      </Step>

      <Step title="Select your IDE, e.g., 'Connect to Cursor'">
        <img src="https://mintcdn.com/soappaymentsinc/mIoCy_uIYgnWWlj8/images/second-step-mcp.png?fit=max&auto=format&n=mIoCy_uIYgnWWlj8&q=85&s=6cebe7338d46877811643555cca3d1a3" alt="Screenshot of Cursor settings showing how to pop open Cursor" width="272" height="448" data-path="images/second-step-mcp.png" />
      </Step>

      <Step title="Authorize the MCP Server and make sure it's on in your Cursor settings.">
        Allow Access to Cursor (or your favorite AI IDE):

        <img src="https://mintcdn.com/soappaymentsinc/mIoCy_uIYgnWWlj8/images/third-step-mcp.png?fit=max&auto=format&n=mIoCy_uIYgnWWlj8&q=85&s=e02e784977206878cdb838c12e71761d" alt="Screenshot of authorizing cursor" width="566" height="203" data-path="images/third-step-mcp.png" />

        Install the Soap MCP server from Cursor Settings

        <img src="https://mintcdn.com/soappaymentsinc/mIoCy_uIYgnWWlj8/images/fourth-step-mcp.png?fit=max&auto=format&n=mIoCy_uIYgnWWlj8&q=85&s=bb5f81d989c7d510f141e58eb4dbbda1" alt="Screenshot of installing Soap MCP in Cursor" width="629" height="261" data-path="images/fourth-step-mcp.png" />

        Make sure the Soap MCP Server is on (green)

        <img src="https://mintcdn.com/soappaymentsinc/mIoCy_uIYgnWWlj8/images/fifth-step-mcp.png?fit=max&auto=format&n=mIoCy_uIYgnWWlj8&q=85&s=331504ea4ff88fcb5452b501b2d46688" alt="Screenshot demonstrating Soap MCP Server is on" width="652" height="277" data-path="images/fifth-step-mcp.png" />
      </Step>

      <Step title="Talk to Soap Documentation straight from Cursor!">
        In Cursor Chat window:

        <img src="https://mintcdn.com/soappaymentsinc/mIoCy_uIYgnWWlj8/images/sixth-step-mcp.png?fit=max&auto=format&n=mIoCy_uIYgnWWlj8&q=85&s=a4bf66941bdc3c24847395bfcb01a7d5" alt="Screenshot demonstrating AI conversation with Soap Documentation in Cursor" width="493" height="672" data-path="images/sixth-step-mcp.png" />
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## Best Practices

To get the best out of the Soap MCP Server when vibe coding our integration, follow these best practices and tips on what language to use:

### DOs

Be very specific in your prompt to do the Soap Integration:

* "Implement the quickstart Soap payments functionality in my app"
* "Create a checkout session for deposits using the Soap API in my React application"
* "Set up Soap customer creation and balance management for my marketplace or digital commerce app"
* "Implement Soap's three checkout types (deposit, purchase, withdrawal) with proper error handling"
* "Add Soap payment processing with webhook handling for transaction status updates"
* "Create a complete Soap integration following the authentication flow with Bearer tokens"

### DONTs

Avoid vague and non-specific instructions:

* "Add the Soap Integration"
* "Use Soap to do my checkout"
* "Make payments work"
* "Connect to Soap"
* "Add payment processing"
* "Set up the API"

### Additional Tips

* **Include your tech stack**: Mention if you're using React, Vue, Node.js, Python, Ruby, etc.
* **Specify the environment**: Clarify if you need sandbox or production setup
* **Mention specific features**: Be clear about which Soap features you need (checkouts, customers, webhooks, etc.)
* **Provide context**: Explain what type of product or payment flow you're building for, such as a marketplace, digital health app, gaming flow, or agentic commerce use case