io.github.epam/TimeBase-MCP (MCP Server)

TimeBase-MCP is a Model Context Protocol server that enables a coding agent to explore and query TimeBase. It supports listing streams, reading schemas and symbols, previewing messages, running QQL queries, and inspecting server status and activity. It is designed to integrate with MCP-enabled tools.

🛠️ Key Features

Explore and query TimeBase streams
Read schemas and symbols
Preview messages
Run QQL queries
Inspect server status and activity
Supports MCP-based integration with coding agents

🚀 Use Cases

Discover available TimeBase streams
Review message structure via schemas and symbols
Validate or inspect data by previewing messages
Retrieve data subsets using QQL
Check TimeBase/MCP server status and activity

⚡ Developer Benefits

Standard MCP interface for TimeBase exploration
Enables agents (e.g., Claude Code, VS Code, Cursor, Claude Desktop) to access TimeBase capabilities
Supports both local process and remote service deployment models

⚠️ Limitations

Remote deployment details are not included beyond the mention of a shared HTTP service
Specific QQL features, schema formats, and message preview scope are not described

TimeBase MCP

A Model Context Protocol server that lets a coding agent (Claude Code, VS Code, Cursor, Claude Desktop, etc.) explore and query TimeBase: list streams, read schemas and symbols, preview messages, run QQL queries, and inspect server status and activity.

The server can run two ways:

Locally, your agent launches timebase-mcp as a local process (stdio) that connects to your TimeBase.

Remotely, you deploy timebase-mcp as a shared HTTP service that multiple users connect their agents to.

You want to

Go to

Use TimeBase MCP locally (Cursor, VS Code, Claude Code/Desktop)

Agent Plugins Quickstart

Manual local setup

Local setup

Deploy a shared remote MCP server

Remote deployment

Connect to a running remote server

Connect to a remote server

Add optional WebAdmin inspection

Add WebAdmin access

Topic

Go to

Updating

Local setup: Updating

Troubleshooting

Reference

Environment variables, auth, capabilities

Install

Configuration

Environment variables

TIMEBASE_URLdefault dxtick://localhost:8011

TimeBase native connection URL.

TIMEBASE_SERVERS

Multi-server config as a JSON array string or path to a JSON file.

TIMEBASE_USERNAME

Username for basic auth or oauth2_client_credentials.

TIMEBASE_PASSWORDsecret

Password for basic auth.

TIMEBASE_OAUTH2_TOKEN_URL

OAuth2 token endpoint for service-account client credentials.

TIMEBASE_OAUTH2_CLIENT_ID

OAuth2 client ID for service-account or interactive login.

TIMEBASE_OAUTH2_CLIENT_SECRETsecret

OAuth2 client secret for service-account auth.

TIMEBASE_OAUTH2_SCOPE

OAuth2 scope(s) for service-account or interactive login.

MCP_LOG_LEVELdefault INFO

Log level: DEBUG, INFO, WARNING, ERROR, or CRITICAL.

TIMEBASE_AUTH_MODEdefault auto

Outbound auth: auto, none, basic, oauth2_client_credentials, interactive.

MCP_HOSTdefault 127.0.0.1

Loopback host for interactive OAuth redirect in stdio mode.

MCP_PORTdefault 8000

Loopback port for interactive OAuth redirect in stdio mode.

MCP_AUTH_PUBLIC_URL

Public HTTPS URL of this MCP endpoint (e.g. https://mcp.example.com/mcp).

MCP_AUTH_AUDIENCE

Expected JWT audience for inbound IdP auth.

MCP_AUTH_API_KEYS_FILE

Path to a hashed API-key store for inbound bearer-key auth.

Arguments

--fromdefault timebase-mcp[all]

-pdefault 8000:8000

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "TimeBase-MCP": {
      "command": "uvx",
      "args": [
        "timebase-mcp"
      ],
      "env": {
        "TIMEBASE_URL": "dxtick://localhost:8011",
        "TIMEBASE_SERVERS": "<YOUR_TIMEBASE_SERVERS>",
        "TIMEBASE_USERNAME": "<YOUR_TIMEBASE_USERNAME>",
        "TIMEBASE_PASSWORD": "<YOUR_TIMEBASE_PASSWORD>",
        "TIMEBASE_OAUTH2_TOKEN_URL": "<YOUR_TIMEBASE_OAUTH2_TOKEN_URL>",
        "TIMEBASE_OAUTH2_CLIENT_ID": "<YOUR_TIMEBASE_OAUTH2_CLIENT_ID>",
        "TIMEBASE_OAUTH2_CLIENT_SECRET": "<YOUR_TIMEBASE_OAUTH2_CLIENT_SECRET>",
        "TIMEBASE_OAUTH2_SCOPE": "<YOUR_TIMEBASE_OAUTH2_SCOPE>",
        "MCP_LOG_LEVEL": "INFO",
        "TIMEBASE_AUTH_MODE": "auto",
        "MCP_HOST": "127.0.0.1",
        "MCP_PORT": "8000"
      }
    }
  }
}

TimeBase

io.github.epam/TimeBase-MCP (MCP Server)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

TimeBase MCP

Which guide do I need?

Documentation

See also

Install

Configuration

Related servers