castaldo-solutions avatar

VTENext CRM

castaldo-solutions/mcp-vtenext

VTENext CRM tools for Claude and MCP clients: opportunities, contacts, notes, VTQL queries.

GitHub stars
4
tools
10
auth
Secret needed
transport
STDIO
env vars
4
last updated
Nov 17, 2026

Tools

10 tools

Public tool metadata for what this MCP can expose to an agent.

list_opportunitaList opportunities with optional filters (status, search, limit)

List opportunities with optional filters (status, search, limit)

No parameter schema in public metadata yet.

get_opportunitaGet full details of an opportunity by ID

Get full details of an opportunity by ID

No parameter schema in public metadata yet.

search_opportunitaSearch opportunities by name

Search opportunities by name

No parameter schema in public metadata yet.

create_opportunitaCreate a new opportunity (write, blocked in read-only mode)

Create a new opportunity (write, blocked in read-only mode)

No parameter schema in public metadata yet.

update_opportunitaUpdate status, amount or notes on an existing opportunity (write, blocked in read-only mode)

Update status, amount or notes on an existing opportunity (write, blocked in read-only mode)

No parameter schema in public metadata yet.

search_contattiSearch contacts by name, email or company

Search contacts by name, email or company

No parameter schema in public metadata yet.

add_nota_opportunitaAdd a comment/note to an opportunity (write, blocked in read-only mode)

Add a comment/note to an opportunity (write, blocked in read-only mode)

No parameter schema in public metadata yet.

list_attivita_opportunitaList activities linked to an opportunity

List activities linked to an opportunity

No parameter schema in public metadata yet.

describe_moduloShow available fields for any VTENext module

Show available fields for any VTENext module

No parameter schema in public metadata yet.

query_rawRun a raw VTQL SELECT query

Run a raw VTQL SELECT query

No parameter schema in public metadata yet.

Sponsors

Configuration

VTENEXT_URL*

Base URL of your VTENext instance

VTENEXT_USERNAME*

VTENext user the server logs in as

VTENEXT_ACCESS_KEY*secret

Access key of that user, in VTENext under Admin > Users > user > Access Key

READ_ONLYdefault: false

Set to true to block every write tool

Readme

mcp-vtenext

MCP server for VTENext CRM: exposes the WebService API as tools for Claude and other MCP-compatible clients.

Requirements

  • Node.js 18+
  • A running VTENext instance (self-hosted or Docker, see ../docker)

Setup

cd mcp/vtenext/server
npm install
cp .env.example .env

Edit .env:

VTENEXT_URL=http://your-vtenext-instance
VTENEXT_USERNAME=admin
VTENEXT_ACCESS_KEY=your_access_key
READ_ONLY=false

The access key is in VTENext under Admin → Users → [user] → Access Key.

Read-only mode

Set READ_ONLY=true to prevent any write operation on VTENext. When enabled, the tools create_opportunita, update_opportunita and add_nota_opportunita return an error instead of writing data.

This is useful when the server is used by AI bots or automated agents that should only read CRM data. To run a read-only instance alongside a full-access one, pass the variable via the MCP config:


View the full README on GitHub

Details

Repository
github.com/castaldo-solutions/mcp-vtenext
Website
www.castaldosolutions.it/articles/en/blog/mcp-server-vtenext-crm-claude
Categories
Sales & Marketing, Finance & Commerce
Package
@castaldosolutions/mcp-vtenext
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related Sales & Marketing MCP servers

View all
1sambel avatarCatchDoms — Expired Domains APIsambel/catchdoms-mcpSearch 22 sources of expired domains with SEO metrics, 183,537 aged ccTLDs, and pending-delete.4stars
2astrotomic avatarArchivist AIastrotomic/mcp.myarchivist.aiOfficial remote MCP server for Archivist AI TTRPG campaign memory: characters, sessions, and more.0stars
3jbechtel-97 avatarDealflowprojbechtel-97/dealflowpro-mcp-serverMultifamily real estate deal analysis — cap rate, DSCR, IRR, DFP Score, max offer price4stars
4sequenzy avatarSequenzy MCPsequenzy/mcpSequenzy MCP server for AI-powered email marketing automation.0stars
5aizaloapp avatarAEORank — SEO, AEO & GEO Audit Engineaizaloapp/aeorankLive 62-rule SEO, AEO & GEO audit, RFC 9727 api-catalog, llms.txt & AI citation tools.3stars
6aernouddekker avatarContactsmcpaernouddekker/macos-mcpMCP server for macOS Contacts.app — contact management via AppleScript0stars