TimeBase

io.github.epamPublished by GitHub account epamv0.2.8Updated Nov 11, 2026

Explore and query TimeBase streams, schemas, QQL, symbols, and server status via MCP.

VerifiedSTDIODesktop onlyDatabasesData & Analytics

Overview

AI-generated overview

MCP server that lets an assistant explore and query a TimeBase time-series store: streams, schemas, symbols, message previews, QQL queries and server status.

What you can do
  • List streams and inspect their schemas and symbols
  • Preview messages stored in streams
  • Run QQL queries against TimeBase
  • Inspect server status and activity
  • Optionally add WebAdmin inspection
When to use it
Useful when an agent needs to understand or query a TimeBase deployment — discovering available streams, checking schemas before writing queries, or running QQL to pull time-series data — either from a local setup or a shared remote server.
Requirements
Runs locally over stdio (PyPI package launched with uvx) or as a container image over streamable HTTP. Needs a TimeBase connection: TIMEBASE_URL, plus credentials depending on auth mode (TIMEBASE_USERNAME and TIMEBASE_PASSWORD for basic, or TIMEBASE_OAUTH2_CLIENT_ID, TIMEBASE_OAUTH2_CLIENT_SECRET, TIMEBASE_OAUTH2_TOKEN_URL and TIMEBASE_OAUTH2_SCOPE for OAuth2), or TIMEBASE_SERVERS for multiple servers. Remote deployment adds inbound auth settings such as MCP_AUTH_ISSUER_URL, MCP_AUTH_JWKS_URL…
Before you install
Requires TimeBase credentials: TIMEBASE_PASSWORD or TIMEBASE_OAUTH2_CLIENT_SECRET, which should be supplied via environment variables rather than committed. A shared remote deployment exposes the server to multiple users and relies on inbound auth settings (issuer, JWKS, audience, required scopes, API-key file) being configured correctly. The README does not state whether any tool writes to TimeBase; confirm before pointing it at production data.

Installation

In SourceWeft

  1. Open TimeBase in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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.

Which guide do I need?

You want toGo to
Use TimeBase MCP locally (Cursor, VS Code, Claude Code/Desktop)Agent Plugins Quickstart
Manual local setupLocal setup
Deploy a shared remote MCP serverRemote deployment
Connect to a running remote serverConnect to a remote server
Add optional WebAdmin inspectionAdd WebAdmin access

Documentation

See also

Source: README.md at commit 3b364b8

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

6
  1. v0.2.8LatestNov 11, 2026
  2. v0.2.7Oct 22, 2026
  3. v0.2.6Oct 6, 2026
  4. v0.2.5Sep 29, 2026
  5. v0.2.4Sep 24, 2026
  6. v0.2.3Sep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts