How to Use the Thoughtly MCP in Cursor

Give Cursor access to the Thoughtly MCP Server so you can write code against live voice call data and real CRM contacts.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Thoughtly MCP to Cursor

Create your Vinkius account to connect Thoughtly to Cursor — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Thoughtly with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Trigger AI Calls from the Editor

Cursor Agent fires off outbound voice calls mid-coding by executing `trigger_call` with live parameters. This lets you test telephony webhooks or verify dynamic routing logic without leaving your IDE. You can also inspect the exact configuration of your voice bots. The AI client pulls your available agent list via `list_interviews` and extracts the specific prompt instructions for a single agent using `get_interview`.

Thoughtly MCP Server Transcript Access

Debugging voice applications requires real interaction data, which you get by asking Cursor to run `list_calls` to populate your editor with recent call logs. The agent reads the JSON response and formats it into your test files. For deep inspection of a failed interaction, `get_call_history` fetches the exact transcript and metadata. You can also validate your API environment by checking the active profile with `get_user`.

Live Contact Data Injection

Building a dashboard means you need real user profiles, so Cursor executes `list_contacts` to dump your actual CRM records into your local environment. If you need to test user creation, the agent runs `create_contact` with mock data. Modifying those records happens instantly when your AI client pushes a payload through `update_contact`. You can fetch a single updated profile via `get_contact` to assert your code works, then clean up the test suite by running `delete_contact`.

Setup guide

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

.cursor/mcp.json

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

Create an mcp.json file in your project root or global .cursor directory. Define the Thoughtly server command and arguments, then enable Agent mode.

Yes. The agent pulls live transcript data and generates assertion blocks based on actual API responses rather than guessing the schema.

Define them as environment variables within the mcp.json configuration block. Never hardcode your telephony keys directly into your workspace files.

You need to explicitly ask the agent to fetch them. The MCP connection is active, but the AI client won't pull CRM records until you prompt it.

Your workspace handles raw phone numbers, email addresses, and spoken transcripts. The local execution model ensures this sensitive telephony data only flows between the provider and your local editor process, never touching third-party telemetry.

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