How to Use the PHC GO MCP in Cursor

Q: How do I add the PHC GO MCP Server to my Cursor project?

Create a .cursor/mcp.json file in your repository root and add the server configuration. Once saved, the editor automatically loads the 16 ERP tools for use in Agent mode.

Q: How do I test stock level updates with PHC GO in Cursor?

You can run liststocks through the Cursor chat to pull current inventory movements into your workspace. The agent uses this real-time data to verify that your stock-tracking logic matches physical warehouse counts.

Q: Can the PHC GO MCP Server in Cursor update customer profiles?

Yes, the agent can write new records using createcustomer or look up existing profiles with getcustomerdetails. This allows you to quickly verify that your application's profile updates sync correctly with the ERP.

Generate valid PHC GO FT invoices and sync Portuguese NIF tax data directly inside your Cursor editor codebase.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect PHC GO MCP to Cursor

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Populate code templates with real PHC GO ERP data

The `get_product_details` tool fetches actual item specifications, pricing structures, and VAT rates from PHC GO directly into your Cursor editor. Instead of writing mock JSON objects for your e-commerce tests, the agent runs this tool to insert production-grade ERP payloads. This active data injection prevents integration bugs before you commit code. Cursor uses the live data to build accurate TypeScript interfaces that perfectly match your PHC GO database schema.

Test billing flows with Cursor MCP Server

The `create_document` tool lets your Cursor editor's agent mode generate test invoices, quotes, and delivery notes on your sandbox ERP. The agent calls `list_series` to check valid document sequences and writes the records without leaving the terminal. Having this MCP Server active in your editor speeds up API integration testing. You can verify how your code handles tax calculations by letting the agent inspect output from `list_taxes` in real time.

Verify customer sync logic in Cursor

The `search_customers` tool queries your ERP database to verify if a user exists with a specific NIF before your local Cursor code tries to write a duplicate record. The agent checks the response and uses `get_customer_details` to inspect the exact field structure. If a record is missing, the agent runs `create_customer` to populate the test environment. This tight feedback loop ensures your sync scripts handle edge cases like missing tax identification numbers.

Setup guide

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

.cursor/mcp.json

{
  "mcpServers": {
    "phc-go-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 PHC GO. 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 PHC GO 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 PHC GO MCP in Cursor

Create a `.cursor/mcp.json` file in your repository root and add the server configuration. Once saved, the editor automatically loads the 16 ERP tools for use in Agent mode.

Yes, you can debug billing scripts by asking the Cursor agent to run `get_document_details` on a recently created record. This lets you inspect the raw JSON structure of the invoice lines directly in your editor.

You can run `list_stocks` through the Cursor chat to pull current inventory movements into your workspace. The agent uses this real-time data to verify that your stock-tracking logic matches physical warehouse counts.

Yes, the agent can write new records using `create_customer` or look up existing profiles with `get_customer_details`. This allows you to quickly verify that your application's profile updates sync correctly with the ERP.

Your financial ledger, customer records, and stock movements are protected because Cursor routes queries through local stdio or encrypted HTTPS. Credentials are encrypted on your local machine and never exposed to external LLM training pools.

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