Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ravenna.ai/llms.txt

Use this file to discover all available pages before exploring further.

The Ravenna MCP server provides tools covering ticket management, user administration, access control, 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

​
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

​
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
Learn more about setting up the MCP server