Skip to main content
The Ravenna MCP server provides tools covering ticket management, user administration, access control, workflows, analytics, and workspace configuration. Your AI client automatically discovers tool schemas and parameters when it connects to the server.
You do not need to memorize tool names or parameters. Your AI client discovers them automatically. This page helps you understand what is possible so you can ask your assistant the right questions.

​
Tickets

Manage the full lifecycle of tickets in your workspace.

List tickets

Retrieve tickets from your workspace with optional filters.
  • View all tickets or filter by status, assignee, or channel
  • Build custom reports by combining with other tools
  • Monitor ticket queues for triage
Fetch full details for a specific ticket including messages, status, and metadata.
  • Review complete ticket history
  • Check current status and assignee
  • Retrieve custom field values
Create a new ticket with a title, description, and optional fields like priority, category, and assignee.
  • Log new requests from conversations
  • Create follow-up tickets from existing work
Create multiple tickets in a single operation.
  • Set up recurring tasks from a template
  • Log multiple related requests at once
  • Seed tickets for a new project or initiative
Modify ticket fields such as status, priority, assignee, category, or custom fields.
  • Reassign tickets during triage
  • Update priority based on new information
  • Change status as work progresses
Perform across tickets to find relevant results by meaning, not just exact keywords.
  • Find related tickets when investigating an issue
  • Locate duplicates before creating new tickets
  • Search across all ticket content including messages
Identify tickets that may be duplicates of each other.
  • Reduce duplicate work by finding existing tickets
  • Clean up ticket backlogs
  • Merge related requests
Move tickets between channels, individually or in bulk.
  • Route tickets to the correct team
  • Reorganize work across channels
  • Perform bulk moves for channel restructuring
Control ticket visibility by sharing or unsharing tickets across channels.
  • Share tickets with additional teams for collaboration
  • Remove shared access when no longer needed
  • Bulk share tickets for cross-team initiatives
Permanently remove a ticket from the workspace.
  • Clean up test or accidental tickets
  • Remove spam submissions
Retrieve child tickets linked to a parent ticket.
  • View sub-tasks of a larger project
  • Track progress across related work items

​
Ticket messages

Add and manage messages on tickets to track communication and progress.
Retrieve all messages on a specific ticket.
  • Review the full conversation history
  • Summarize ticket activity for stakeholders
  • Search for specific updates within a ticket
Add a new message to a ticket.
  • Post updates or status changes
  • Add internal notes for your team
  • Reply to requester questions
Edit an existing message on a ticket.
  • Correct information in a previous update
  • Add additional context to a message
Fetch a specific message by its unique identifier.
  • Retrieve the exact content of a particular message
  • Reference a specific update in another context
Remove a message from a ticket.
  • Delete messages posted in error
  • Remove outdated information

​
Ticket statuses

Define and manage the status options available for tickets in your workspace.
Retrieve all ticket statuses configured in the workspace.
  • View available status options for ticket updates
  • Audit your status workflow
Fetch details for a specific status.
  • Check status configuration and properties
Add a new status option to the workspace.
  • Extend your workflow with additional stages
  • Add custom statuses for specific processes
Modify an existing status, such as its name or order.
  • Rename statuses to match updated workflows
  • Reorder statuses in the pipeline
Remove a status from the workspace.
  • Clean up unused status options
  • Simplify your ticket workflow
Retrieve the number of tickets in each status.
  • Generate quick status reports
  • Monitor queue health and workload distribution
  • Identify bottlenecks in your workflow

​
Ticket tags

Organize and classify tickets with tags.
Retrieve all tags in the workspace.
  • View available tags before applying them
  • Audit tag usage across the workspace
Create a new tag for classifying tickets.
  • Add tags for new projects or initiatives
  • Create tags for specific issue types
Modify a tag’s name or properties.
  • Rename tags to match updated conventions
Remove a tag from the workspace.
  • Clean up unused or deprecated tags
Remove multiple tags at once.
  • Clean up tag sprawl across the workspace
  • Remove tags from a completed project
Create relationships between tickets and external resources.

​
Task items

Manage individual task items within tickets for granular work tracking.
Retrieve task items for a ticket.
  • View the checklist of sub-tasks on a ticket
  • Check completion status of individual items
Retrieve task items assigned to the current user across the current workspace.
  • View your personal task list with linked ticket context (queue and ticket number)
  • Filter by completion status to focus on open work
  • Paginate through results for large task lists
Add a new task item to a ticket.
  • Break down tickets into actionable steps
  • Add checklist items during triage
Modify a task item, such as marking it complete or changing its description.
  • Track progress on individual steps
  • Update task details as requirements change
Remove a task item from a ticket.
  • Remove tasks that are no longer relevant

​
Task templates

Create and manage reusable task templates that can be applied to tickets.
Retrieve all task templates in the workspace.
  • View available templates for common processes
  • Audit template usage
Fetch details for a specific task template including its items.
  • Review template content before applying
  • Check template configuration
Create a new task template with a set of predefined items.
  • Standardize processes like onboarding or incident response
  • Create checklists for recurring procedures
Modify an existing task template.
  • Add or remove items from a template
  • Update template names or descriptions
Remove a task template from the workspace.
  • Clean up outdated or unused templates

​
Categories

Organize tickets into categories for classification and routing.
Retrieve all categories in the workspace.
  • View the category structure
  • Find the correct category for ticket assignment
Fetch details for a specific category.
  • Check category configuration and properties
Add a new category to the workspace.
  • Set up categories for new service areas
  • Add sub-categories for more specific classification
Modify a category’s name or properties.
  • Rename categories to match updated team structures
Remove a category from the workspace.
  • Clean up unused categories

​
Channels

Manage the channels (queues) where tickets are received and organized.
Retrieve all channels in the workspace.
  • View your channel structure
  • Find channels for ticket routing
Fetch details for a specific channel.
  • Check channel configuration and settings
Create a new channel for receiving tickets.
  • Set up channels for new teams or service areas
  • Create dedicated channels for specific ticket types
Modify channel settings such as name, description, or configuration.
  • Update channel details as team structures change
Remove a channel from the workspace.
  • Clean up unused or deprecated channels

​
Custom fields

Define custom data fields that can be added to ticket forms.
Retrieve all custom fields in the workspace.
  • View available fields for form configuration
  • Audit field usage across forms
Fetch details for a specific custom field.
  • Check field type, validation, and configuration
Define a new custom field for tickets.
  • Add fields for capturing specific data points
  • Create dropdown, text, or date fields
Modify a custom field’s properties.
  • Change field labels or validation rules
  • Update field descriptions
Remove a custom field from the workspace.
  • Clean up fields that are no longer needed

​
Custom field options

Manage the selectable options for dropdown-type custom fields.
Retrieve all options for a custom field.
  • View available choices for a dropdown field
Fetch details for a specific option.
  • Check option configuration and order
Add a new option to a custom field.
  • Extend dropdown choices as new values are needed
Modify an option’s label or order.
  • Rename options to match updated terminology
Remove an option from a custom field.
  • Clean up deprecated choices

​
Platform

​
Users

Look up and manage user accounts in your organization.
Retrieve the profile of the authenticated user.
  • Verify your connection and identity
  • Check your own permissions and role
Retrieve all users in the organization.
  • Find users for ticket assignment
  • Generate user reports
  • Audit organization membership
Fetch details for a specific user by ID.
  • Look up a user’s profile, role, and group memberships
  • Verify user details for access requests
Modify a user’s profile or settings.
  • Update user roles or properties
  • Manage user account details
Create a new user in the organization and optionally add them to a workspace. Requires organization admin privileges.
  • Onboard new team members by creating their account and workspace membership in one step
  • Create user accounts without sending invitation emails for pre-provisioned setups
  • Add users to a specific workspace with a designated role (Guest, Member, or Admin)

​
User groups

Organize users into groups for permissions, assignment, and routing.
Retrieve all user groups in the organization.
  • View team structure and group organization
  • Find groups for routing rules
Fetch details for a specific group.
  • Check group configuration and membership count
Retrieve a group along with its full member list.
  • See who belongs to a specific team
  • Audit group membership for compliance
Retrieve a group with its members and associated workspaces.
  • View the full scope of a group’s access
  • Audit cross-workspace permissions
Create a new user group.
  • Set up groups for new teams or departments
  • Create groups for access control policies
Modify a group’s name, description, or membership.
  • Update group details as teams change
  • Add or remove members from a group

​
Organization

Retrieve information about your Ravenna organization.
Fetch details about the organization including name, settings, and configuration.
  • View organization-level settings
  • Check your organization’s configuration

​
Organization members

View members of your organization with full user details.
Retrieve all organization members with full user profile details.
  • Generate organization-wide user reports
  • Audit who has access to the organization
  • Look up members across all workspaces

​
Workspaces

Manage the workspaces within your organization.
Retrieve all workspaces in the organization.
  • View your workspace structure
  • Find workspaces for cross-workspace operations
Fetch details for a specific workspace.
  • Check workspace configuration and settings
Create a new workspace within the organization.
  • Set up workspaces for new departments or teams
Modify workspace settings.
  • Update workspace name, description, or configuration

​
Workspace members

View members of a specific workspace.
Retrieve all members of a workspace.
  • View who has access to a specific workspace
  • Audit workspace membership
Retrieve workspace members with full user profile data.
  • Generate workspace-specific user reports
  • Look up member details for assignment or routing

​
Applications

Manage the applications in your organization that users can request access to.
Create a new application in the organization with a name and optional description, workspace associations, and archived status.
  • Onboard a new SaaS app or internal tool into your access catalog
  • Provision applications programmatically as part of IT setup
  • Associate the application with one or more workspaces at creation time

​
Access policies

Configure and manage access control policies for applications and resources.
Retrieve all access policies in the workspace.
  • View your access control configuration
  • Audit existing policies
Fetch details for a specific access policy.
  • Review policy rules and conditions
  • Check approval requirements
Define a new access policy for an application or resource.
  • Set up access controls for new applications
  • Create policies with approval workflows
Modify an existing access policy.
  • Adjust approval requirements
  • Update policy scope or conditions
Remove an access policy.
  • Clean up policies for decommissioned applications
Check whether a user meets the requirements for a specific access level.
  • Pre-screen access requests before submission
  • Verify eligibility during approval workflows
Retrieve access levels a user is eligible for.
  • Show available options during access requests
  • Determine what a user can request
Retrieve applications a user is eligible to request access to.
  • Guide users to available applications
  • Filter access request options by eligibility

​
Access levels

Define and manage the specific permissions, roles, or entitlements that users can request within an application (for example, “Admin Access”, “Read-Only”, or “Developer Role”).
Retrieve access levels across all applications in the organization, optionally filtered by application.
  • Discover what access can be requested for a given application
  • Audit access levels across the organization
Create a new access level for an application by specifying the application, provisioning method, and optional approvers or access policy.
  • Define a new requestable permission such as “Admin Access” or “Viewer Role”
  • Link the access level to an approval policy at creation time
Modify an access level’s name, description, approvers, provisioning method, or associated access policy.
  • Adjust approvers or provisioning behavior for future requests
  • Rename or relink an access level without affecting existing entitlements

​
Approval templates

Create and manage reusable, multi-round approval workflows that can be applied across access requests, ticket escalations, change management, and other workflows requiring sign-off.
Retrieve all approval templates in the organization.
  • Find existing templates when configuring workflows
  • Audit approval processes across the organization
Fetch a specific approval template, including its rounds and approver configuration.
  • Review the approval workflow before assigning it to a queue or policy
  • Inspect approver setup when troubleshooting
Define a new approval template with one or more rounds of approvers. Approvers can be specific users or groups, or dynamic options such as the requester’s manager.
  • Standardize multi-round approval workflows for reuse across the app
  • Provision templates programmatically as part of workspace setup
Modify the rounds or approver configuration on an existing template. Changes affect new workflows; in-flight approvals continue with their original configuration.
  • Adjust approvers as team structures change
  • Add or reorder rounds without rebuilding downstream workflows

​
Automation

​
Code actions

Manage automated code actions that execute custom logic.
Retrieve all code actions in the workspace.
  • View available automations
  • Audit existing code actions
Fetch details for a specific code action including its configuration and status.
  • Review action logic and settings
  • Check activation status
Define a new code action with custom logic.
  • Build custom automations for your workspace
  • Create actions that integrate with external APIs
Modify a code action’s configuration or logic.
  • Update action behavior
  • Fix issues in existing actions
Remove a code action from the workspace.
  • Clean up unused automations
Run analysis on a code action to validate its logic.
  • Check for errors before activation
  • Validate action configuration
Enable a code action so it runs in production.
  • Deploy new automations
  • Re-enable previously disabled actions

​
Agents

Configure the AI agents that handle conversations, route requests, and automate work in your workspace.
Retrieve all AI agents in the workspace.
  • View available agents and their configuration
  • Audit agent deployment across channels
Fetch details for a specific agent including its capabilities, rules, and connected channels.
  • Review agent configuration before changes
  • Check which knowledge sources and tools are enabled
Create a new AI agent with a name, description, and initial configuration.
  • Stand up a new agent for a specific team or domain
  • Provision agents programmatically as part of onboarding
Modify an existing agent’s name, description, capabilities, or configuration.
  • Rename agents to reflect their scope
  • Update escalation instructions or capability settings
  • Adjust which channels an agent serves
Remove an agent from the workspace.
  • Decommission agents that are no longer needed
  • Clean up test agents
Learn more about configuring agents

​
Agent rules

Manage the natural language rules that define how your agents handle specific scenarios. Rules can be workspace-level (shared across agents) or attached to individual agents.
Retrieve all agent rules in the workspace, or rules attached to a specific agent.
  • Audit the rules powering your agents
  • Find rules that reference a specific form, workflow, or knowledge folder
Fetch details for a specific rule including its title, instruction, and enabled state.
  • Review rule content before editing
  • Inspect rules referenced in incident reviews
Create a new agent rule with a title and natural language instruction. Optionally attach it to one or more agents.
  • Add a rule for a new request type your agents should handle
  • Bulk-author rules from external prompts or templates
Modify a rule’s title, instruction, or enabled state.
  • Iterate on rule wording to improve agent behavior
  • Disable a rule temporarily while debugging
Remove an agent rule from the workspace.
  • Clean up rules that are no longer relevant
  • Remove duplicates after consolidating behavior
Add an existing workspace-level rule to a specific agent.
  • Reuse a shared rule across multiple agents for consistent behavior
  • Roll out a new rule to selected agents only
Remove a rule from an agent without deleting the rule itself.
  • Stop an agent from using a shared rule while keeping it available for others
Learn more about writing agent rules

​
Workflows

Build, edit, and manage multi-step workflows directly from your AI client. Use these tools to author new workflows, adjust steps and connections, and control the workflow lifecycle.
Retrieve workflows in the workspace, with optional search by name.
  • Find an existing workflow before editing
  • Audit which workflows are active or paused
Create a new workflow with a name, description, and trigger. Optionally include initial steps and connections.
  • Draft a new workflow from a natural language description
  • Scaffold workflows programmatically as part of onboarding
Apply partial updates to a workflow’s name, description, or steps.
  • Rename a workflow to match a new process
  • Iterate on workflow logic without rebuilding it
Create a copy of an existing workflow.
  • Branch a working workflow to experiment with changes
  • Reuse a template across teams or channels
Run validation on a workflow and return a summary of issues and warnings.
  • Check for configuration problems before activating
  • Surface broken connections or missing inputs
Validate and activate a workflow so it runs on its trigger.
  • Promote a draft workflow to production
  • Re-enable a workflow after edits
Turn off a workflow so it stops running.
  • Disable a workflow that is no longer needed
  • Take a workflow offline while investigating issues
Pause a workflow temporarily without deactivating it.
  • Halt execution during maintenance windows
  • Pause a workflow while diagnosing unexpected behavior
Restore a workflow to a previous version.
  • Roll back changes after a bad edit
  • Return to a known-good configuration

​
Workflow steps

Add, update, and connect the individual steps that make up a workflow.
Fetch a workflow step with its title, description, action, inputs, and suggestions.
  • Inspect step configuration before editing
  • Review available inputs and suggested values
Add a new step to a workflow. Requires step type, action, and source.
  • Extend a workflow with additional logic
  • Insert a new action between existing steps
Apply partial updates to a step’s title, description, or action.
  • Tweak a step’s configuration without recreating it
  • Update action inputs as requirements change
Create a copy of an existing step within a workflow.
  • Reuse a configured step across branches
  • Speed up workflow authoring
Move a step up or down, or swap its position with another step.
  • Reorder steps to match execution flow
  • Restructure a workflow without rebuilding it
Remove one or more steps from a workflow.
  • Clean up unused or obsolete steps
  • Simplify a workflow during refactoring
Create a connection between two steps with an optional label.
  • Define the execution path between steps
  • Add labeled branches for conditional logic
Remove a connection between two steps.
  • Detach a branch that is no longer needed
  • Restructure workflow flow during edits
Apply partial updates to a connection’s label or criteria.
  • Adjust branch conditions
  • Rename labels to reflect updated logic

​
Workflow configuration

Discover the apps and actions available for use in workflows.
Retrieve all apps with actions that can be used in a workflow, including the available actions for each app.
  • Discover what integrations and actions are available
  • Select the right action when adding a step
Fetch a workflow’s full configuration including its steps, inputs, suggestions, and actions.
  • Inspect the complete shape of a workflow before editing
  • Audit a workflow’s configuration end to end

​
Analytics

Query analytics data and manage the dashboards and widgets that power your reporting. Use these tools to count, chart, or trend data over tickets, ticket messages, knowledge base documents, and workflow runs without paging through list results.

Query analytics chart

Run an analytics query and return aggregated, chart-ready data in a single call.
  • Count, group, or trend across tickets, ticket messages, knowledge base documents, or workflow runs
  • Pick a metric breakdown (“tickets by status”) or a time series (“ticket volume per day”)
  • Skip pagination through list tools when all you need is the aggregate
Retrieve the analytics dashboards in the workspace with a compact summary of each dashboard’s widgets.
  • Find an existing dashboard before creating a new one
  • Decide where a new widget belongs based on existing topics
View a single dashboard’s widgets with freshly-computed data, layout, and re-runnable query specs.
  • Read the current numbers on a named dashboard
  • Inspect a widget’s spec to re-run or edit its query
Create a new, empty analytics dashboard with an optional default date range and time interval.
  • Stand up a new reporting view for a team or initiative
  • Set the default view options every widget on the dashboard inherits
Modify a dashboard’s name, description, or default view options (date range and time interval).
  • Shift the reporting window for every widget on a dashboard at once
  • Rename or re-describe a dashboard as its purpose evolves
Save a chart as a persistent widget on an existing dashboard using the same query that produced the chart.
  • Pin a one-off chart for ongoing tracking
  • Build out a dashboard from a series of ad-hoc queries
Modify an existing widget — change its query, chart type, name, or description.
  • Adjust a saved widget’s grouping or aggregation
  • Rename or re-describe widgets without recreating them
Learn more about analytics dashboards
Learn more about setting up the MCP server
Last modified on June 30, 2026