run_action
Run an action by its identifier.
DISCOVERY WORKFLOW:
1. Use list_actions tool to discover all available actions and their identifiers
2. Use list_actions tool with the specific action identifier to get:
- The exact action definition
- Required input properties and their schemas
- Whether entityIdentifier is needed (check if trigger.blueprintIdentifier exists AND trigger.operation is "DAY-2" or "DELETE")
- Property types, formats, constraints, and required fields
3. Format the properties object according to the action's trigger.userInputs.properties schema
4. Call run_action with the actionIdentifier, properties, and optionally entityIdentifier
ENTITY IDENTIFIER REQUIREMENTS:
- entityIdentifier is ONLY required when trigger.blueprintIdentifier exists AND trigger.operation is "DAY-2" or "DELETE"
- If trigger.blueprintIdentifier is undefined/missing, do NOT provide entityIdentifier regardless of the operation type (including DAY-2 and DELETE)
- Many DAY-2 and DELETE actions do NOT have a blueprintIdentifier and do NOT need an entityIdentifier
- When entityIdentifier IS required, use list_entities tool with the blueprint identifier from trigger.blueprintIdentifier to find valid values
- Do NOT refuse to run an action just because it is DAY-2 or DELETE - check trigger.blueprintIdentifier first
PROPERTY FORMATTING:
- Always check list_actions (with identifiers) response for the exact property schema
- Match property types, formats, and constraints exactly as defined
- Include all required properties as specified in trigger.userInputs.required
load_skill
Load specialized guidance for a domain-specific task.
Skills provide step-by-step instructions for common workflows. Load a skill BEFORE starting a specialized task to ensure consistent, thorough handling.
**Available Skills:**
- action-permissions-helper: Help users configure permissions for self-service actions, with focus on dynamic permission policies. Use when users need help with execute/approve permissions, JQ conditions, or catalog queries for access control.
- mapping-assistant: Help users create, modify, or troubleshoot integration mapping configurations. Use when users ask about mapping, JQ expressions, or data transformation for integrations.
- skill-creator: Create and register custom AI skills in Port. Use when users ask to create a skill, build a skill, write a skill, or ask "Can you create it as a skill?" This skill guides through writing effective skill content and registering it as a Port entity.
- troubleshoot-integration: Diagnose and resolve integration sync issues, mapping errors, and data problems. Use when users report missing data, sync failures, or integration errors.
- troubleshoot-scim: Diagnose and resolve SCIM provisioning issues, including group provisioning errors, missing users, compatibility issues, and login problems. Use when customers report SCIM-related issues with Azure EntraID, Okta, JumpCloud, Google Workspace, or any SCIM 2.0 compatible IdP.
- workflows: Create or update Port workflows with triggers, action nodes, conditions, and data flow. Use when users ask to create, update, or modify a workflow—including adding, updating, or removing individual nodes, connections, or user inputs.
**Usage:**
- load_skill({ name: "skill-name" }) → Returns main instructions + list of available resources
- load_skill({ name: "skill-name", resource: "references/REFERENCE.md" }) → Returns specific resource content
search_port_knowledge_sources
Perform semantic retrieval over the documentation and other knowledge sources of Port and return the most relevant chunks for a given query. A "chunk" is a short, self-contained snippet of text taken from a single page or item within these sources (for example, part of a documentation page) and includes its source URL and markdown content. Chunks are returned in descending order of relevance to the query, and the tool always returns a fixed number of chunks (top-k). If the knowledge sources do not contain information relevant to the query, the returned chunks may be only weakly related or entirely unrelated. Use this tool anytime you need information about Port.