npm package: @qrvey/mcp-beta
Description: MCP server for Qrvey Platform - Beta
Author: Qrvey
Latest version: 0.1.4

# 🌟 Qrvey MCP Server (Beta)

The Qrvey MCP Server implements the [MCP specification](https://modelcontextprotocol.io) to create a seamless connection between AI agents and Qrvey Platform services.

## 🛠️ Configuration

### VS Code - Install Guide

1. Install VS Code: [Stable release](https://code.visualstudio.com/download)
2. Install the [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) and [GitHub Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat) extensions
3. Add `.vscode/mcp.json`:

    ```json
    {
        "servers": {
            "qrvey-mcp-server": {
                "command": "npx",
                "args": ["@qrvey/mcp-beta@latest"],
                "type": "stdio",
                "env": {
                    "QRVEY_ENDPOINT": "your-qrvey-endpoint",
                    "QRVEY_APIKEY": "your-apikey",
                    "QRVEY_USERID": "your-userid"
                }
            }
        }
    }
    ```

4. Start (or Auto-Start) the MCP Server

    > VS Code (version 1.103 or above): You can now configure MCP servers to start automatically using the `chat.mcp.autostart` setting, instead of manually restarting them after configuration changes.

    **Enable Autostart**

    1. Open Settings in VS Code.
    2. Search for chat.mcp.autostart.
    3. Select newAndOutdated to automatically start MCP servers without manual refresh.
    4. You can also set this from the refresh icon tooltip in the Chat view, which also shows which servers will auto-start.

    **Manual Start (if autostart is off)**

    1. Open Command Palette (Ctrl+Shift+P / Cmd+Shift+P).
    2. Run MCP: List Servers.
    3. Select Qrvey MCP Server ext, then click **Start Server**.
    4. **Check That It's Running**

        - Go to the Output tab in VS Code.
        - Look for log messages confirming the server started successfully.

### VS Code - Quick Start

1. Open Copilot Chat in VS Code and [switch to Agent mode](https://code.visualstudio.com/docs/copilot/chat/chat-agent-mode).
2. Refresh the tools list and confirm “Qrvey MCP Server” appears.
3. Ask a plain-English prompt, e.g., “Show my Qrvey applications.” The agent will use the Qrvey tools automatically.

### Claude - Install Guide

1. Install Claude for Desktop (macOS): https://www.anthropic.com/claude
2. Create or edit the Claude Desktop config file:
    - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
3. Add this MCP server configuration:

    ```json
    {
        "mcpServers": {
            "qrvey-mcp-server": {
                "command": "npx",
                "args": ["@qrvey/mcp-beta@latest"],
                "env": {
                    "QRVEY_ENDPOINT": "your-qrvey-endpoint",
                    "QRVEY_APIKEY": "your-apikey",
                    "QRVEY_USERID": "your-userid"
                }
            }
        }
    }
    ```

4. Restart Claude Desktop to load the server.
5. In a new chat, try: “Show my Qrvey applications.” Claude will call the Qrvey tools when needed.

## ✨ What can you do with the Qrvey MCP Server?

The Qrvey MCP Server augments your agents with rich Qrvey context. Try these example prompts:

You don’t need to know tool names—just ask in plain English. Here are some ideas:

### Common tasks

-   Show me all my Qrvey applications.

### Datasets & connections

-   What connections does the app 'My App' have?
-   Find the connection named 'My Connection' in the app 'My App'.
-   List datasets for the app 'My App'.
-   Show details for the dataset 'My Dataset' in 'My App'.
-   Show the last 5 sales transactions in 'My Dataset' over $1,000.
-   Show recent activity for the dataset 'My Dataset' (filter by 'reloaded').

### Analytics

-   What charts are available for the dataset 'My Dataset'?
-   List dashboards for the app 'My App'.
-   Show me the dashboar structure of 'My Dashboard'.

### Extras

-   Which Qrvey version am I on?

_Tip: First ask “List my applications” to get an appId; then “List datasets for that app” to get a datasetId, and so on._

Qrvey 2025