Connect your AI Agents to Jira in minutes

Merge lets you securely connect your agents to Jira and thousands of tools instantly

Available tools

add_comment

Add a comment to a Jira issue. Example: {'issue_key': 'PROJ-123', 'body': 'This is a comment'}

get_comments

Get comments for a Jira issue

update_comment

Update a comment on a Jira issue

delete_comment

Delete a comment from a Jira issue

create_issue

Create a Jira issue. REQUIRED format: {'fields': {'project': {'key': 'PROJECT_KEY'}, 'issuetype': {'name': 'Bug|Task|Story'}, 'summary': 'Issue title'}}. Optional in fields: description (text), priority ({'name': 'High|Medium|Low'}), assignee ({'accountId': 'id'}), labels ([strings]).

get_issue

Get Jira issue details using the issue key

update_issue

Update a Jira issue. Required: issue_key. Optional: summary, description, priority, assignee, labels, components, fixVersions, duedate. Only provided fields will be updated. Example: {'issue_key': 'PROJ-123', 'summary': 'Updated title', 'priority': {'name': 'High'}}

delete_issue

Delete a Jira issue

link_issues

Link two Jira issues. REQUIRED: outward_issue (FROM), inward_issue (TO), link_type. Common types: 'Duplicate' (marks FROM as duplicate of TO), 'Relates', 'Blocks'. Example: {'outward_issue': 'PROJ-1', 'inward_issue': 'PROJ-2', 'link_type': 'Duplicate'}

transition_issue

Transition a Jira issue to a new status. Provide either transition_id or transition_name. Example: {'issue_key': 'PROJ-123', 'transition_name': 'In Progress', 'comment': 'Starting work'}

search_issues

Search Jira issues using JQL or structured filters. IMPORTANT: By DEFAULT, searches ALL statuses (including Done, Closed) unless explicitly filtered. Use 'resolution' field to filter open issues if needed. DIRECT JQL: {'jql': 'project = PROJ AND status = "Done"'}. STRUCTURED: {'project': 'PROJ', 'text_search': 'x47'}. For open issues only, add 'resolution': 'Unresolved'. Unbounded search query is not allowed; at least one parameter must be provided. Supports pagination (start_at, max_results), date filters (created_after, updated_after), text search (text_search, summary_contains), labels, priority, and field customization (fields, expand). Returns issues with total count and pagination metadata.

get_issue_transitions

Get available transitions for a Jira issue

How to set up Merge Agent Handler

In an mcp.json file, add the configuration below, and restart Cursor.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5      "headers": {
6        "Authorization": "Bearer yMt*****"
7      }
8    }
9  }
10}
11
Copy Code

Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.

Make sure Claude is using the Node v20+.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "command": "npx",
5      "args": [
6        "-y",
7        "mcp-remote@latest",
8        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9        "--header",
10        "Authorization: Bearer ${AUTH_TOKEN}"
11      ],
12      "env": {
13        "AUTH_TOKEN": "yMt*****"
14      }
15    }
16  }
17}
Copy Code
Copied!

Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.

Learn more in the official documentation ↗

1{
2    "mcpServers": {
3      "agent-handler": {
4        "command": "npx",
5        "args": [
6          "-y",
7          "mcp-remote@latest",
8          "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9          "--header",
10          "Authorization: Bearer ${AUTH_TOKEN}"
11        ],
12        "env": {
13          "AUTH_TOKEN": "<ah-production-access-key>"
14        }
15      }
16    }
17  }
Copy Code

In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".

You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.

Learn more in the official documentation ↗

1{
2  "inputs": [
3    {
4      "type": "promptString",
5      "id": "agent-handler-auth",
6      "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7      "password": true
8    }
9  ],
10  "servers": {
11    "agent-handler": {
12      "type": "stdio",
13      "command": "npx",
14      "args": [
15        "-y",
16        "mcp-remote@latest",
17        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18        "--header",
19        "Authorization: Bearer ${input:agent-handler-auth}"
20      ]
21    }
22  }
23}
Copy Code

FAQs on using Merge's Jira  MCP server

FAQs on using Merge's Jira  MCP server

How can I use the Jira MCP server?

Your use cases depend on the type of agent you’re building. That said, here are a few common use cases:

  • Combine data sources for broader insights: Your agent can combine information from Jira with other data sources (e.g., your survey tool) to uncover broader insights, such as correlating sprint velocity with customer satisfaction metrics
  • Manage issues or projects from Slack: Your agent can help users retrieve information on specific Jira issues from an app like Slack to quickly understand their status, details, history, and more. The user can also ask the agent to make specific updates on an issue without leaving Slack
  • Deliver consistent product updates to leadership: Your agent can send the executive team weekly summaries of the product-specific tickets created in Jira over the past week within Slack; this lets them understand the top issues and, depending on the insights, it can help them make effective resource allocation decisions over time
  • Coordinate development workflows: Your agent can automatically create Jira issues when critical bugs are detected in production, link them to related GitHub pull requests, and assign them to the appropriate developers based on code ownership

What are popular tools for Jira’s MCP server?

Here are some of the most common tools segmented by data types:

Issues

  • <code class="blog_inline-code">search_issues</code>
  • <code class="blog_inline-code">get_issue</code>
  • <code class="blog_inline-code">get_issue_attachments</code>
  • <code class="blog_inline-code">update_issue</code>
  • <code class="blog_inline-code">add_comment</code>

Projects

  • <code class="blog_inline-code">get_projects</code>
  • <code class="blog_inline-code">get_project_statuses</code>
  • <code class="blog_inline-code">create_project</code>
  • <code class="blog_inline-code">update_project</code>

Boards

  • <code class="blog_inline-code">get_board</code>
  • <code class="blog_inline-code">get_board_sprints</code>
  • <code class="blog_inline-code">create_board</code>

What makes Merge Agent Handler’s Jira MCP server better than alternative Jira MCP servers?

Merge Agent Handler differentiates itself by operating as a full agent–tool management platform, not just an MCP endpoint.

  • Enterprise-grade security and DLP: All Jira tool inputs and outputs pass through a security gateway that can block, redact, or mask sensitive data based on default or custom rules. This helps prevent data leakage when agents create or update Jira issues
  • Managed authentication and credentials: Merge Agent Handler handles Jira authentication flows, credential storage, and token validation, removing this burden from your agent code
  • Real-time observability and audit trail: Every Jira tool call is logged with full context. Logs are fully searchable, enabling teams to audit agent behavior, debug failures, and optimize workflows
  • Tool Packs and controlled access: Jira tools can be bundled with other MCP connectors (e.g., Slack, Salesforce) into Tool Packs, allowing precise control over which Jira actions an agent is allowed to perform

Can I set custom security rules for Jira tool calls with Merge Agent Handler?  

Yes, you can set custom security rules for any Jira tool calls to block or redact sensitive data. You can also log certain tool calls, allowing the agent to make them while providing your team with real-time visibility whenever this happens.

Here are some specific examples:

  • Block your agents from creating or updating Jira issues with credit card numbers in fields like descriptions and comments
  • Automatically redact SSNs when your agents retrieve or update Jira issue details. That way,  they only see masked versions
  • Monitor and log whenever your agents attempt to add authentication credentials or access tokens in Jira issue comments or descriptions
  • Block your agents from creating Jira tickets with sensitive terms like "confidential", "internal only", or proprietary project codenames in the summary or description fields

How can I add tools to Merge Agent Handler’s Jira MCP server?

You can add or modify Jira tools using Connector Studio within Merge Agent Handler:

1. Start from a pre-built Jira connector: Log into the Agent Handler dashboard and navigate to "Connectors" in the sidebar. Select the Jira connector from the list of available connectors.

2. Enable or disable specific Jira tools in a Tool Pack: Navigate to "Tool Packs" and either create a new Tool Pack or select an existing one. Add the Jira connector to your Tool Pack, then choose which specific Jira tools you want to make available to your agent.

3. Customize/extend tools, or add tools tailored to your workflows: Within Connector Studio, you can modify existing Jira tools by editing their names, descriptions, input schemas, and implementation logic. You can also create entirely new custom tools for Jira-specific actions that aren't available by default, such as custom field updates or advanced query filters.

4. Associate the updated Tool Pack with your agent: Once you've configured your Jira tools, save your Tool Pack. Then connect it to your agent using the MCP entry URL provided in the Tool Pack settings. Your agent will now have access to exactly the Jira tools you've configured, with all authentication, security rules, and logging handled automatically by Agent Handler.

Explore other MCP servers built and managed by Merge

airtable
Airtable
asana
Asana
calendly
Calendly
confluence
Confluence
figma
Figma
github
GitHub
gmail
Gmail
gong
Gong
google_calendar
Google Calendar
google_drive
Google Drive
greenhouse
Greenhouse
hubspot
HubSpot
intercom
Intercom
jira_service_management
Jira Service Management
linear
Linear
microsoft_teams
Microsoft Teams
notion
Notion
onedrive
OneDrive
outlook
Outlook
pipedrive
Pipedrive
quickbooks_online
QuickBooks Online
sapsf
SAP SuccessFactors
salesforce
Salesforce
servicenow
ServiceNow
sharepoint
SharePoint
shopify
Shopify
slack
Slack
stripe
Stripe
weather
Weather
wikipedia
Wikipedia
zendesk
Zendesk
zoom
Zoom

Ready to try it out?

Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now