How to Use the Freshcaller MCP in Cursor

Inject real-time call center data into your codebase using Cursor and the Freshcaller MCP server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Freshcaller MCP to Cursor

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate routing logic in Cursor

Feed live agent status into your code using `list_agents` and `get_team_details`. Your agent writes logic based on the actual current state of your phone system. Stop guessing how to structure your routing functions. The data comes back as live JSON, letting you build adaptive systems that actually work.

Integrate call metadata directly

Access specific call logs using `list_calls` and `get_call_details` during your coding session. You can write scripts that process these records immediately. Cursor uses these tools to understand your telecom environment. You get working code that interacts with real API responses, not placeholders.

Manage phone resources programmatically

Query your available phone lines with `list_buyable_numbers` and `list_my_numbers`. These tools return the exact data you need to populate your configuration files. Your agent handles the API calls while you stay in the editor. It turns manual inventory checks into a simple prompt.

Setup guide

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

.cursor/mcp.json

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

Create a .cursor/mcp.json file in your project root. Paste the server configuration there, enable Agent mode in your chat window, and you are ready to query the API.

Yes. By placing the configuration in your project root, every developer on your team gets access to the same tools. It keeps the environment consistent for everyone.

Absolutely. You can use the tools to verify your API calls in real-time. If a script fails, ask your agent to fetch the latest call details to see what happened.

The server manages requests efficiently. If you hit a rate limit, it reports the error back so you can adjust your polling interval accordingly.

Your recording links and call metadata are never stored by the editor. The server acts as a transient bridge, only passing the data you request directly into your current context.

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