swagger_create_portal_product
Create a new product for a specific portal. Parameters: - portalId (string) *required*: Portal UUID or subdomain - unique identifier for the portal instance - type (string) *required*: Product creation type - 'new' to create from scratch or 'copy' to duplicate an existing product - productId (str...
This record as markdown: /tools/smartbear-mcp/swagger-create-portal-product.md
What swagger_create_portal_product does on SmartBear MCP
AI agents use swagger_create_portal_product 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 |
|---|---|---|---|
name | string | Yes | Product display name - will be shown to users in the portal navigation and product listings (3-40 characters) |
role | boolean | — | Whether the product has role-based access restrictions - controls if specific user roles are required to access the product |
slug | string | Yes | URL-friendly identifier for the product - must be unique within the portal, used in URLs (e.g., 'my-api' becomes /my-api). 3-22 characters, lowercase, alphanume |
type | string | Yes | Product creation type - 'new' to create from scratch or 'copy' to duplicate an existing product |
hidden | boolean | — | Whether the product is hidden from the portal landing page navigation menus - useful for internal or draft products |
public | boolean | — | Whether the product is publicly visible to all portal visitors - false means only authenticated users with appropriate roles can access it |
portalId | string | Yes | Portal UUID or subdomain - unique identifier for the portal instance |
productId | string | — | Source product UUID to copy from - required when type is 'copy', specifies which existing product to duplicate. Omit when type is 'new' |
description | string | — | Product description - explains what the API/product does, shown in product listings and cards (max 110 characters) |
Parameters from the server's own tool schema.
Why swagger_create_portal_product is rated Medium
The tool creates or modifies data (new product or duplicated product) in a portal system. It is reversible—created products can be deleted or modified later. While it affects portal configuration, it does not execute arbitrary code, delete data irreversibly, or move money.
From the tool's definition Tool name includes 'create' and description states 'Create a new product for a specific portal.' Parameters support creation of new entities ('type' with 'new' option) and copying existing products. This is a reversible data creation operation.
Attacks that exploit this kind of access
The rule that runs swagger_create_portal_product 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 swagger_create_portal_product, this is the rule to start with:
swagger_create_portal_product 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 swagger_create_portal_product call is checked against it from then on.
Questions about swagger_create_portal_product
Create a new product for a specific portal. Parameters: - portalId (string) *required*: Portal UUID or subdomain - unique identifier for the portal instance - type (string) *required*: Product creation type - 'new' to create from scratch or 'copy' to duplicate an existing product - productId (string): Source product UUID to copy from - required when type is 'copy', specifies which existing product to duplicate. Omit when type is 'new' - name (string) *required*: Product display name - will be shown to users in the portal navigation and product listings (3-40 characters) - slug (string) *required*: URL-friendly identifier for the product - must be unique within the portal, used in URLs (e.g., 'my-api' becomes /my-api). 3-22 characters, lowercase, alphanumeric with hyphens, underscores, or dots - description (string): Product description - explains what the API/product does, shown in product listings and cards (max 110 characters) - public (boolean): Whether the product is publicly visible to all portal visitors - false means only authenticated users with appropriate roles can access it - hidden (boolean): Whether the product is hidden from the portal landing page navigation menus - useful for internal or draft products - role (boolean): Whether the product has role-based access restrictions - controls if specific user roles are required to access the product. 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.
swagger_create_portal_product accepts 9 parameters: name, role, slug, type, hidden, public, portalId, productId, description. Required: name, slug, type, portalId. 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 swagger_create_portal_product: 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.
swagger_create_portal_product 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 swagger_create_portal_product 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 swagger_create_portal_product. 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.
swagger_create_portal_product 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