How to Use the Avaza MCP in Cursor

Q: Is Cursor capable of creating a new Avaza project automatically?

Yes, the Cursor agent can call createproject to build a new Avaza project when you start a new repository. Cursor handles the initial Avaza setup based on your prompt instructions.

Q: Will the Cursor agent read my Avaza financial invoices?

Only if you ask it to, as the listinvoices tool can retrieve Avaza billing documents inside Cursor. The MCP integration will not access your Avaza invoices unless you explicitly prompt Cursor to do so.

Build software and log your development hours to Avaza without ever leaving the Cursor agent chat.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Avaza MCP to Cursor

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Ship code and track Avaza hours in Cursor

Execute `create_timesheet` directly from your Cursor editor when you finish a coding session to log hours in Avaza. By running `list_timesheets` inside Cursor, you can make sure your day's Avaza work is fully documented.

Map Cursor codebase tasks to Avaza tickets

Use `list_tasks` to pull your active Avaza tickets straight into your Cursor workspace. If you hit a blocker while coding in Cursor, update the Avaza ticket status instantly using `update_task`.

Context-aware project management with Cursor

Run `list_projects` to let your Cursor editor see which Avaza client environments are active. After that, you can use `get_project` inside Cursor to fetch specific Avaza milestones before writing code.

Setup guide

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

.cursor/mcp.json

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

Add the Avaza MCP server configuration to your global or project-specific `mcp.json` file inside Cursor. Once saved, enable Agent mode in the Cursor chat panel to let the editor invoke the Avaza tools.

Yes, the Cursor agent can call `create_project` to build a new Avaza project when you start a new repository. Cursor handles the initial Avaza setup based on your prompt instructions.

It connects Cursor to the specific Avaza account you authenticate during setup. Running `get_account_check` inside Cursor lets you verify which Avaza workspace your editor is currently modifying.

Only if you ask it to, as the `list_invoices` tool can retrieve Avaza billing documents inside Cursor. The MCP integration will not access your Avaza invoices unless you explicitly prompt Cursor to do so.

All Avaza API calls made by Cursor route through a zero-trust, ephemeral sandbox. Processing your Avaza task details and project names in memory ensures they are never cached or stored long-term by Cursor.

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