
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.
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…
Installation
In SourceWeft
- Open TimeBase in the dashboard and add it to a workspace.
- 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-mcpas a local process (stdio) that connects to your TimeBase. - Remotely, you deploy
timebase-mcpas a shared HTTP service that multiple users connect their agents to.
Which guide do I need?
Documentation
See also
Source: README.md at commit 3b364b8
Tools
0Version history
6- v0.2.8LatestNov 11, 2026
- v0.2.7Oct 22, 2026
- v0.2.6Oct 6, 2026
- v0.2.5Sep 29, 2026
- v0.2.4Sep 24, 2026
- 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
