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

# Model Context Protocol (MCP)

> Let your AI agents interact with the Fintoc API through our MCP server.

The Fintoc Model Context Protocol (MCP) server provides tools that AI agents can use to interact with the Fintoc API. Agents can also search Fintoc's knowledge base, including the documentation.

Before you connect, you need an active Fintoc account with `live` mode access. You also need a supported client: Claude, ChatGPT, Cursor, VS Code, or Claude Code.

## Connect to Fintoc's MCP server

<Tabs>
  <Tab title="Claude">
    Claude supports custom connectors on the web, desktop, mobile, and Cowork. Custom connectors are available on the Free, Pro, Max, Team, and Enterprise plans. For configuration options, see the Claude <a href="https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp">documentation</a>.

    **Team / Enterprise:**

    1. An Owner must first add the connector in **Organization settings → Connectors** (Add → **Custom → Web**).

    2. Go to **Customize → Connectors**.

    3. Find the Fintoc custom connector your Owner added and click **Connect**.

    **Pro / Max / Free:**

    1. Go to **Customize → Connectors**.

    2. Click **"+"** then **Add custom connector**.

    3. Enter the server URL `https://mcp.fintoc.com`.

    4. Click **Add**, then connect and authenticate via OAuth.

    Enable the connector for each conversation from the **"+"** button in chat → **Connectors**.
  </Tab>

  <Tab title="ChatGPT">
    You can enable MCP servers on ChatGPT with a Pro, Plus, Business, Enterprise, or Education account. Follow the OpenAI <a href="https://platform.openai.com/docs/guides/developer-mode">documentation</a> for instructions. Use the following parameters when setting up your custom connector:

    * The server URL is `https://mcp.fintoc.com`.
    * Use `OAuth` as the connection mechanism.

    Fintoc's MCP server also works with OpenAI's Responses API when you build autonomous agents.
  </Tab>

  <Tab title="Cursor">
    Add the following to your `~/.cursor/mcp.json` file. For configuration options, see the Cursor <a href="https://cursor.com/docs">documentation</a>.

    ```json theme={null}
    {
      "mcpServers": {
        "fintoc": {
          "url": "https://mcp.fintoc.com"
        }
      }
    }
    ```
  </Tab>

  <Tab title="VS Code">
    Add the following to your `~/.vscode/mcp.json`. For configuration options, see the VS Code <a href="https://code.visualstudio.com/docs/copilot/chat/mcp-servers">documentation</a>.

    ```json theme={null}
    {
      "servers": {
        "fintoc": {
          "type": "http",
          "url": "https://mcp.fintoc.com"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Claude Code">
    Run the following command:

    ```bash theme={null}
    claude mcp add --transport http fintoc https://mcp.fintoc.com
    ```
  </Tab>

  <Tab title="Other">
    MCP is an open protocol supported by many clients. See your client's documentation for connection instructions. Use the server URL `https://mcp.fintoc.com` and `OAuth` as the connection mechanism if possible.

    ```json theme={null}
    {
      "fintoc": {
        "url": "https://mcp.fintoc.com"
      }
    }
    ```
  </Tab>
</Tabs>

When the client opens the connection, Fintoc shows a consent screen. Authorize the connection and select the scopes to grant to your MCP session. **A token operates only in `live` mode.**

## Tools

We recommend enabling human confirmation before tools run. Use caution when you run the Fintoc MCP server with other servers to avoid prompt injection attacks. To request more tools or share feedback, email Fintoc's team at [mcp@fintoc.com](mailto:mcp@fintoc.com).

The server exposes the following [MCP tools](https://modelcontextprotocol.io/docs/concepts/tools):

| Resource         | Tool                      | Required permission     | API                                                                                    |
| ---------------- | ------------------------- | :---------------------- | -------------------------------------------------------------------------------------- |
| Account          | `list_accounts`           | `account:view`          | [List accounts](/api/transfers-api/transfers-accounts/transfers-accounts-list)         |
| Account Number   | `list_account_numbers`    | `account_number:view`   | [List account numbers](/api/transfers-api/account-numbers/account-numbers-list)        |
| Account Number   | `create_account_number`   | `account_number:manage` | [Create an account number](/api/transfers-api/account-numbers/account-numbers-create)  |
| Bank Account     | `list_movements_accounts` | `movement:view`         | [List a link's accounts](/api/movements-api/accounts/accounts-list)                    |
| Checkout Session | `list_checkout_sessions`  | `payment:view`          | [List checkout sessions](/api/payments-api/checkout-sessions/checkout-sessions-list)   |
| Customer         | `list_customers`          | `customer:view`         | [List customers](/api/payments-api/customers/customers-list)                           |
| Customer         | `create_customer`         | `customer:create`       | [Create a customer](/api/payments-api/customers/customers-create)                      |
| Entity           | `list_entities`           | `entity:view`           | [List entities](/api/transfers-api/entities/entities-list)                             |
| Invoice          | `list_invoices`           | `billing:view`          | [List invoices](/api/payments-api/invoices/invoices-list)                              |
| Invoice          | `get_invoice`             | `billing:view`          | [Get an invoice](/api/payments-api/invoices/invoices-get)                              |
| Link             | `list_links`              | `link:view`             | [List links](/api/movements-api/links/links-list)                                      |
| Movement         | `list_movements`          | `movement:view`         | [List movements](/api/movements-api/movements/movements-list)                          |
| Payment Intent   | `list_payment_intents`    | `payment:view`          | [List payment intents](/api/payments-api/payment-intents/payment-intents-list)         |
| Payout           | `list_payouts`            | `payout:view`           | [List payouts](/api/payments-api/payouts/payouts-list)                                 |
| Refund           | `list_refunds`            | `refund:view`           | [List refunds](/api/payments-api/refunds/refunds-list)                                 |
| Refund           | `create_refund`           | `refund:manage`         | [Create a refund](/api/payments-api/refunds/refunds-create)                            |
| Refund           | `cancel_refund`           | `refund:manage`         | [Cancel a refund](/api/payments-api/refunds/refunds-cancel)                            |
| Transfer         | `list_transfers`          | `transfer:view`         | [List transfers](/api/transfers-api/transfers/transfers-list)                          |
| Webhook Endpoint | `list_webhook_endpoints`  | `webhook_endpoint:view` | [List webhook endpoints](/api/main-resources/webhook-endpoints/webhook-endpoints-list) |

**Other tools**

* `fetch_resource`: Looks up any Fintoc resource by its `id`.
* `feedback`: Reports a blocker or unexpected behavior to the Fintoc team.

## Connect to the Fintoc Docs MCP server

The docs server lets an agent answer questions about the Fintoc API by querying the documentation. Use it when you want code samples, endpoint lookups, or explanations without leaving your editor.

<Tabs>
  <Tab title="Cursor">
    Add the following to your `~/.cursor/mcp.json` file. For configuration options, see the Cursor <a href="https://cursor.com/docs">documentation</a>.

    ```json theme={null}
    {
      "mcpServers": {
        "fintoc-docs": {
          "url": "https://docs.fintoc.com/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="VS Code">
    Add the following to your `~/.vscode/mcp.json`. For configuration options, see the VS Code <a href="https://code.visualstudio.com/docs/copilot/chat/mcp-servers">documentation</a>.

    ```json theme={null}
    {
      "servers": {
        "fintoc-docs": {
          "type": "http",
          "url": "https://docs.fintoc.com/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Claude Code">
    Run the following command:

    ```bash theme={null}
    claude mcp add --transport http fintoc-docs https://docs.fintoc.com/mcp
    ```
  </Tab>

  <Tab title="ChatGPT">
    You can enable MCP servers on ChatGPT with a Pro, Plus, Business, Enterprise, or Education account. Follow the OpenAI <a href="https://platform.openai.com/docs/guides/developer-mode">documentation</a> for instructions. Use the following parameters when setting up your custom connector:

    * The server URL is `https://docs.fintoc.com/mcp`.
    * Use `OAuth` as the connection mechanism.

    The Fintoc Docs MCP server also works with OpenAI's Responses API when you build autonomous agents.
  </Tab>

  <Tab title="Other">
    MCP is an open protocol supported by many clients. See your client's documentation for connection instructions. Use the server URL `https://docs.fintoc.com/mcp`.

    ```json theme={null}
    {
      "fintoc-docs": {
        "url": "https://docs.fintoc.com/mcp"
      }
    }
    ```
  </Tab>
</Tabs>