# Use the Payabli MCP server

> Learn how to use the Payabli MCP server to integrate with AI workflows

<AudienceInfo audiences={['developers']} />

The Payabli MCP (Model Context Protocol) server connects your AI agents to Payabli's documentation and SDK references.
Set up the Payabli MCP server in your IDE or AI chat to get help with your Payabli integration.

<Note>
  For more information about the Model Context Protocol, visit the [MCP docs](https://modelcontextprotocol.io/introduction).
</Note>

If your AI agent supports MCP, you can set up the Payabli MCP Server to give your AI agent knowledge about Payabli's APIs and SDK.
The Payabli MCP server lets you:

* Get instant answers to questions about Payabli APIs, features, and implementation
* Search documentation without leaving your development environment
* Find code examples and best practices for common use cases
* Troubleshoot issues with guidance from our documentation and SDK references
* Write code that integrates your application with Payabli

## Installation

To configure the Payabli MCP server, select your IDE or AI chat provider and follow the instructions.

<AccordionGroup>
  <Accordion title="Cursor">
    1. Open **Cursor** and open the `.cursor` directory in your project root. If it doesn't exist, create it. This directory contains Cursor's configuration files for your project.

    2. Open the `mcp.json` file in the `.cursor` directory. If it doesn't exist, create it. This file contains all MCP server configurations for your project.

    3. Add the following configuration to your `mcp.json` file:

       ```json mcp.json
       {
         "mcpServers": {
           "inkeepMcp": {
             "url": "https://mcp.inkeep.com/payabli/mcp"
           }
         }
       }
       ```

    4. Save the configuration file.

    5. Restart Cursor.
  </Accordion>

  <Accordion title="Windsurf">
    <Note>
      Windsurf uses `npm` to access the Payabli MCP server. You must have **Node.js** installed on your system. See [Node.js installation instructions](https://nodejs.org/en/download/) for more information.
    </Note>

    1. Open **Windsurf**.

    2. Navigate to the *Cascade assistant* sidebar.

    3. Click the **hammer (MCP)** icon to access MCP settings.

    4. Click **Configure > View raw config**.

    5. Open the configuration file `~/.codeium/windsurf/mcp_config.json`. This file contains Windsurf's global configuration for MCP servers.

    6. Add the following configuration to your `mcp_config.json` file:

       ```json mcp_config.json
       {
         "mcpServers": {
           "payabli": {
               "server_url": "https://mcp.inkeep.com/payabli/mcp",
           }
         }
       }
       ```

    7. Save the configuration file.

    8. Click the **Refresh** button in the *Cascade sidebar* next to "available MCP servers".
  </Accordion>

  <Accordion title="Claude Desktop (Local)">
    <Note>
      Claude Desktop uses `npm` to access the Payabli MCP server. You must have **Node.js** installed on your system. See [Node.js installation instructions](https://nodejs.org/en/download/) for more information.
    </Note>

    1. Open **Claude Desktop**.

    2. Navigate to **File > Settings** on Windows or **Settings** on MacOS.

    3. Navigate to the **Developer** tab.

    4. Click **Edit Config**.

    5. Open the configuration file `claude_desktop_config.json`. This file manages all MCP servers for Claude Desktop.

    6. Add the following configuration to your `claude_desktop_config.json` file:

       ```json claude_desktop_config.json
       {
         "mcpServers": {
           "payabli": {
             "command": "npx",
             "args": ["-y", "mcp-remote", "https://mcp.inkeep.com/payabli/mcp"]
           }
         }
       }
       ```

    7. Save the configuration file.

    8. Restart Claude Desktop.
  </Accordion>

  <Accordion title="Claude Desktop (Remote)">
    <Note>
      Claude Desktop's remote MCP functionality is currently in beta.
    </Note>

    ### Enterprise and team plans

    1. Open **Claude Desktop**.

    2. Navigate to **Admin settings > Connectors**.

    3. Navigate to the bottom of the section.

    4. Click **Add custom connector**.

    5. Fill in the fields as follows:

       * **Name**: Payabli MCP
       * **Remote MCP server URL**: `https://mcp.inkeep.com/payabli/mcp`

    6. Click the **Add** button.

    ### Pro and max plans

    1. Open **Claude Desktop**.

    2. Navigate to **Settings > Connectors**.

    3. Navigate to the bottom of the section.

    4. Click **Add custom connector**.

    5. Fill in the fields as follows:

       * **Name**: Payabli MCP
       * **Remote MCP server URL**: `https://mcp.inkeep.com/payabli/mcp`

    6. Click the **Add** button.
  </Accordion>
</AccordionGroup>

## Usage

The Payabli MCP provides the following tools:

* **`search-payabli-docs`** - Searches Payabli's official documentation
* **`ask-question-about-payabli`** - Searches Payabli's SDK GitHub repository and other resources outside of the documentation

Your AI agent automatically selects the appropriate tool based on your question.