Verodat MCP Server

Overview

A Model Context Protocol (MCP) server implementation for Verodat, enabling seamless integration of Verodat's data management capabilities with AI systems like Claude Desktop.

Features

Account & Workspace Management
- List accessible accounts
- Browse workspaces within accounts
Dataset Operations
- Create datasets with custom schemas and validation
- Query and filter datasets
- Retrieve dataset records
AI Integration
- Fetch workspace context for AI processing
- Execute AI-powered queries on datasets

Prerequisites

Node.js (v18 or higher)
Git
Claude Desktop (for Claude integration)
Verodat account and AI API key

Quick Start

Installing via Smithery

To install Verodat MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @Verodat/verodat-mcp-server --client claude

Manual Installation

Clone the repository:

git clone https://github.com/Verodat/verodat-mcp-server.git
cd verodat-mcp-server

Install dependencies and build:
```
npm install
npm run build
```

Configure Claude Desktop:

Create or modify the config file:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

Add the following configuration:

{
    "mcpServers": {
        "verodat": {
            "command": "node",
            "args": ["path/to/verodat-mcp-server/build/src/index.js"],
            "env": {
                "VERODAT_AI_API_KEY": "your-verodat-ai-api-key"
            }
        }
    }
}

Getting Started with Verodat

Sign up for a Verodat account at verodat.com
Generate an AI API key from your Verodat dashboard
Add the API key to your Claude Desktop configuration

Available Commands

The server provides the following MCP commands:

// Account & Workspace Management
get-accounts        // List accessible accounts
get-workspaces     // List workspaces in an account
get-queries 		// Retrieve existing AI queries

// Dataset Operations
create-dataset     // Create a new dataset
get-datasets      // List datasets in a workspace
get-dataset-output // Retrieve dataset records
get-dataset-targetfields // Retrieve dataset targetfields
upload-dataset-rows  // Add new data rows to an existing dataset

// AI Operations
get-ai-context     // Get workspace AI context
execute-ai-query   // Run AI queries on datasets

Debugging

The MCP server communicates over stdio, which can make debugging challenging. We provide an MCP Inspector tool to help:

npm run inspector

This will provide a URL to access debugging tools in your browser.

Contributing

We welcome contributions! Please feel free to submit a Pull Request.

License

LICENSE file for details

Support

Documentation: Verodat Docs
Issues: GitHub Issues
Community: Verodat Community

Verodat MCP Server