This repository contains the ThousandEyes AI Agents Toolkit: a growing collection of integrations that connect ThousandEyes with LLM-powered developer tools and AI agents.
| Skill | Description |
|---|---|
| thousandeyes-synthetic-monitoring | Manage ThousandEyes synthetic monitoring with MCP tools. Use when a user wants to list, inspect, create, update, delete, or validate synthetic tests; deploy application templates; or choose the right monitoring approach across Network and Application Synthetics and Browser Synthetics. |
| thousandeyes-alert-rule-management | List, inspect, create, update, or delete ThousandEyes alert rules with MCP tools. Use when a user wants help managing alert rules for Network & App Synthetics or Routing alert rules. |
| thousandeyes-network-data-from-traceid | Obtain ThousandEyes Network & App Synthetics data given a trace ID. Use when a user has a traceId, ThousandEyes MCP is available, and one or more Observability Platform integrations or equivalent tooling paths are available to query every relevant Observability Platform for the trace, extract tracestate or w3c.tracestate, decode the embedded ThousandEyes permalink, recover the ThousandEyes account/test/agent/execution identifiers, and fetch the matching ThousandEyes network data. |
| thousandeyes-test-trace-correlation | Investigate failing ThousandEyes synthetic tests with MCP tools. Use when a user wants ThousandEyes test triage, service-map or trace-ID correlation, distributed-tracing checks, correlation across Observability Platforms, or evidence-backed root-cause analysis with optional code fixes. |
You can install these shared skills directly from the open skills ecosystem with npx skills add.
To contribute an install signal to skills.sh, run the command outside CI. The skills CLI disables telemetry in CI environments.
npx skills add thousandeyes/thousandeyes-ai-agents-toolkitnpx skills add thousandeyes/thousandeyes-ai-agents-toolkit --skill thousandeyes-test-trace-correlation
npx skills add thousandeyes/thousandeyes-ai-agents-toolkit --skill thousandeyes-network-data-from-traceidnpx skills add thousandeyes/thousandeyes-ai-agents-toolkit --listnpx skills add thousandeyes/thousandeyes-ai-agents-toolkit -a claude-code
npx skills add thousandeyes/thousandeyes-ai-agents-toolkit -a codex
npx skills add thousandeyes/thousandeyes-ai-agents-toolkit -a cursor
npx skills add thousandeyes/thousandeyes-ai-agents-toolkit -a github-copilotFor clients that can consume Agent Skills but are not covered by one of the plugin install flows below, such as GitHub Copilot agent mode in VS Code, install the shared ThousandEyes skills locally with skills.sh:
npx skills add thousandeyes/thousandeyes-ai-agents-toolkit -a github-copilotYou can replace github-copilot with another supported skills.sh agent, omit the -a flag to let the CLI detect available local agents, or run npx skills add thousandeyes/thousandeyes-ai-agents-toolkit --list first to preview the skills.
The repository-level skills/ directory is the source of truth for shared skills. Cursor and Claude Code discover those skills directly from the repo root, while the Codex plugin ships mirrored copies under plugins/thousandeyes/skills/.
- Sync all Codex skill copies after editing or adding shared skills:
bash scripts/sync_codex_skill.sh sync - Verify all mirrored Codex skill copies are still aligned:
bash scripts/sync_codex_skill.sh check - Scope the command to specific skills when needed:
bash scripts/sync_codex_skill.sh sync <skill-name> - Enable the repo hook so commits are blocked when the copies drift:
git config core.hooksPath .githooks - GitHub Actions validates Codex skill mirror sync for skill-related changes.
This repository now includes a local Codex marketplace plugin for ThousandEyes at plugins/thousandeyes, with a matching marketplace definition at .agents/plugins/marketplace.json.
- Open Codex and add the local marketplace rooted at this repository's
.agents/plugins/marketplace.json. - Find ThousandEyes in that marketplace and install it.
- Complete authentication when prompted.
- Start a new chat and use ThousandEyes tools through the plugin-provided MCP integration.
As an alternative to configuring the ThousandEyes MCP Server directly in Cursor, you can install the ThousandEyes Cursor plugin.
- Open Cursor and go to Settings > Plugins.
- Search for ThousandEyes.
- Click Add to Cursor and choose the scope:
- Project scope: install only for the current workspace.
- User scope: install for all your Cursor projects.
- Go to Settings > Tools & MCP, scroll to the ThousandEyes plugin, click Connect and complete the authentication.
- Start a new chat and use ThousandEyes tools through the plugin-provided MCP integration.
- Open a Cursor chat.
- Run
/add-plugin thousandeyes. - Confirm the install prompt and scope (project or user).
- Go to Settings > Tools & MCP, scroll to the ThousandEyes plugin, click Connect and complete the authentication.
- Start a new chat and use ThousandEyes tools through the plugin-provided MCP integration.
For more details on plugin installation and management, see: https://cursor.com/docs/plugins
As an alternative to configuring the ThousandEyes MCP Server directly in Claude Code, you can install the ThousandEyes Claude Code plugin. The plugin exposes the shared repo skills in skills/ alongside the MCP integration.
- Run
claude plugin install thousandeyesand choose the scope:--scope user(default): install for all your Claude Code projects.--scope project: install only for the current workspace (shared via version control).--scope local: install for the current project only (gitignored).
- Start a new session and use ThousandEyes tools through the plugin-provided MCP integration.
- Open Claude Code.
- Type
/pluginand search for ThousandEyes. - Follow the prompts to install and choose the scope.
- Start a new session and use ThousandEyes tools through the plugin-provided MCP integration.
- Shared plugin skills live under
skills/at the repository root. - Claude Code namespaces plugin skills by plugin name, so
skills/thousandeyes-test-trace-correlation/SKILL.mdis available as/thousandeyes:thousandeyes-test-trace-correlation. - After adding a new shared skill, reinstall or reload the plugin if Claude Code does not pick it up immediately.
For more details on Claude Code plugins, see: https://code.claude.com/docs/en/plugins-reference
For bug reports, feature requests, or questions about this toolkit, please contact ThousandEyes Support.
For setup guidance, prerequisites, and available MCP tools, see: https://docs.thousandeyes.com/product-documentation/integration-guides/thousandeyes-mcp-server