Skip to main content

timebase

Connect your AI agent to TimeBase, a high-performance database for financial market and other time-series data, via MCP tools and skills for QQL query and TimeBase client code generation.

External pluginv0.1.7EPAM SystemsApache-2.0epam/TimeBase-Agent-Plugins
Install
Maintained outside this repository

timebase is published by EPAM Systems from epam/TimeBase-Agent-Plugins, pinned to d5b0d7bd57b7dd7bd051238527bfe3d87e15da29. Review the source before installing.

View the source repository

TimeBase plugins for Cursor, VSCode, Claude Code, OpenAI Codex, Gemini CLI, Antigravity CLI, and any tool supporting the Open Plugin standard.

Includes MCP tools and skills for QQL, TimeBase client development, WebAdmin integration, and troubleshooting.

If you only need skills, jump to Skills.

Quickstart

1. Install uv

Install uv if uvx is not available.

Check that uvx is available in your shell:

uvx -V

2. Install plugin in your tool

Cursor

Clone this repository as a local plugin.

macOS/Linux:

git clone https://github.com/epam/TimeBase-Agent-Plugins.git ~/.cursor/plugins/local/timebase

Windows:

git clone https://github.com/epam/TimeBase-Agent-Plugins.git %USERPROFILE%\.cursor\plugins\local\timebase

Open Cursor Settings > Plugins > TimeBase Plugin > TimeBase MCP to edit configuration.
Available options: MCP configuration.

VSCode

Search for @agentPlugins timebase in the Extensions tab to install.

For adjusting the settings open the chat panel, click Configure Tools, hover over timebase-mcp, then click Configure TimeBase. Available options: MCP configuration.

Claude Code

Open a terminal and run:

claude plugin marketplace add epam/TimeBase-Agent-Plugins
claude plugin install timebase@timebase-plugins

You will be able to configure MCP by running /plugins inside a Claude Code session, selecting the plugin under Installed and clicking Configure options.
Available options: MCP configuration.

Claude Desktop

Open Settings > Plugins > Add > Add Marketplace and paste:

epam/TimeBase-Agent-Plugins

Press Sync button and wait for the plugin list to appear.

Select TimeBase and click the + to install.

OpenAI Codex

From your terminal, run:

codex plugin marketplace add epam/TimeBase-Agent-Plugins
codex plugin add timebase@timebase-plugins

Then start a new Codex instance so the plugin skills and MCP tools are loaded.

The MCP server settings can be configured globally in ~/.codex/config.toml or per project in .codex/config.toml:

[plugins."timebase@timebase-plugins".mcp_servers.timebase.env]
TIMEBASE_URL = "dxtick://localhost:8011"

Check out the available MCP configuration options.

GitHub Copilot CLI

In your terminal, run:

copilot plugin install timebase@awesome-copilot

Then start a new Copilot CLI session so the plugin is loaded.

Adjust the MCP server settings via /mcp edit timebase-mcp command. Check out the available MCP configuration options.

GitHub Copilot App

Use the following button:

Install TimeBase plugin

Or go to Settings > Plugins and search for timebase.

Gemini CLI

From your terminal, run:

gemini extensions install https://github.com/epam/TimeBase-Agent-Plugins

Then restart any pre-existing Gemini CLI sessions so the extension is loaded.

Extension exposes the main TimeBase MCP environment variables as install-time settings.

To configure extension settings later, run:

gemini extensions config timebase
Antigravity CLI

From your terminal, run:

agy plugin install https://github.com/epam/TimeBase-Agent-Plugins

Then start a new Antigravity CLI session so the plugin is loaded.

Check out the available TimeBase MCP environment variables for the full list of supported options.

Other tools

This repository follows the Open Plugin standard, so it can be used in any compatible tool.

[!NOTE] If you encounter issues with the MCP server, check out the troubleshooting guide.

Updating an existing plugin installation

Updating the plugin updates the pinned TimeBase MCP version. You do not need to update TimeBase MCP separately.

Cursor

If you cloned the plugin locally, pull the latest changes:

macOS/Linux:

git -C ~/.cursor/plugins/local/timebase pull

Windows:

git -C %USERPROFILE%\.cursor\plugins\local\timebase pull
VSCode

VS Code updates plugins automatically every 24 hours by default. To trigger an update manually, open command palette (CMD+Shift+P / Ctrl+Shift+P) and run Extensions: Check for Extension Updates.

Claude Code

Inside Claude Code session run:

/plugin

Navigate to the installed plugin and click Update button.

Claude Desktop

Use the Settings > Plugins > TimeBase > Update button.

OpenAI Codex

Refresh the marketplace snapshot and reinstall the plugin:

codex plugin marketplace upgrade timebase-plugins
codex plugin add timebase@timebase-plugins

Then restart any running Codex instances.

GitHub Copilot CLI

In your terminal, run:

copilot plugin update timebase

Then restart any running Copilot CLI sessions.

GitHub Copilot App

Go to Settings > Plugins, find timebase and click Update plugin under the 3-dot menu.

Gemini CLI

In your terminal, run:

gemini extensions update timebase

Then restart any running Gemini CLI sessions.

Antigravity CLI

Antigravity CLI doesn't have a built-in update command. To update the plugin, follow the installation instructions again.

Other tools

Refer to your tool's documentation for updating plugins installed from a repository source.

Skills

[!NOTE] The plugin includes the skills and TimeBase MCP. Installing skills separately does not install MCP. QQL validation and live runtime inspection need a reachable TimeBase server. Troubleshooting with search_logs_kb requires TimeBase MCP 0.2.5 or later, but the bundled knowledge base can be searched without a live TimeBase connection.

Prerequisites

  • Node.js installed for npx skills.

Installation

npx skills (recommended)

Works for Claude Code, Cursor, VSCode and any other tool supporting the Agent Skills open standard.

npx skills add https://github.com/epam/TimeBase-Agent-Plugins.git

[!WARNING] Doesn't work for Claude Desktop, use the manual installation path below instead.

Manual installation

Download the desired <skill-name>.zip from the latest release.

Claude Desktop accepts the ZIP directly. Open Settings > Skills > Add > Upload skill.

For other tools, extract the ZIP and copy its <skill-name> directory into your tool's skills installation folder.

You can also clone this repository instead of downloading a ZIP:

git clone https://github.com/epam/TimeBase-Agent-Plugins.git

Then copy skills/<skill-name> directory into your tool's skills installation folder.

Usage

No special actions are required. Just ask your agent something about QQL.

Updating

To update skills you already installed from this repository:

npx skills update

To install a newly added skill from this repository, run the installation command again or copy the new skill directory manually.

Uninstallation

npx skills remove