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 git@github.com:epam/TimeBase-Agent-Plugins.git ~/.cursor/plugins/local/timebase

Windows:

git clone git@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:

git@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 git@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.

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

1. Node.js installed (for npx).
2. Git access to this repo from your machine.

Installation

npx skills (recommended)

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

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

Manual installation

1. Clone this repository:

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

2. Copy the /skills/qql-generator directory into your tool's skills installation folder.

Usage

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

Uninstallation

npx skills remove