How to Use the Checkfront MCP in Cursor

Q: How can I use Cursor to write a function that gets all Checkfront bookings for next week?

In Cursor's chat, prompt the agent: "Using the Checkfront listbookings tool, get all bookings for next week and write a JavaScript function to display them." The agent will call the tool and generate the code for you.

Q: Can I get a list of all available items from my Checkfront store inside Cursor?

Yes. Just ask the agent to use the listitems tool. It will return a list of your bookable items, which you can then use as context for writing more code.

Q: Is it possible to find a Checkfront customer by email and then get their booking history with Cursor?

Absolutely. First, tell the agent to use searchcustomers with the customer's email. Once you have the customer ID from the results, instruct the agent to use listbookings, filtering by that ID.

Pull live Checkfront data directly into your code with Cursor. Build apps with real booking and customer information, not stubs.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Checkfront MCP to Cursor

Create your Vinkius account to connect Checkfront to Cursor and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Checkfront with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Code Against Your Live Checkfront API

Stop mocking API calls. With this MCP Server, Cursor's agent can use `list_bookings` or `get_item` to fetch real data from your Checkfront account. Then it will write the code to handle that exact data structure. You can tell the agent, "Fetch the details for item #XYZ and write a TypeScript interface for it." The agent calls `get_item`, sees the real response, and generates a perfectly typed interface. This kills bugs before they're even written.

Script Customer Data Workflows

Need to write a script that processes customer data? The `search_customers` tool gives the agent access to contact info, booking history, and total spend. You can ask it to find a customer, then write a Python script to format their data for another system. This is way faster than exporting a CSV and writing a parser from scratch. Your MCP Server gives the agent the live data structure so it can write the code for you, directly in the editor, without the guesswork.

Test Booking Logic with Your Cursor MCP Server

When you're building a new booking interface, you need to test how it handles availability. Use the `check_availability` tool to have the agent query your live Checkfront data. You can test edge cases for different items and dates instantly. For example, tell the agent: "Check availability for the 'City Tour' on July 4th and generate a Jest test that asserts the API response." It will call the tool and write a test file with the real expected output, all without you leaving Cursor.

Setup guide

Set up Checkfront MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Checkfront MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Checkfront transactions." If the MCP tools are loaded correctly, Cursor will call the Checkfront tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "checkfront-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Checkfront. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Checkfront now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Checkfront MCP in Cursor

In Cursor's chat, prompt the agent: "Using the Checkfront `list_bookings` tool, get all bookings for next week and write a JavaScript function to display them." The agent will call the tool and generate the code for you.

Yes. Just ask the agent to use the `list_items` tool. It will return a list of your bookable items, which you can then use as context for writing more code.

Absolutely. First, tell the agent to use `search_customers` with the customer's email. Once you have the customer ID from the results, instruct the agent to use `list_bookings`, filtering by that ID.

No, the tools are read-only. You can use it to fetch data like bookings, items, and customers with tools like `get_booking`, but it does not support creating or modifying any data in Checkfront.

Vinkius manages the connection and authentication tokens, which are never visible to you or the agent. The server runs in an isolated sandbox and is configured with read-only permissions for your Checkfront booking and customer data. No write operations are possible.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript