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
- Clone this repository:
git clone https://github.com/epam/TimeBase-Agent-Plugins.git
