kiwi-tcms-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| KIWI_URL | Yes | Base URL of the Kiwi TCMS instance, e.g. https://tcms.example.com | |
| KIWI_PROJECT | No | Default project/Product (name or id) | |
| KIWI_TIMEOUT | No | Timeout for JSON-RPC requests in milliseconds (default 30000) | 30000 |
| KIWI_INSECURE | No | Set to 1 to skip TLS certificate verification (for self-signed certs) | 0 |
| KIWI_PASSWORD | Yes | Kiwi TCMS password | |
| KIWI_USERNAME | Yes | Kiwi TCMS login (Auth.login) | |
| KIWI_DEFAULT_LIMIT | No | Row limit for list/filter tools (default 20) | 20 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| kiwi_pingA | Checks connectivity and credentials. Returns URL, configured Product, and product count. Use for diagnostics. |
| kiwi_list_projectsA | List Kiwi TCMS products/projects. Optional substring filter on name. |
| kiwi_list_buildsA | Builds for a product. Defaults to KIWI_PROJECT when product is omitted. |
| kiwi_list_componentsC | Components for a product. Defaults to KIWI_PROJECT when product is omitted. |
| kiwi_list_prioritiesA | All test-case priorities (Priority.filter): id and value (P1..P5 / Critical..). |
| kiwi_list_categoriesA | Test-case categories for a product. Defaults to KIWI_PROJECT when product is omitted. |
| kiwi_list_plansA | TestPlan.filter by name, product, type, and active flag. Uses KIWI_PROJECT when product is omitted. |
| kiwi_create_planA | TestPlan.create in the given product (defaults to KIWI_PROJECT) with the given type. |
| kiwi_plan_add_caseB | TestPlan.add_case: attach a test case to a test plan. |
| kiwi_search_casesA | TestCase.filter by text, plan, status, priority, category, tag, component, automation. Uses KIWI_PROJECT when plan/product are omitted. Returns total and a truncated list. |
| kiwi_get_caseA | Full test-case card (TestCase.filter by id), text returned as-is (Markdown). Optionally include related executions. |
| kiwi_create_caseA | TestCase.create in the product (defaults to KIWI_PROJECT). Category and priority accept names and are resolved to ids. If plan is set, the case is attached via TestPlan.add_case. Tags are added one by one. text is stored verbatim in Kiwi's text field (Markdown; Kiwi 12+) — no section parsing. |
| kiwi_update_caseA | TestCase.update. Priority and category accept names; status accepts a name (resolved to id) or status_id. text replaces Kiwi's text field verbatim (Markdown; Kiwi 12+) — no section parsing or merge with the current text. |
| kiwi_case_add_commentC | TestCase.add_comment as the logged-in user. |
| kiwi_case_historyB | TestCase.history: full change history (KiwiHistoricalRecords). |
| kiwi_list_runsA | TestRun.filter by summary, plan, build, product, and whether still open. |
| kiwi_create_runB | TestRun.create for a plan and build. Build accepts a name (looked up on the product / KIWI_PROJECT); manager accepts a username. |
| kiwi_run_add_caseA | TestRun.add_case: add one or more cases to the run (creates TestExecutions). |
| kiwi_run_statusB | Aggregated run stats: TestRun.filter plus TestExecution breakdown by status and failed executions. |
| kiwi_list_executionsB | TestExecution.filter by run, case, status, and assignee. |
| kiwi_update_executionB | TestExecution.update: status (id or name resolved from the execution run), build, assignee, dates. Optionally adds a comment via TestExecution.add_comment. |
| kiwi_list_classificationsC | Classification.filter: catalog required by Product.create. |
| kiwi_list_versionsB | Version.filter. Required for TestPlan.create (product_version) and Build.create. |
| kiwi_create_versionB | Version.create: value plus product (defaults to KIWI_PROJECT). |
| kiwi_list_plan_typesC | PlanType.filter: Functional, Acceptance, etc. |
| kiwi_create_plan_typeA | PlanType.create. Adds a new TestPlan type such as Functional or Acceptance. |
| kiwi_list_case_statusesC | TestCaseStatus.filter: CONFIRMED, PROPOSED, DISABLED… |
| kiwi_list_execution_statusesC | TestExecutionStatus.filter: IDLE, PASSED, FAILED, BLOCKED… |
| kiwi_list_usersC | User.filter by username. |
| kiwi_meA | User.filter with no query — the logged-in user. |
| kiwi_list_tagsA | Tag.filter. Search tags by name substring. |
| kiwi_create_tagA | Tag.create. Creates a tag that can later be attached to cases, plans, or runs. |
| kiwi_create_projectC | Product.create. classification is a name or id; defaults to the first classification. |
| kiwi_create_buildA | Build.create: name plus version (name or id). Defaults to the first product version. |
| kiwi_update_planB | TestPlan.update: name, type, product, version, text, active flag. |
| kiwi_plan_remove_caseA | TestPlan.remove_case. Unlinks a test case from the given plan. |
| kiwi_plan_treeB | TestPlan.tree: ancestry in DFS order from the root. |
| kiwi_plan_add_tagB | TestPlan.add_tag. Attaches a tag to the test plan. |
| kiwi_plan_remove_tagA | TestPlan.remove_tag. Detaches a tag from the test plan. |
| kiwi_update_runA | TestRun.update: summary, notes, build, manager, dates (set stop_date to close the run). |
| kiwi_run_get_casesB | TestRun.get_cases: run cases with execution_id and status. |
| kiwi_plan_update_case_orderC | TestPlan.update_case_order: sortkey, e.g. 10, 20, 30. |
| kiwi_run_add_tagA | TestRun.add_tag. Attaches a tag to the test run. |
| kiwi_run_remove_tagA | TestRun.remove_tag. Detaches a tag from the test run. |
| kiwi_case_add_tagB | TestCase.add_tag. Attaches a tag to the test case. |
| kiwi_case_remove_tagB | TestCase.remove_tag. Detaches a tag from the test case. |
| kiwi_case_add_componentC | TestCase.add_component: component name. |
| kiwi_case_remove_componentA | TestCase.remove_component. Unlinks a component from the test case. |
| kiwi_execution_add_linkC | TestExecution.add_link: bug, Allure, CI. Set is_defect to mark a defect. |
| kiwi_execution_get_linksA | TestExecution.get_links. Returns URLs attached to the execution (bugs, reports, CI). |
| kiwi_execution_remove_linkB | TestExecution.remove_link by link id or execution_id. |
| kiwi_case_list_attachmentsA | TestCase.list_attachments. Returns attachment metadata and download URLs. |
| kiwi_case_add_attachmentC | TestCase.add_attachment: filename plus base64 content. |
| kiwi_plan_list_attachmentsA | TestPlan.list_attachments. Returns attachment metadata and download URLs. |
| kiwi_plan_add_attachmentB | TestPlan.add_attachment. Uploads a file (filename + base64 content) to the plan. |
| kiwi_run_list_attachmentsB | TestRun.list_attachments. Returns attachment metadata and download URLs. |
| kiwi_run_add_attachmentA | TestRun.add_attachment. Uploads a file (filename + base64 content) to the run. |
| kiwi_execution_list_attachmentsB | TestExecution.list_attachments. Returns attachment metadata and download URLs. |
| kiwi_execution_add_attachmentC | TestExecution.add_attachment: logs, screenshots (base64). |
| kiwi_remove_attachmentB | Attachment.remove_attachment by id. |
| kiwi_case_propertiesB | TestCase.properties. Returns name/value properties; omit case_id to list more broadly. |
| kiwi_case_add_propertyC | TestCase.add_property: arbitrary name/value pair. |
| kiwi_case_remove_propertyC | TestCase.remove_property. Filter by case_id and/or name. |
| kiwi_run_propertiesA | TestRun.properties. Returns name/value properties for the run. |
| kiwi_run_add_propertyB | TestRun.add_property. Adds a name/value property to the test run. |
| kiwi_execution_propertiesB | TestExecution.properties. Returns name/value properties for the execution. |
| kiwi_execution_add_propertyB | TestExecution.add_property. Adds a name/value property to the execution. |
| kiwi_rpcA | Direct call to any Kiwi TCMS JSON-RPC method (https://kiwitcms.org/api/): TestPlan.remove_case, TestExecution.add_link, Bug.filter, Tag.filter, etc. Use when no specialized tool exists. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| run-summary | Kiwi TCMS test-run summary: stats, failed cases, recommendations |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| kiwi-status |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/belovdm/kiwi-tcms-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server