4,500+ servers built on MCP Fusion
Vinkius

TestLink MCP. Query the entire test management structure via chat.

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

TestLink MCP on Cursor AI Code Editor MCP Client TestLink MCP on Claude Desktop App MCP Integration TestLink MCP on OpenAI Agents SDK MCP Compatible TestLink MCP on Visual Studio Code MCP Extension Client TestLink MCP on GitHub Copilot AI Agent MCP Integration TestLink MCP on Google Gemini AI MCP Integration TestLink MCP on Lovable AI Development MCP Client TestLink MCP on Mistral AI Agents MCP Compatible TestLink MCP on Amazon AWS Bedrock MCP Support

Just plug in your AI agents and start using Vinkius.

TestLink MCP Server lets your AI agent access and navigate a self-hosted TestLink environment. It maps complex test data—from projects to individual cases—into natural conversation, letting you pull specific steps, check preconditions, or list active builds without touching the legacy UI.

What your AI agents can do

Get test case details

Retrieves the full manual steps, expected results, and metadata for one specific test case ID.

Get test plan details

Gets all details associated with a particular test plan instance.

Get test project details

Retrieves general information for a specific TestLink project ID.

+ 7 more capabilities included
List all available projects

Runs list_test_projects to retrieve a list of every test project on the server.

Get detailed information for a specific test plan

Uses get_test_plan_details to pull all metadata associated with a chosen test plan.

Walk through the suite structure

Runs list_test_suites or list_test_cases to map out the full folder and category tree of your tests.

Retrieve specific test case instructions

Calls get_test_case_details to output manual steps, expected results, and preconditions for a single ID.

Track software builds against plans

Executes list_test_builds to confirm which versions of the application are tied to a specific test plan.

Verify user context

Runs get_user_info to check the API token's authenticated status and permissions within TestLink.

Supported MCP Clients

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
+ other MCP clients
Free for Subscribers

Waiting for input…

AI Agent

TestLink MCP Server: 10 Tools for QA Management

Use these tools to navigate TestLink's entire data model. Access project directories, plan details, test case instructions, and build histories using natural language queries.

get019d7611

get test case details

Retrieves the full manual steps, expected results, and metadata for one specific test case ID.

get019d7611

get test plan details

Gets all details associated with a particular test plan instance.

get019d7611

get test project details

Retrieves general information for a specific TestLink project ID.

get019d7611

get test suite details

Gets details about a defined test suite, including its parent and scope.

get019d7611

get user info

Checks the API token's current user identity and authentication status within TestLink.

list019d7611

list test builds

Lists all available software builds that are linked to a specific test plan ID.

list019d7611

list test cases

Outputs a list of every individual test case found within a designated test suite.

list019d7611

list test plans

Lists all defined test plans that belong to a specific project ID.

list019d7611

list test projects

Retrieves a directory listing of every major test project on the server.

list019d7611

list test suites

Lists all defined test suites that are contained within a specific test project ID.

Choose How to Get Started

Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.

Build Your Own

Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.

  • Import from OpenAPI, Swagger, or YAML specs
  • Create Agent Skills with progressive disclosure
  • Deploy to edge with MCPFusion framework
  • Built in DLP, auth, and compliance on every call
  • Real time usage dashboard and cost metering
  • Publish to catalog or keep private
Start building

Make Your AI Do More

Start with TestLink, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.

  • Use this MCP plus 4,700+ others, all in one place
  • Add new capabilities to your AI anytime you want
  • Every connection is secured and compliant automatically
  • Track usage and costs across all your servers
  • Works with Claude, ChatGPT, Cursor, and more
  • New servers added to the catalog every week

What you can do with this MCP connector

Listen up, pal. You gotta connect your self-hosted TestLink setup to any AI agent and ditch that clunky old UI. This server exposes every core function of TestLink as actionable tools for your agent. It maps all that complex test data—from the biggest projects down to tiny individual steps—right into natural chat conversation.

Your AI client handles all the heavy lifting, letting you pull specific steps, check preconditions, or list active builds without ever touching a legacy dashboard.

Project Discovery and Scope Management
You'll start by seeing what big picture stuff is going on. You can run list_test_projects to get a directory listing of every major test project sitting on the server. When you know which project you wanna dig into, use get_test_project_details to grab all the general info for that specific TestLink project ID.

Navigating the Hierarchy
To walk through your entire suite structure, first check out the projects with list_test_projects, then jump in and run list_test_suites to get a list of every defined test suite tied to a project. If you need more depth on those suites, call get_test_suite_details for details about a specific suite, including its parent scope.

From there, you can map out the whole folder and category tree by calling list_test_cases, which outputs every individual test case found within that designated test suite. For the nitty-gritty on any single item, you'll use get_test_case_details to pull all manual steps, expected results, metadata, and preconditions for a specific test case ID.

Testing Plans and Builds
If your goal is tracking what needs testing, start by listing the plans themselves. Run list_test_plans to get every defined test plan belonging to a project. Grab all the associated data using get_test_plan_details for a chosen instance. When you need to know which versions of the app are tied to that plan, execute list_test_builds.

This function confirms exactly which software builds are linked to a specific test plan ID.

Checking Context and Permissions
Before you start pulling data, you gotta make sure your agent has clearance. Use get_user_info to check the API token's authenticated status and see what user identity it’s running under within TestLink.

This toolset lets you query the full lifecycle of a software test, allowing your agent to verify your authentication context via get_user_info, retrieve general project info using get_test_project_details, list all available projects with list_test_projects, and drill down through the structure. You can then use list_test_suites or get_test_suite_details to map out the full category tree, listing every case via list_test_cases.

To get the deep details on a plan, run list_test_plans followed by get_test_plan_details, and confirm linked software versions with list_test_builds. Finally, when you're down to the actual procedure, call get_test_case_details for all the steps, expected results, and metadata on that single test case. You'll get every piece of data without having to look at a messy web interface.

How TestLink MCP Works

  1. 1 First, subscribe to the server. You need to provide your instance Base URL and a developer API Key.
  2. 2 Next, prompt your AI client (Claude, Cursor, etc.) with the specific data you want—for example: 'List all test plans for Project ID 2.'
  3. 3 The agent runs the necessary tool (list_test_plans or get_test_case_details), retrieves the raw structured data, and presents it in a readable format.

The bottom line is: you tell your AI client what test information you need; the server handles connecting to TestLink and fetching the required details.

Who Is TestLink MCP For?

QA Leads, Test Engineers, and Developers. This toolset helps people who spend too much time clicking through nested UIs just to verify a single precondition or pull historical test steps into a report. It gives you the data without the dashboard headache.

Test Engineer

Needs to recall exact, step-by-step instructions from old test cases and paste them directly into markdown for documentation.

QA Lead

Must pull a list of all active test plans across multiple projects to define the scope for a new regression cycle.

Developer (DevOps)

Needs to verify if a specific bug requires a certain software build version by checking list_test_builds against a project ID.

What Changes When You Connect

  • Stop clicking through menus. Use list_test_projects to pull a list of all project IDs in one command, giving you immediate scope visibility without navigating deep into the UI.
  • Pull specific data points instantly. Need the steps for Bug #5440? Call get_test_case_details. You get preconditions and expected results formatted right into your chat window.
  • Verify builds fast. Instead of guessing what version to test, use list_test_builds with a plan ID to confirm exactly which software versions are tracked against that test scope.
  • Map out the coverage area. Run list_test_suites after identifying a project using list_test_projects. This gives you the full hierarchical map of your current test suite structure.
  • Understand permissions immediately. Before running anything critical, use get_user_info to confirm which user context and credentials your agent is operating under.

Real-World Use Cases

01

Need all regression tests for v2.1

A QA Lead needs to scope a new round of testing. They run list_test_projects to find the main 'V2' project ID. Then, they use that ID with list_test_plans to pull every active test plan, ensuring no regression cycle is missed.

02

Developer needs bug steps for review

A developer receives a bug report but doesn't know the exact failure criteria. They ask their agent to look up Test Case ID 5440 using get_test_case_details. The agent immediately returns the required preconditions and step-by-step instructions.

03

Checking current coverage gaps

A Test Engineer wants to see what test suites are in Project Alpha. They run list_test_suites using the project ID, which gives them a clear directory listing they can then use to drill down and check specific cases.

04

Confirming target build versions

The QA team is ready to execute tests for Plan XYZ. Before starting, they run list_test_builds using the plan ID. This instantly confirms if the required QA target version is available and linked.

The Tradeoffs

Asking for 'all test data'

Prompting: 'Give me everything about testing.' The agent fails because you didn't provide a starting scope (Project ID or Plan ID).

Start with the highest scope first. Run list_test_projects to get the Project IDs, then use those IDs for list_test_plans. Always define your boundaries.

Confusing suite and plan details

Asking: 'What are the plans in this suite?' The agent will fail because a Test Suite is nested inside a Plan, not the other way around.

Use get_test_suite_details to understand the structure. If you need plans, always reference the parent Project ID first via list_test_plans.

Forgetting authentication context

Running complex queries without confirming user scope, leading to permission errors or incomplete results.

Always run get_user_info first. This confirms the API token is authenticating as expected and that your agent has the necessary permissions.

When It Fits, When It Doesn't

Use this server if you are working with structured, multi-layered test data (Project -> Plan -> Suite -> Case). You need to read specific metadata, preconditions, or build lists from a self-hosted TestLink instance. Don't use it just because you have general bug tracking—this is for formal quality assurance structure.

Don't use this if:
1. Your primary goal is writing reports (Use a dedicated reporting tool).
2. You only need to track raw tickets (Use a standard issue tracker API).
3. The data you need isn't nested under the TestLink schema. For those cases, an unstructured database connector might be better.

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by TestLink. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

VINKIUS INFRASTRUCTURE

Cloud Hosted

Managed infra

V8 Isolated

Sandboxed per request

Zero-Trust Proxy

No stored credentials

DLP Enforced

Policy on every call

GDPR Compliant

EU data residency

Token Compression

~60% cost reduction

How we secure it →

Works with Claude, ChatGPT, Cursor, and more

The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.

This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.

Available Capabilities

get_test_case_details get_test_plan_details get_test_project_details get_test_suite_details get_user_info list_test_builds list_test_cases list_test_plans list_test_projects list_test_suites

Navigating test environments used to feel like clicking through ten different tabs in a browser.

Today, finding specific test data is a pain. You start on the Project dashboard, then click into Plan X. Once there, you have to drill down to the Suite folder, and finally find the Test Case ID under that structure. If you need three different pieces of info—say, preconditions, builds, and plan details—you copy-paste between four different pages just to compile a single report.

With this MCP server, it’s direct. You tell your agent: 'Give me the preconditions for Test Case ID 5440 and list all associated test builds.' The toolset runs `get_test_case_details` and `list_test_builds` simultaneously and sends you a single, clean output block. No clicks required.

TestLink MCP Server: Get the full context of any Test Case.

Before this toolset, getting full context meant checking multiple views—the main case view for steps, a separate tab for preconditions, and another screen to check related builds. It was tedious copy-pasting just to confirm the status quo.

Now, you use `get_test_case_details`. You get all that data in one go: the manual steps, the expected result, the priority, and the necessary prerequisites—all pulled into your chat window instantly.

Common Questions About TestLink MCP

How do I list all projects using list_test_projects? +

Run list_test_projects with no arguments. It returns a list of every major project ID available on the server, which you can then use for subsequent queries.

What is the difference between list_test_plans and list_test_suites? +

list_test_projects gives you projects. You must first find a Project ID, and then you can run list_test_plans on that project to get plans; suites are nested deeper within the plan structure.

Can I check who my API token is? +

Yes, use get_user_info. This tool runs a check against the server and confirms your user identity and associated privileges for the current session.

Do I need to provide an ID every time I call get_test_case_details? +

Yes. get_test_case_details requires a specific Test Case ID as an argument. You can't query it without knowing the exact identifier.

How do I use list_test_builds to check which versions are available for a test plan? +

You must pass the specific Test Plan ID to list_test_builds. This returns all software builds linked to that plan's scope, letting you verify if your test steps align with the exact QA target version you need to validate against.

What happens if I use get_test_suite_details with an incorrect ID? +

The function immediately returns a specific error code stating that the requested resource was not found. This confirms either the Suite ID is wrong or it doesn't belong to the Project ID you provided, allowing you to fix your query scope fast.

Does get_test_case_details provide all necessary information in one call? +

Yes. It retrieves comprehensive details including preconditions, manual step sequences, expected results, and priority levels. You don't need to jump through the legacy UI just to compile a single report.

If I call list_test_cases many times in quick succession, are there usage limits? +

Vinkius manages standard rate limiting for this endpoint. Too many calls in a short time will result in an HTTP 429 error. Wait a minute or two and try again to avoid service disruption.

Why should I plug an AI agent into an older legacy application like TestLink? +

Because retrieving test assets from older GUIs can be painfully slow for developers. By mapping the database to an AI agent, your devs can just chat: 'What are the steps to reproduce Test Case 4022?' The agent calls the XML-RPC backend and instantly formats the manual steps logically in the chat space.

Can it read all my hierarchical QA Suites and specific cases? +

Yes! The testlink agent is configured to retrieve Suites. You just list a Project ID, traverse downwards into Test Suites, and then request Test Cases by the retrieved Suite ID. It allows full architectural transparency over chat.

Does my TestLink server need to be accessible to the internet? +

No. Because MCP servers process logic strictly locally through a sidecar setup, the interaction happens right on your machine/endpoint. As long as the machine running the AI client (e.g. Cursor, Claude Desktop) can resolve the Internal Network URL, the connection is solid.

More in this category

You might also like

Built & Managed by Vinkius 30s setup 10 tools

We've already built the connector for TestLink. Just plug in your AI agents and start using Vinkius.

No hosting. No infrastructure. No complex setup.
All 10 tools are live and waiting. You're up and running in seconds.

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
+ other MCP clients

Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.

Zero hosting required Full MCP catalog included Enterprise-grade security Auto-updated by Vinkius

Built, hosted, and secured by Vinkius. You just connect and go.