Jira Insights MCP Server

A Model Context Protocol server for Jira Insights (JSM) schemas

Local serverstdioTypeScript

What is the Jira Insights MCP MCP server?

A Model Context Protocol server for Jira Insights (JSM) schemas. That is what the jira insights mcp mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.

The short version

This MCP server provides tools for interacting with Jira Insights (JSM) asset schemas through the Model Context Protocol. It allows you to manage object schemas, object types, and objects in Jira Insights.

  • Manage object schemas (create, read, update, delete)
  • Manage object types (create, read, update, delete)
  • Manage objects (create, read, update, delete)
  • Query objects using AQL (Atlassian Query Language)

The tools it exposes

The server publishes 4 tools. What each one is for:

  • manage_jira_insight_schema — The manage_jira_insight_schema tool exposed by this server
  • manage_jira_insight_object_type — The manage_jira_insight_object_type tool exposed by this server
  • manage_jira_insight_object — Manage Jira Insights objects with CRUD operations and AQL queries
  • Scripts — The Scripts tool exposed by this server

What it needs from you

Configuration is passed through the environment: JIRA_API_TOKEN, JIRA_EMAIL, JIRA_HOST, LOG_MODE. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

  • Node.js 20 or later - Docker (for containerized deployment) - Jira Insights instance with API access - Jira API token with appropriate permissions

Getting it running

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.

How it compares

Among the planning and project tracking options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Jira Insights MCP's toolset — manage_jira_insight_schema, manage_jira_insight_object_type, manage_jira_insight_object and 1 more — is a fair guide to whether it matches your workflow. It is maintained by aaronsb; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Jira Insights MCP's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
manage_jira_insight_schemaThe manage_jira_insight_schema tool exposed by this server.
manage_jira_insight_object_typeThe manage_jira_insight_object_type tool exposed by this server.
manage_jira_insight_objectManage Jira Insights objects with CRUD operations and AQL queries.
ScriptsThe Scripts tool exposed by this server.

How to install the Jira Insights MCP MCP server

{
  "mcpServers": {
    "jira-insights": {
      "command": "node",
      "args": ["/path/to/jira-insights-mcp/build/index.js"],
      "env": {
        "JIRA_API_TOKEN": "your-api-token",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_HOST": "https://your-domain.atlassian.net",
        "LOG_MODE": "strict"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Node.js 20 or later - Docker (for containerized deployment) - Jira Insights instance with API access - Jira API token with appropriate permissions
VariableDescriptionRequired
JIRA_API_TOKENCredential the server authenticates with.Yes
JIRA_EMAILConfiguration value read at startup.Optional
JIRA_HOSTEndpoint or connection string the server talks to.Optional
LOG_MODEConfiguration value read at startup.Optional

Example prompts to try

  • Use Jira Insights MCP to manage jira insight schema.
  • Use Jira Insights MCP to manage jira insight object type.
  • Use Jira Insights MCP to manage jira insight object.

Frequently asked questions

It connects Jira Insights MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 4 tools (manage_jira_insight_schema, manage_jira_insight_object_type, manage_jira_insight_object, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Jira Insights MCP directly.