Skip to main content
Glama
alvaromunoz-gk

mcp-hevo-service

by alvaromunoz-gk
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

mcp-hevo-service

A read-only MCP server for the Hevo Data public API (v2.0). Self-hosted: your API credentials stay on your machine and never reach a third party. Exposes monitoring/inspection tools over pipelines, objects, destinations, models and workflows. Every tool maps to a GET endpoint, so the server cannot mutate Hevo state.

Quick start

git clone <this-repo>
cd mcp-hevo-service
pip install -r requirements.txt
cp .env.template .env   # then fill in your credentials

Related MCP server: xendit-mcp

Configuration

Generate an API Key + Secret in Hevo (Account Settings > API) and set them in .env:

Variable

Description

HEVO_API_KEY

API key (used as the Basic-auth username).

HEVO_API_SECRET

API secret (used as the Basic-auth password).

HEVO_REGION

One of us, eu, au, in. Selects the base URL https://<region>.hevodata.com/api/public/v2.0.

Verify

python test_connection.py

Confirms the credentials authenticate against GET /pipelines. No MCP client needed.

Register in an MCP client

{
  "mcpServers": {
    "hevo": {
      "command": "/path/to/python3",
      "args": ["/path/to/mcp-hevo-service/server.py"]
    }
  }
}

Tools

All tools are read-only (GET).

Tool

Hevo endpoint

list_pipelines

GET /pipelines

get_pipeline

GET /pipelines/{id}

get_pipeline_schedule

GET /pipelines/{id}/schedule

list_pipeline_objects

GET /pipelines/{id}/objects

get_pipeline_object_stats

GET /pipelines/{id}/objects/{object_name}/stats

list_destinations

GET /destinations

get_destination

GET /destinations/{id}

get_destination_table_stats

GET /destinations/{id}/tables/{table_name}/stats

list_models

GET /models

get_model

GET /models/{id}

list_workflows

GET /workflows

get_workflow

GET /workflows/{id}

Security

  • Read-only by construction: the client only issues GET requests and no write tool is registered. There is no way to start/pause/edit a pipeline through this server.

  • Credentials are read from .env (gitignored) and sent as HTTP Basic auth directly to Hevo. They are not logged and never leave your host.

Notes

Auth and endpoints follow the official Hevo API docs. Pagination uses limit + starting_after where supported (see per-tool descriptions).

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • databricks-mcp

    ChrisChoTW
    A
    license
    C
    quality
    D
    maintenance
    A read-only MCP server that enables users to query Databricks SQL, browse metadata, and monitor Delta Lake tables. It also supports tracking Databricks Jobs, DLT Pipelines, and cluster metrics through natural language interfaces.
    25
    4
    MIT

  • xendit-mcp

    indratjhai
    A
    license
    A
    quality
    D
    maintenance
    A read-only MCP server for securely accessing Xendit payment platform data. It enables querying balances, invoices, transactions, disbursements, refunds, and virtual account payments while preventing any money-moving operations.
    13
    MIT
  • KVMFleet MCP Server by KVMFleet

    KVMFleet MCP Serverofficial

    KVMFleet
    A
    license
    A
    quality
    D
    maintenance
    Read-only MCP server that allows AI assistants to query and monitor KVM Fleet devices, audit logs, and console sessions through the official REST API.
    5
    9 npm
    1
    MIT

  • airbyte-oss-mcp

    NGRThomson
    A
    license
    B
    quality
    C
    maintenance
    Read-only MCP server for self-hosted Airbyte OSS 1.6.x, enabling monitoring of connections, jobs, and health via public and internal APIs. Optionally supports triggering syncs and canceling jobs.
    9
    MIT