How to Use the MotionTools MCP in Cursor

Q: How do I configure the MotionTools MCP in Cursor?

Create an mcp.json file in your project root directory. Add the server configuration under the mcpServers key. Toggle Agent mode on in your chat panel to start calling the tools.

Q: Can Cursor write routing logic using MotionTools data?

Yes. The editor uses getservicearea and listbookings to understand your current dispatch state. It then writes functions that map perfectly to your actual operational rules.

Q: How do I test the booking creation flow?

Instruct the agent to trigger createbooking with test parameters. You can verify the payload structure and response handling before you commit the integration code.

Build custom logistics tools in Cursor by injecting live dispatch data straight into your codebase.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect MotionTools MCP to Cursor

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Test Logistics Code with Real Data

MotionTools allows Cursor to call `list_bookings` and `get_booking` while you write routing logic. Cursor pulls actual delivery payloads from your production or staging environment instead of relying on hardcoded mock objects. You see exactly how your application handles edge cases based on real-world data structures. Building internal dashboards feels entirely different with an MCP Server. When you need a component to display active orders, the agent fetches the exact JSON schema directly from the API. Your code works on the first run because it was built against the actual response format.

Automate Fleet Management Scripts

MotionTools exposes `list_vehicles` and `list_drivers` so you can generate fleet maintenance scripts instantly. You tell Cursor what you want to build, and it queries the live database to write logic that fits your specific asset types. The AI understands your operational constraints because it reads them directly. If you need a script to audit driver assignments, the editor uses `get_driver` and `get_vehicle` to map the relationships. You spend less time reading API documentation and more time compiling functional automation.

MotionTools MCP Server Integration

Setting up MotionTools means your agent can verify geographic boundaries using `list_service_areas` and `get_service_area`. When you write validation logic for a checkout flow, the editor checks the active zones to ensure the code rejects out-of-bounds addresses. You stop guessing what regions are currently active. Customer management logic benefits from the `list_customers` tool. Cursor can scaffold entire user management portals by inspecting how your current accounts are structured in the backend. You get working administrative interfaces in minutes.

Setup guide

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

.cursor/mcp.json

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

Create an `mcp.json` file in your project root directory. Add the server configuration under the `mcpServers` key. Toggle Agent mode on in your chat panel to start calling the tools.

Yes. The editor uses `get_service_area` and `list_bookings` to understand your current dispatch state. It then writes functions that map perfectly to your actual operational rules.

The MCP architecture means the tools always fetch the current schema. If an endpoint updates, your agent sees the new response format immediately and adjusts your code to match.

Instruct the agent to trigger `create_booking` with test parameters. You can verify the payload structure and response handling before you commit the integration code.

Your credentials never leave your local environment. The Vinkius zero-trust architecture ensures that driver locations and vehicle assignments process through a strict, short-lived sandbox that destroys the context after every single call.

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