> ## 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 by using our MCP server.

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

Before you connect, you need an active Fintoc account (test or live) and a supported client: Claude, ChatGPT, Cursor, VS Code, or Claude Code.

## Connect to Fintoc's MCP server

<Tabs>
  <Tab title="Claude">
    Custom connectors work on Claude (web, desktop, mobile, and Cowork) on every plan: Free, Pro, Max, Team, and Enterprise. 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 add it first 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 per conversation via the **"+"** button in chat → **Connectors**.
  </Tab>

  <Tab title="ChatGPT">
    You can enable MCP servers on ChatGPT if you have 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 Cursor <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 on the consent screen and pick the scopes you want to grant to your MCP session. **A token operates in live mode only.**

## Tools

We recommend enabling human confirmation for tools. Use caution when you run the Fintoc MCP 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](/reference/transfers-api/transfers-accounts/transfers-accounts-list)         |
| Account Number   | `list_account_numbers`    | `account_number:view`   | [List account numbers](/reference/transfers-api/account-numbers/account-numbers-list)        |
| Account Number   | `create_account_number`   | `account_number:manage` | [Create an account number](/reference/transfers-api/account-numbers/account-numbers-create)  |
| Bank Account     | `list_movements_accounts` | `movement:view`         | [List a link's accounts](/reference/movements-api/accounts/accounts-list)                    |
| Checkout Session | `list_checkout_sessions`  | `payment:view`          | [List checkout sessions](/reference/payments-api/checkout-sessions/checkout-sessions-list)   |
| Customer         | `list_customers`          | `customer:view`         | [List customers](/reference/payments-api/customers/customers-list)                           |
| Customer         | `create_customer`         | `customer:create`       | [Create a customer](/reference/payments-api/customers/customers-create)                      |
| Entity           | `list_entities`           | `entity:view`           | [List entities](/reference/transfers-api/entities/entities-list)                             |
| Invoice          | `list_invoices`           | `billing:view`          | [List invoices](/reference/payments-api/invoices/invoices-list)                              |
| Invoice          | `get_invoice`             | `billing:view`          | [Get an invoice](/reference/payments-api/invoices/invoices-get)                              |
| Link             | `list_links`              | `link:view`             | [List links](/reference/movements-api/links/links-list)                                      |
| Movement         | `list_movements`          | `movement:view`         | [List movements](/reference/movements-api/movements/movements-list)                          |
| Payment Intent   | `list_payment_intents`    | `payment:view`          | [List payment intents](/reference/payments-api/payment-intents/payment-intents-list)         |
| Payout           | `list_payouts`            | `payout:view`           | [List payouts](/reference/payments-api/payouts/payouts-list)                                 |
| Refund           | `list_refunds`            | `refund:view`           | [List refunds](/reference/payments-api/refunds/refunds-list)                                 |
| Refund           | `create_refund`           | `refund:manage`         | [Create a refund](/reference/payments-api/refunds/refunds-create)                            |
| Refund           | `cancel_refund`           | `refund:manage`         | [Cancel a refund](/reference/payments-api/refunds/refunds-cancel)                            |
| Transfer         | `list_transfers`          | `transfer:view`         | [List transfers](/reference/transfers-api/transfers/transfers-list)                          |
| Webhook Endpoint | `list_webhook_endpoints`  | `webhook_endpoint:view` | [List webhook endpoints](/reference/main-resources/webhook-endpoints/webhook-endpoints-list) |

**Other tools**

* `fetch_resource`: Polymorphic lookup of any Fintoc resource by its id
* `feedback`: Report a blocker or unexpected behavior back 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 if you have 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.

    Fintoc's 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>