qmetry_create_defect_or_issue
Create a new defect/issue internally in QMetry. Parameters: - projectKey (string): Project key - unique identifier for the project (default: "default") - baseUrl (string): The base URL for the QMetry instance (must be a valid URL) (default: "https://testmanagement.qmetry.com") - issueType (number...
This record as markdown: /tools/smartbear-mcp/qmetry-create-defect-or-issue.md
What qmetry_create_defect_or_issue does on SmartBear MCP
AI agents use qmetry_create_defect_or_issue to create or update resources in SmartBear MCP, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your SmartBear MCP environment.
| Parameter | Type | Required | Description |
|---|---|---|---|
baseUrl | string | — | The base URL for the QMetry instance (must be a valid URL) |
summary | string | Yes | Summary or title of the defect/issue |
tcRunID | number | — | Test Case Run ID to link this defect/issue to a test execution (optional) |
component | array | — | Component IDs associated with the issue |
issueType | number | Yes | Issue type ID (e.g. Bug, Enhancement, etc.) |
sync_with | string | — | External system to sync with (e.g. JIRA, QMetry, etc.) |
issueOwner | number | — | Owner/user ID for the issue |
projectKey | string | — | Project key - unique identifier for the project |
description | string | — | Detailed description of the defect/issue |
issuePriority | number | Yes | Issue priority ID (e.g. High, Medium, Low, etc.) |
affectedCycles | array | — | Cycle IDs affected by this issue |
affectedRelease | array | — | Release IDs affected by this issue |
Parameters from the server's own tool schema.
Why qmetry_create_defect_or_issue is rated Medium
This tool creates new data (defects/issues) in QMetry, which is reversible through normal deletion or modification operations. It does not execute arbitrary code, delete data irreversibly, move money, or trigger external side effects beyond creating a record.
From the tool's definition Tool description states 'Create a new defect/issue internally in QMetry' with required parameters for issueType, issuePriority, and summary. The 'create' operation and action of adding new defects/issues to a system are characteristic of Write operations.
Risk signalsHigh parameter count (12 properties)
Attacks that exploit this kind of access
The rule that runs qmetry_create_defect_or_issue safely
PolicyLayer is an MCP gateway: it sits between your AI agents and SmartBear MCP, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For qmetry_create_defect_or_issue, this is the rule to start with:
qmetry_create_defect_or_issue stays usable, but capped: an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect SmartBear MCP, apply this rule, and every qmetry_create_defect_or_issue call is checked against it from then on.
Questions about qmetry_create_defect_or_issue
Create a new defect/issue internally in QMetry. Parameters: - projectKey (string): Project key - unique identifier for the project (default: "default") - baseUrl (string): The base URL for the QMetry instance (must be a valid URL) (default: "https://testmanagement.qmetry.com") - issueType (number) *required*: Issue type ID (e.g. Bug, Enhancement, etc.) - issuePriority (number) *required*: Issue priority ID (e.g. High, Medium, Low, etc.) - summary (string) *required*: Summary or title of the defect/issue - description (string): Detailed description of the defect/issue - sync_with (string): External system to sync with (e.g. JIRA, QMetry, etc.) - issueOwner (number): Owner/user ID for the issue - component (array): Component IDs associated with the issue - affectedRelease (array): Release IDs affected by this issue - affectedCycles (array): Cycle IDs affected by this issue - tcRunID (number): Test Case Run ID to link this defect/issue to a test execution (optional) Output Description: JSON object containing the new create issue with id, dfid(defectID). Use Cases: 1. Create a basic defect/issue with just a summary 2. Set issueType, issueOwner, component, and affectedRelease using valid IDs from project info 3. Create defects/issues for automation or manual testing types 4. Link defects/issues to specific test case runs using tcRunID Examples: 1. Create an issue with summary 'Login Issue' json { "name": "Login Issue", "issuePriority": 2231988, "issueType": 2231983 } Expected Output: Issue created in summary details 2. Create an issue with Major priority and Bug type to Bug with summary 'Login Issue' json { "name": "Login Issue", "issuePriority": 2231988, "issueType": 2231983 } Expected Output: Issue created in summary details with priority and Bug type 3. Create an issue with summary 'Login Issue' and set issueOwner to 'John Doe' json { "name": "Login Issue", "issueOwner": 15112, "issuePriority": 2231988, "issueType": 2231983 } Expected Output: Issue created in summary details with owner, priority and Bug type 4. Create an issue with summary 'Login Issue' and link it to test case run ID 567890 json { "name": "Login Issue", "issueOwner": 15112, "issuePriority": 2231988, "issueType": 2231983, "tcRunID": 567890 } Expected Output: Issue created in summary details and linked to test case run ID 567890 5. Create an issue with summary 'Login Issue' and set description to 'User is unable to login' and owner to 'John Doe' and link it to test case run ID 567890 json { "name": "Login Issue", "issueOwner": 15112, "issuePriority": 2231988, "issueType": 2231983, "tcRunID": 567890, "description": "User is unable to login" } Expected Output: Issue created in summary details with description, owner, priority, Bug type and linked to test case run ID 567890 6. Create an issue with summary 'Login Issue' and set release to 'Release 1.0' and its associated all cycles and owner to 'John Doe' json { "name": "Login Issue", "issueOwner": 15112, "issuePriority": 2231988, "issueType": 2231983, "affectedRelease": [ 111840 ], "affectedCycles": [ 112345, 112346 ] } Expected Output: Issue created in summary details with release and associated all cycles, owner 7. Create an issue with summary 'Login Issue' and set release to 'Release 1.0' and its associated all cycle 'Cycle 1.0.1', 'Cycle 1.0.2' json { "name": "Login Issue", "issuePriority": 2231988, "issueType": 2231983, "affectedRelease": [ 111840 ], "affectedCycles": [ 112345, 112346 ] } Expected Output: Issue created in summary details with release and cycles Hints: 1. CRITICAL: name (summary), issueType, issuePriority are REQUIRED fields to create an issue 2. OPTIONAL: issueOwner, component, affectedRelease, description, tcRunID can also be provided 3. To get valid values for sync_with (igConfigurationID or internalTrackerId), issueType, issuePriority, issueOwner, component, affectedRelease, and tcRunID, call the 'project get info tools' use the following mappings: 4. - sync_with: customListObjs.component[<index>].igConfigurationID or internalTrackerId 5. - issueType: customListObjs.issueType[<index>].id 6. - issuePriority: customListObjs.issuePriority[<index>].id 7. - issueOwner: customListObjs.users[<index>].id 8. - affectedRelease: data[<index>].releaseID 9. - tcRunID: data[<index>].tcRunID (from 'Execution/Fetch Testcase Run ID') 10. If the user provides a issuePriority name (e.g. 'Blocker'), fetch project info, find the matching priority in customListObjs.issuePriority[index].name, and use its ID in the payload. If the name is not found, skip the issuePriority field and show a user-friendly message: 'Defect/issue created without issuePriority, as given issuePriority is not available in the current project.' 11. If the user provides an issueOwner name, fetch project info, find the matching issueOwner in customListObjs.users[index].name, and use its ID in the payload as issueOwner. If the name is not found, skip the issueOwner field and show a user-friendly message: 'Defect/issue created without issueOwner, as given issueOwner is not available in the current project.' 12. If the user provides an issue type name, fetch project info, find the matching type in customListObjs.issueType[index].name, and use its ID in the payload as issueType. If the name is not found, skip the issueType field and show a user-friendly message: 'Defect/issue created without issue type, as given type is not available in the current project.' 13. Release/cycle mapping is optional but useful for planning. 14. If the user wants to link or associate a release and cycle to the issue, follow these rules: 15. If the user provides a release ID, map it from projects.releases[index].releaseID in the project info response, and use that ID in affectedRelease as an array of numeric IDs. 16. If the user provides both release and cycle IDs, validate both against the current project's releases and cycles; if valid, use them in affectedCycles and affectedRelease as arrays of numeric IDs respectively. 17. If the user provides a release name, map it to its ID from project info; if a cycle name is provided, map it to its ID and use it in payload as value of field affectedRelease and affectedCycles. 18. LLM should ensure that provided release/cycle names or IDs exist in the current project before using them in the payload. If not found, skip and show a user-friendly message: 'Issue created without release/cycle association, as given release/cycle is not available in the current project.' 19. Ensure all IDs used are valid for the current QMetry project context 20. This tool is essential for defect management and test execution linkage 21. Helps maintain traceability between test executions and reported issues 22. Critical for quality assurance and defect lifecycle management 23. Use for creating issues directly from test execution contexts. It is categorised as a Write tool in the SmartBear MCP MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.
qmetry_create_defect_or_issue accepts 12 parameters: baseUrl, summary, tcRunID, component, issueType, sync_with, issueOwner, projectKey, description, issuePriority, affectedCycles, affectedRelease. Required: summary, issueType, issuePriority. The full parameter table on this page comes from the server's own tool schema.
Register the SmartBear MCP server in PolicyLayer and add a rule for qmetry_create_defect_or_issue: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches SmartBear MCP. Nothing to install.
qmetry_create_defect_or_issue is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.
Yes. Add a rate_limit block to the qmetry_create_defect_or_issue rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for qmetry_create_defect_or_issue. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
qmetry_create_defect_or_issue is provided by the SmartBear MCP server (SmartBear/smartbear-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on SmartBear, and thousands of servers like it.
This server
Across the catalogue