Jira
Projects, issues, comments, and workflow transitions on Jira Cloud.
Overview
Connect Jira Cloud to give AI clients access to your projects and issues for planning, triage, and workflow updates.
Prerequisites
- A Jira Cloud site you can access
- A stackgate.ai account
Getting credentials
- Sign in to stackgate.ai.
- Go to Integrations and open Jira.
- Click Activate, then Connect Jira.
- Approve the Atlassian OAuth prompt and grant access to your Jira Cloud site.
No manual API tokens are required.
Using with AI clients
- Dedicated endpoint:
POST /mcp/jirawith a Sanctum bearer token - Private gateway: one config for all integrations — use
jira__*namespaced tools
Typical workflow: list projects → search issues with JQL → get issue details → create or update issues → add comments → transition workflow status.
See Documentation for HTTP authentication and private gateway setup.
Troubleshooting
- 422 integration not configured — complete the OAuth connect flow in My Integrations.
- Token expired or revoked — disconnect and reconnect Jira from the integration page.
- Wrong Jira site — if you have multiple Jira Cloud sites, reconnect and approve the correct site during OAuth.
- 429 rate limit — Atlassian may throttle heavy API usage; wait and retry, or reduce parallel tool calls.
Available tools
-
list_accessible_sites
List Jira Cloud sites accessible with the connected Atlassian account.
-
list_projects
List Jira projects accessible to the connected account.
-
get_project
Get details for a Jira project by ID or key.
-
search_issues
Search Jira issues using JQL.
-
get_issue
Get full details for a Jira issue by ID or key.
-
create_issue
Create a new Jira issue in a project.
-
update_issue
Update fields on an existing Jira issue.
-
add_issue_comment
Add a comment to a Jira issue.
-
list_issue_transitions
List available workflow transitions for a Jira issue.
-
transition_issue
Transition a Jira issue to a new workflow status.
MCP endpoint:
https://stackgate.ai/mcp/jira
(HTTP) or via the
private gateway.