Skip to main content
Glama
GreptimeTeam

GreptimeDB MCP Server

Official
by GreptimeTeam

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
GREPTIMEDB_HOSTNoDatabase hostlocalhost
GREPTIMEDB_PORTNoDatabase MySQL port4002
GREPTIMEDB_USERNoThe database usernameroot
GREPTIMEDB_DATABASENoThe database namepublic
GREPTIMEDB_PASSWORDNoThe database password
GREPTIMEDB_TIMEZONENoThe session time zoneUTC

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
execute_sqlA

Execute SQL query against GreptimeDB. Please use MySQL dialect.

Read-only by default. When the server runs with write mode enabled
(--allow-write / GREPTIMEDB_ALLOW_WRITE), destructive SQL (DDL/DML) is
also permitted.
describe_tableA

Get a table profile: schema, semantic metadata, sample rows, and guidance.

health_checkA

Check GreptimeDB connection status and server version.

execute_tqlC

Execute TQL query for time-series analysis. TQL is PromQL-compatible - use standard PromQL syntax.

query_rangeC

Execute time-window aggregation query using GreptimeDB's RANGE query syntax.

explain_queryC

Analyze SQL or TQL query execution plan.

list_pipelinesC

List all pipelines or get details of a specific pipeline.

create_pipelineC

Create a new pipeline in GreptimeDB.

dryrun_pipelineA

Test a pipeline with sample data without writing to the database.

You can test a pipeline in two ways:
- Provide 'pipeline' with inline YAML configuration
- Provide 'pipeline_name' to test a previously saved pipeline

Args:
    pipeline: Pipeline YAML configuration (inline)
    pipeline_name: Name of saved pipeline (mutually exclusive with pipeline)
    data: Test data in JSON/NDJSON format
    data_type: Optional content type (e.g., 'application/x-ndjson')
delete_pipelineB

Delete a specific version of a pipeline from GreptimeDB.

list_dashboardsA

List all Perses dashboard definitions stored in GreptimeDB.

create_dashboardC

Create or update a Perses dashboard definition in GreptimeDB.

delete_dashboardC

Delete a Perses dashboard definition from GreptimeDB.

Prompts

Interactive templates invoked by user choice

NameDescription
promql_analysisPromQL-style queries using GreptimeDB TQL EVAL syntax.
metrics_analysisSQL and RANGE analysis for existing GreptimeDB time-series tables.
trace_analysisDistributed trace analysis for OpenTelemetry spans in GreptimeDB.
observability_correlationCorrelate GreptimeDB metrics, logs, and traces across a shared time window.
pipeline_creatorGenerate GreptimeDB pipeline YAML configuration from log samples.
table_operationTable diagnostics: schema, region health, storage, and cluster metadata for GreptimeDB.
log_pipelineLog analysis with full-text search and aggregation in GreptimeDB.
schema_design_advisorSchema and index design advisor for GreptimeDB tables.
ingestion_troubleshootingTroubleshoot GreptimeDB ingestion issues across OTLP, Prometheus, Loki, SQL, and pipelines.
query_performance_tuningTune GreptimeDB SQL, TQL, and RANGE queries using execution plans and table metadata.

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/GreptimeTeam/greptimedb-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server