Model Context Protocol (MCP)

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

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 documentation.Team / Enterprise:

An Owner must first add the connector in Organization settings → Connectors (Add → Custom → Web).
Go to Customize → Connectors.
Find the Fintoc custom connector your Owner added and click Connect.

Pro / Max / Free:

Go to Customize → Connectors.
Click ”+” then Add custom connector.
Enter the server URL https://mcp.fintoc.com.
Click Add, then connect and authenticate via OAuth.

Enable the connector for each conversation from the ”+” button in chat → Connectors.

You can enable MCP servers on ChatGPT with a Pro, Plus, Business, Enterprise, or Education account. Follow the OpenAI documentation 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.

Add the following to your ~/.cursor/mcp.json file. For configuration options, see the Cursor documentation.

{
  "mcpServers": {
    "fintoc": {
      "url": "https://mcp.fintoc.com"
    }
  }
}

Add the following to your ~/.vscode/mcp.json. For configuration options, see the VS Code documentation.

{
  "servers": {
    "fintoc": {
      "type": "http",
      "url": "https://mcp.fintoc.com"
    }
  }
}

Run the following command:

claude mcp add --transport http fintoc https://mcp.fintoc.com

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.

{
  "fintoc": {
    "url": "https://mcp.fintoc.com"
  }
}

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. The server exposes the following MCP tools:

Category	Tool	Description
Operations	`fintoc_tool_search`	Search the operations available through Fintoc MCP.
Operations	`fintoc_tool_details`	Get the parameters and permissions for an operation.
Operations	`fintoc_tool_read`	Read data from Fintoc.
Operations	`fintoc_tool_write`	Write data in Fintoc. Some operations can move money.
Resources	`fetch_resource`	Retrieve a Fintoc resource by its `id`.
Other	`submit_feedback`	Report blockers or unexpected behavior to Fintoc.

The operation tools make supported Fintoc actions available through MCP without exposing one tool per action. This keeps the tool set compact as Fintoc adds more capabilities.

Supported operations

The Fintoc MCP server currently supports:

Payments: list and create customers; list payment intents, checkout sessions, and payment methods; list, create, and cancel refunds
Billing: list, create, finalize, and void invoices; list, create, and update subscriptions
Movements: list links, linked bank accounts, and movements
Payouts: list payouts and payout resources
Business Accounts: list accounts, account statements, entities, account numbers, and transfers; create account numbers
Webhooks: list webhook endpoints

The operations available in a session depend on your Fintoc products and the scopes granted during authorization. Actions the server does not expose Some actions have no tool on purpose, so an agent cannot take them on your behalf:

Paying an invoice. Use Pay an invoice.
Canceling a subscription. Use Cancel a subscription.
Detaching the payment method of a subscription. Use Detach the payment method from a subscription.

Refunds are the exception. A refund returns money to the customer who paid, and you can cancel it while it is still pending.

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.

Cursor
VS Code
Claude Code
ChatGPT
Other

Add the following to your ~/.cursor/mcp.json file. For configuration options, see the Cursor documentation.

{
  "mcpServers": {
    "fintoc-docs": {
      "url": "https://docs.fintoc.com/mcp"
    }
  }
}

Add the following to your ~/.vscode/mcp.json. For configuration options, see the VS Code documentation.

{
  "servers": {
    "fintoc-docs": {
      "type": "http",
      "url": "https://docs.fintoc.com/mcp"
    }
  }
}

Run the following command:

claude mcp add --transport http fintoc-docs https://docs.fintoc.com/mcp

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.

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.

{
  "fintoc-docs": {
    "url": "https://docs.fintoc.com/mcp"
  }
}

​Connect to Fintoc’s MCP server

​Tools

​Supported operations

​Connect to the Fintoc Docs MCP server

Connect to Fintoc’s MCP server

Tools

Supported operations

Connect to the Fintoc Docs MCP server