Model Context Protocol (MCP)

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: Cursor, VS Code, Claude Code, or ChatGPT.

Connect to Fintoc's MCP server

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 documentation.

Team / Enterprise:

An Owner must add it first in Organization settings → Connectors (Add → Custom → Web).
Go to Customize → Connectors.
Find the Fintoc custom connector added by your the Owner 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 per conversation via the "+" button in chat → Connectors.

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

The server exposes the following MCP tools. We recommend enabling human confirmation of tools and exercising caution when using the Fintoc MCP with other servers to avoid prompt injection attacks. If you have feedback or want to see more tools, email Fintoc's team at [email protected].

Resource	Tool	Required permission	API
Account	`list_accounts`	`account:view`	List accounts
Account Number	`list_account_numbers`	`account_number:view`	List account numbers
Account Number	`create_account_number`	`account_number:manage`	Create account number
Checkout Session	`list_checkout_sessions`	`payment:view`	List checkout sessions
Customer	`list_customers`	`customer:view`	List customers
Customer	`create_customer`	`customer:create`	Create customer
Entity	`list_entities`	`entity:view`	List entities
Invoice	`list_invoices`	`billing:view`	List invoices
Link	`list_links`	`link:view`	List links
Payment Intent	`list_payment_intents`	`payment:view`	List payment intents
Payout	`list_payouts`	`payout:view`	List payouts
Refund	`list_refunds`	`refund:view`	List refunds
Refund	`create_refund`	`refund:manage`	Create refund
Refund	`cancel_refund`	`refund:manage`	Cancel refund
Transfer	`list_transfers`	`transfer:view`	List transfers
Webhook Endpoint	`list_webhook_endpoints`	`webhook_endpoint:view`	List webhook endpoints

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.

Add the following to your \~/.cursor/mcp.json file. To learn more, see the Cursor documentation.

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