TimeBase Agent Plugins

TimeBase plugins for Cursor, VSCode, Claude Code, and any tool supporting the Open Plugin standard.

If you only need skills, jump to Skills.

Quickstart

1. Install TimeBase MCP

Community edition:

uv tool install -p 3.14 --from "timebase-mcp[community]" timebase-mcp

Enterprise edition:

Important

Make sure to replace <user> and <password> with your Nexus credentials.

uv tool install -p 3.14 --index "https://<user>:<password>@nexus.deltixhub.com/repository/epm-rtc-public-python/simple" --from "timebase-mcp[enterprise]" timebase-mcp

If you prefer pip/pipx or another method, see the TimeBase MCP installation docs.

2. Verify MCP installation from a new terminal

timebase-mcp -v

Note

The MCP client launches the server automatically, but timebase-mcp must be discoverable in PATH.

3. 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

Open command palette (CMD+Shift+P / Ctrl+Shift+P), run Chat: Install Plugin from Source, then paste:

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

In chat panel, click Configure Tools, hover timebase-mcp, then click Configure TimeBase. Available options: MCP configuration.

Claude Code

Open Claude Code and run the following commands:

/plugin marketplace add https://github.com/epam/TimeBase-Agent-Plugins.git
/plugin install timebase@timebase-plugins
/reload-plugins

You will be prompted to configure MCP during installation.
Available options: MCP configuration.

[!WARNING] On macOS there's an upstream issue with plugin configuration sometimes not being passed to the MCP. As a workaround, you can disable the plugin-managed MCP server from the /plugin menu and manually add it using the following command:

claude mcp add timebase-mcp --transport stdio --env TIMEBASE_URL='dxtick://localhost:8011' -- timebase-mcp

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

Important

TimeBase MCP command needs to be updated separately using your package manager, see the MCP documentation for instructions.

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.

Other tools

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

Skills

Warning

The qql-generator skill is built around grounding from TimeBase MCP. For task-correct, schema-backed QQL, run the agent with TimeBase MCP configured. Usage without MCP is not recommended, you are likely to get materially worse results.

Prerequisites

• Node.js installed (for npx).

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

Manual installation

1. Clone this repository:

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

2. Copy the desired /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