TestLink MCP. Query the entire test management structure via chat.
Works with every AI agent you already use
…and any MCP-compatible client
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.
Runs list_test_projects to retrieve a list of every test project on the server.
Uses get_test_plan_details to pull all metadata associated with a chosen test plan.
Runs list_test_suites or list_test_cases to map out the full folder and category tree of your tests.
Calls get_test_case_details to output manual steps, expected results, and preconditions for a single ID.
Executes list_test_builds to confirm which versions of the application are tied to a specific test plan.
Runs get_user_info to check the API token's authenticated status and permissions within TestLink.
Ask AI about this MCP
Supported MCP Clients
Waiting for input…
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.
019d7611get test case details
Retrieves the full manual steps, expected results, and metadata for one specific test case ID.
019d7611get test plan details
Gets all details associated with a particular test plan instance.
019d7611get test project details
Retrieves general information for a specific TestLink project ID.
019d7611get test suite details
Gets details about a defined test suite, including its parent and scope.
019d7611get user info
Checks the API token's current user identity and authentication status within TestLink.
019d7611list test builds
Lists all available software builds that are linked to a specific test plan ID.
019d7611list test cases
Outputs a list of every individual test case found within a designated test suite.
019d7611list test plans
Lists all defined test plans that belong to a specific project ID.
019d7611list test projects
Retrieves a directory listing of every major test project on the server.
019d7611list 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
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 First, subscribe to the server. You need to provide your instance Base URL and a developer API Key.
- 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 The agent runs the necessary tool (
list_test_plansorget_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.
Needs to recall exact, step-by-step instructions from old test cases and paste them directly into markdown for documentation.
Must pull a list of all active test plans across multiple projects to define the scope for a new regression cycle.
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_projectsto 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_buildswith a plan ID to confirm exactly which software versions are tracked against that test scope. - Map out the coverage area. Run
list_test_suitesafter identifying a project usinglist_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_infoto confirm which user context and credentials your agent is operating under.
Real-World Use Cases
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.
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.
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.
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
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
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Auth0
Manage IAM operations—users, clients, connections, and logs in your Auth0 tenant directly via your AI agent.
Text Diff Engine
Exact character-by-character string comparison. Stop relying on LLM summaries and get absolute text diffs for code and contracts.
WordPress Plugin Auditor
This MCP gives your AI agent the ability to securely list and audit all installed plugins on a WordPress site. Perfect for security sweeps, maintenance reports, and identifying outdated or inactive plugins.
You might also like
Replicate Extended
Automate machine learning workflows via Replicate — run models, manage predictions, and search for AI assets directly from any AI agent.
Infura (Ethereum Node RPC Provider)
Access Ethereum blockchain data via Infura — query blocks, check balances, estimate gas, and interact with smart contracts directly from any AI agent.
HubSpot Marketing Hub
Manage marketing emails, forms, contact lists, campaigns, and landing pages through natural conversation.