How to Use the Clientjoy MCP in Cursor

Q: How do I add the Clientjoy MCP Server to Cursor for my project?

It's simple. Create a .cursor/mcp.json file in your project's root directory and add the server URL provided by Vinkius. That's it. The tools will show up in Agent mode.

Build scripts that use real customer data from Clientjoy, without leaving the Cursor editor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Clientjoy MCP to Cursor

Create your Vinkius account to connect Clientjoy 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 Clientjoy with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build with Clientjoy Data in Cursor

Stop mocking API responses from your CRM. With this MCP Server, Cursor's agent can call your Clientjoy account directly. Ask it to fetch a contact with `get_contact_crm_details` and it will inject the actual JSON response into your code. This changes how you build internal tools. You can write a script to analyze leads by having the agent call `list_clientjoy_leads`, then work with the real data structure right there in your editor. No more guessing what the API will return.

Automate Scripts for Sales and Projects

Use Cursor's agent to write scripts that interact with your business data. For example, tell it: "Write a Python script that finds all unpaid invoices from Clientjoy and prints their total." The agent will use `list_agency_invoices` to get the data and generate the code for you. The same works for project management. You can have the agent use `list_agency_projects` to get a list of all active projects and then write code to format a status report. You're not just getting answers; you're building tools.

Prototype Faster with Real Lead Info

When you're building a new feature that depends on lead data, you need realistic inputs. Just ask the Cursor agent to "get me the details for the 'NewCo' lead." It'll use `get_lead_crm_details` and drop the full object into your code. This makes prototyping incredibly fast. You can build and test functions using live data from your sales pipeline, catching issues with data formats or missing fields long before you deploy. It’s a direct connection between your editor and your Clientjoy CRM.

Setup guide

Set up Clientjoy 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 Clientjoy 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 Clientjoy transactions." If the MCP tools are loaded correctly, Cursor will call the Clientjoy tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "clientjoy-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 Clientjoy. 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 Clientjoy 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 Clientjoy MCP in Cursor

In Agent mode, you ask Cursor to get lead data. It calls the `list_clientjoy_leads` or `get_lead_crm_details` tools from the Clientjoy MCP Server and injects the live API response into your code.

No, these tools are read-only. They are designed to pull data like contacts, projects, and invoices from Clientjoy into your development environment safely.

It's simple. Create a `.cursor/mcp.json` file in your project's root directory and add the server URL provided by Vinkius. That's it. The tools will show up in Agent mode.

Cursor's agent can use the Clientjoy tools to inject live data directly into the code it's writing. You're not just viewing data, you're building with it.

The Vinkius MCP server only has read access to your Clientjoy account data, like lead info and contact details. Vinkius manages the authentication token, and each connection is processed in an isolated, ephemeral sandbox that is destroyed after use.

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