Model Context Protocol (MCP)

Connect AI editors such as Cursor, Claude Desktop, and VS Code to Felloh using MCP for seamless access to your bookings, transactions, payments, and more.

The Felloh MCP server enables AI agents to interact with the Felloh API directly, giving your AI assistant the ability to manage bookings, process refunds, create payment links, and search our documentation — all without leaving your editor.

Connect to the Felloh MCP server

Connect to the hosted Felloh MCP server at https://mcp.api.felloh.com. You'll need your Felloh API public and private keys, which you can generate from the Felloh Dashboard.

Install in Cursor

Alternatively, add the following to your ~/.cursor/mcp.json file:

~/.cursor/mcp.json

{
  "mcpServers": {
    "felloh": {
      "url": "https://mcp.api.felloh.com/",
      "headers": {
        "x-felloh-public-key": "your-public-key",
        "x-felloh-private-key": "your-private-key"
      }
    }
  }
}

Authentication

The Felloh MCP server authenticates using your API key pair. Pass your public and private keys as HTTP headers — the server handles token generation and caching automatically.

Your API keys are sent with each request. Always use HTTPS and never expose your private key in client-side code or public repositories.

You can generate API keys from the Felloh Dashboard. For more details on authentication, see the Authentication guide.

Available tools

The Felloh MCP server exposes the following tools, organised by resource.

Bookings

Tool	Description
`list-bookings`	Fetch bookings with pagination, search, and date filtering
`get-booking`	Fetch a single booking by ID
`create-booking`	Create a new booking
`update-booking`	Update an existing booking
`delete-booking`	Delete a booking
`update-booking-reference`	Update a booking reference

Transactions

Tool	Description
`list-transactions`	Fetch transactions with pagination and date filtering
`get-transaction`	Fetch a single transaction by ID
`refund-transaction`	Generate a refund for a transaction
`complete-transaction`	Complete a pre-authorised transaction
`reverse-transaction`	Reverse a pre-authorised transaction
`reassign-transaction`	Reassign a transaction to a different booking

Payment links

Tool	Description
`list-payment-links`	Fetch payment links with pagination
`get-payment-link`	Fetch a single payment link by ID
`create-payment-link`	Create a payment link with optional redirect URLs
`delete-payment-link`	Delete a payment link
`assign-payment-link`	Assign a payment link to a booking

Ecommerce

Tool	Description
`list-ecommerce`	Fetch ecommerce sessions with pagination
`get-ecommerce`	Fetch a single ecommerce session by ID
`create-ecommerce`	Create an ecommerce session with payment options
`delete-ecommerce`	Delete an ecommerce session
`assign-ecommerce`	Assign an ecommerce session to a booking

Customers

Tool	Description
`list-customers`	Fetch customers with pagination and keyword search
`create-customer`	Create a new customer with optional address

Suppliers

Tool	Description
`list-suppliers`	Fetch suppliers with pagination
`create-supplier`	Create a new supplier

Refunds

Tool	Description
`list-refunds`	Fetch refunds with pagination and date filtering
`authorise-refund`	Authorise a pending refund
`decline-refund`	Decline a pending refund

Chargebacks

Tool	Description
`list-chargebacks`	Fetch chargebacks with date filtering

Charges

Tool	Description
`list-charges`	Fetch charges from merchant acquirers

Organisations

Tool	Description
`list-organisations`	Fetch all accessible organisations

Scheduled payments

Tool	Description
`list-scheduled-payments`	Fetch scheduled payments with pagination
`get-available-tokens`	Get tokenised cards available on a booking
`create-scheduled-payment`	Create a payment using a tokenised card
`cancel-scheduled-payment`	Cancel a scheduled payment
`generate-approval-link`	Generate an approval link for a booking payment

Credit notes

Tool	Description
`list-credit-notes`	Fetch credit notes with pagination
`get-credit-note`	Fetch a single credit note by ID

Disbursements

Tool	Description
`list-disbursements`	Fetch disbursements with pagination
`get-disbursement`	Fetch a single disbursement by ID

Beneficiaries

Tool	Description
`list-beneficiaries`	Fetch beneficiaries with pagination
`create-beneficiary`	Create a beneficiary for disbursements
`activate-beneficiary`	Activate a beneficiary

Ledger

Tool	Description
`list-ledger-entries`	Fetch ledger entries with date filtering

Documentation

Tool	Description
`search-docs`	Search Felloh API documentation