How to Use the Fieldly MCP in Cursor

Q: How do I add the Fieldly MCP Server to Cursor?

Create a .cursor/mcp.json file in your project root. Add the server configuration with your Vinkius endpoint token, and Cursor will immediately load the 11 tools into your Agent panel.

Q: How do I list all my active customers in the editor?

Ask the agent to find them. It calls listcustomers and displays the names, addresses, and IDs directly in your sidebar or terminal window.

Write code that interacts with real Fieldly construction data using Cursor's AI agent.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Fieldly MCP to Cursor

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build with Real Construction API Responses

The `get_work_item` tool gives Cursor direct access to live job data while you write your integration code. Your agent pulls real payloads instead of using fake mock objects, making your local testing accurate. This eliminates the guesswork when writing custom field service scripts. You see exactly how Fieldly structures its JSON, so you can write clean code that works on the first run.

Test Billing Logic with Live Invoices

The `list_invoices` tool lets your Cursor agent pull active billing records to test your financial calculations. It uses `get_invoice` to inspect tax rates, line items, and payment statuses directly in your editor. You can write a script to flag overdue accounts and have Cursor verify it against real data. It checks your logic against actual ERP numbers without needing manual API exports.

Manage Fieldly MCP Server Configurations

The `get_me` tool verifies your API credentials and user permissions inside the Cursor environment. This MCP Server integration lets your editor check its own connection state before executing write operations like `create_work_item`. This keeps your development environment secure. You won't accidentally run commands against the wrong client account because the agent checks who is logged in first.

Setup guide

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

.cursor/mcp.json

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

Create a `.cursor/mcp.json` file in your project root. Add the server configuration with your Vinkius endpoint token, and Cursor will immediately load the 11 tools into your Agent panel.

Yes, if you authorize it, Cursor can run write actions. It uses `create_work_item` to add new tasks to your active queue based on the code or notes you provide.

Yes, when you ask Cursor's Agent to write code, it uses the live tool definitions to autocomplete parameters for functions involving bookings or invoices.

Ask the agent to find them. It calls `list_customers` and displays the names, addresses, and IDs directly in your sidebar or terminal window.

Yes. All data transport between your editor and Fieldly is encrypted. Your financial records, customer profiles, and invoice details are never cached by Vinkius or used to train public AI models.

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