Skip to main content
Your AI models and agents can use our official MCP server to access your Thena data in a simple and secure way. Connect to our MCP server natively as a new integration in AI assistants, or by using the mcp-remote module in Cursor, Windsurf, and other clients. We’re following the authenticated remote MCP spec, so the server is centrally hosted and managed. It has tools available for finding, creating, and updating objects in Thena like tickets, teams, accounts, and more — with additional functionality continuously being added.

​
Setup instructions

  1. Navigate to settings in the sidebar on web or desktop
  2. Scroll to integrations at the bottom and click add more
  3. In the prompt enter:
    • Integration name: Thena
    • Integration URL: https://mcp.thena.ai/sse
  4. Make sure to enable the tools in any new chats
  1. CTRL/CMD+Shift+J to open Cursor settings.
  2. Select MCP and Integrations.
  3. Select Add a Custom MCP Server.
  4. Add the following:
{
  "mcpServers": {
    "Thena": {
      "url": "https://mcp.thena.ai/sse",
      "headers": {}
    }
  }
}
  1. CTRL/CMD+, to open Windsurf settings.
  2. Under Cascade scroll to -> MCP servers
  3. Select Manage MCPs -> Add custom server
  4. Add the following:
{
  "mcpServers": {
    "Thena": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.thena.ai/sse"]
    }
  }
}
  1. CMD+, to open Zed settings.
  2. Add the following:
{
  "context_servers": {
    "thena": {
      "command": {
        "path": "npx",
        "args": ["-y", "mcp-remote", "https://mcp.thena.ai/sse"],
        "env": {}
      },
      "settings": {}
    }
  }
}

​
Available tools

The Thena MCP server provides tools for:
  • Accounts: Tools for retrieving and managing account information and customer data.
  • Comments: Tools for retrieving and managing comment threads and related comment data.
  • Teams: Tools for retrieving and managing team information, members, and team-related data, including team search capabilities.
  • Tickets: Tools for retrieving and managing ticket statuses and other ticket-related data, including ticket search capabilities and comprehensive analytics.
  • Workflows: Tools for retrieving and managing workflow definitions, executions, and workflow-related data.

​
Authentication

The Thena MCP server uses OAuth for authentication, which is handled at the organization level:
  1. Authentication is tied to a specific organization in your Thena account
  2. If you need to access data from a different organization, you’ll need to disconnect and reconnect to the MCP server

​
Token validity and refresh

  • Authentication tokens are valid for 30 days
  • While the server supports token refresh, some MCP clients may not actively implement this feature
  • If you start receiving 401 Unauthorized errors from the Platform API, you should re-authorize and reconnect to the MCP server

​
Example usage

Once connected, you can use natural language to interact with your Thena data:
  • “Show me all open tickets assigned to my team”
  • “Create a new ticket for customer support”
  • “Find knowledge base articles about password reset”
  • “Update the status of ticket #1234 to ‘In Progress’”
  • “List all accounts in our system”
  • “Show me the members of the engineering team”
  • “Search for teams with ‘engineering’ in the name”
  • “Find tickets with high priority status”
  • “Get the current status of workflow execution #5678”
  • “Create a new workflow for customer onboarding”
  • “Show me ticket analytics by assignee for the last month”
  • “Get ticket trends over time for Q1”
  • “Analyze ticket distribution by account”
  • “Show me custom field analytics for the engineering team”

​
Roadmap

We are actively developing the MCP server to support more capabilities such as:
  • Resources: Access and manage resources across your organization
  • Prompts: Create and manage reusable prompts for AI assistants
  • Sampling: Generate and analyze data samples for training and testing
  • Enhanced Workflow Management: Advanced workflow orchestration and monitoring capabilities
  • Team Collaboration: Enhanced team management and collaboration features
  • Account Analytics: Advanced account insights and reporting tools
Stay tuned for these exciting additions to enhance your Thena integration experience.

​
Feedback and support

We’re excited to see how you and your agents use Thena data to power your workflows. If you have questions, feedback, or requests for new MCP tools, please contact our support team.