deepwired avatar

Mcp Jira Scoped

deepwired/mcp-jira

Connects to Jira through Atlassian's modern api.atlassian.com gateway using scoped API tokens (the ATATT prefix kind) instead of the classic tokens that are being phased out. Exposes 14 tools covering reads (get issue, JQL search, list comments, fetch transitions), writes (create/update/delete issues, add comments, move through workflows, link issues), and attachments. Default mode is read-only unless you explicitly grant write:jira-work scope. Delete operations require a confirm parameter as a safety guard. Scope enforcement happens server-side before API calls go out, so the AI can't accidentally exceed the permissions you've granted. Useful if you're already on scoped tokens or want proper scope boundaries between read and write operations.

GitHub stars
2
tools
44
auth
Secret needed
transport
STDIO
env vars
5
last updated
Mar 28, 2026

Tools

44 tools

Public tool metadata for what this MCP can expose to an agent.

jira_get_issueGet an issue by key. `includeCustomFields: true` returns all custom fields

Get an issue by key. `includeCustomFields: true` returns all custom fields

No parameter schema in public metadata yet.

jira_searchJQL search, paginated with `nextPageToken`. `includeTotal` adds an approximate count

JQL search, paginated with `nextPageToken`. `includeTotal` adds an approximate count

No parameter schema in public metadata yet.

jira_list_commentsList comments with IDs, authors and timestamps

List comments with IDs, authors and timestamps

No parameter schema in public metadata yet.

jira_list_projectsList accessible projects

List accessible projects

No parameter schema in public metadata yet.

jira_get_projectProject details by key

Project details by key

No parameter schema in public metadata yet.

jira_list_fieldsAll fields including custom — discover `customfield_*` IDs

All fields including custom — discover `customfield_*` IDs

No parameter schema in public metadata yet.

jira_get_transitionsAvailable transitions with their required screen fields

Available transitions with their required screen fields

No parameter schema in public metadata yet.

jira_create_issueCreate an issue, with custom field support

Create an issue, with custom field support

No parameter schema in public metadata yet.

jira_update_issueUpdate fields. Omit a field to leave it; pass `null` to clear it

Update fields. Omit a field to leave it; pass `null` to clear it

No parameter schema in public metadata yet.

jira_assign_issueAssign, or unassign with `accountId: null`

Assign, or unassign with `accountId: null`

No parameter schema in public metadata yet.

jira_transition_issueMove to a new status, with optional fields and comment

Move to a new status, with optional fields and comment

No parameter schema in public metadata yet.

jira_delete_issueDelete an issue (`confirm: true`)

Delete an issue (`confirm: true`)

No parameter schema in public metadata yet.

jira_add_commentAdd a comment (Markdown by default)

Add a comment (Markdown by default)

No parameter schema in public metadata yet.

jira_update_commentEdit an existing comment

Edit an existing comment

No parameter schema in public metadata yet.

jira_delete_commentDelete a comment (`confirm: true`)

Delete a comment (`confirm: true`)

No parameter schema in public metadata yet.

jira_get_myselfThe authenticated account. Resolves "me", and the cheapest connection check

The authenticated account. Resolves "me", and the cheapest connection check

No parameter schema in public metadata yet.

jira_get_userUser info by account ID

User info by account ID

No parameter schema in public metadata yet.

jira_search_usersFind users by name or email

Find users by name or email

No parameter schema in public metadata yet.

jira_list_attachmentsFilename, size, MIME type, uploader, download URL

Filename, size, MIME type, uploader, download URL

No parameter schema in public metadata yet.

jira_add_attachmentUpload a local file

Upload a local file

No parameter schema in public metadata yet.

jira_download_attachmentDownload to a local path

Download to a local path

No parameter schema in public metadata yet.

jira_delete_attachmentDelete by ID (`confirm: true`)

Delete by ID (`confirm: true`)

No parameter schema in public metadata yet.

jira_list_link_typesAvailable link types (Blocks, Relates, Cloners…)

Available link types (Blocks, Relates, Cloners…)

No parameter schema in public metadata yet.

jira_link_issuesLink two issues

Link two issues

No parameter schema in public metadata yet.

jira_remove_linkRemove an issue link (`confirm: true`)

Remove an issue link (`confirm: true`)

No parameter schema in public metadata yet.

jira_list_remote_linksExternal URLs attached to an issue

External URLs attached to an issue

No parameter schema in public metadata yet.

jira_create_remote_linkAttach an external URL (Confluence page, PR, doc)

Attach an external URL (Confluence page, PR, doc)

No parameter schema in public metadata yet.

jira_delete_remote_linkRemove one (`confirm: true`)

Remove one (`confirm: true`)

No parameter schema in public metadata yet.

jira_list_worklogsEntries with author, time and comment, plus the total shown

Entries with author, time and comment, plus the total shown

No parameter schema in public metadata yet.

jira_add_worklogLog work ("2h", "1d 4h")

Log work ("2h", "1d 4h")

No parameter schema in public metadata yet.

jira_update_worklogChange time, start or comment

Change time, start or comment

No parameter schema in public metadata yet.

jira_delete_worklogDelete an entry (`confirm: true`)

Delete an entry (`confirm: true`)

No parameter schema in public metadata yet.

jira_get_create_metaWhat's required to create an issue here. Lists issue types, then the required fields and their allowed values

What's required to create an issue here. Lists issue types, then the required fields and their allowed values

No parameter schema in public metadata yet.

jira_get_changelogChange history, optionally filtered to one field

Change history, optionally filtered to one field

No parameter schema in public metadata yet.

jira_list_boardsBoards, optionally filtered by project

Boards, optionally filtered by project

No parameter schema in public metadata yet.

jira_list_sprintsSprints on a board, filterable by state

Sprints on a board, filterable by state

No parameter schema in public metadata yet.

jira_get_sprint_issuesIssues in a sprint, with optional extra JQL

Issues in a sprint, with optional extra JQL

No parameter schema in public metadata yet.

jira_manage_sprintCreate, update (including start/close) or move issues into a sprint

Create, update (including start/close) or move issues into a sprint

No parameter schema in public metadata yet.

jira_list_versionsProject versions with release state

Project versions with release state

No parameter schema in public metadata yet.

jira_manage_versionCreate, update or release a version

Create, update or release a version

No parameter schema in public metadata yet.

jira_list_componentsProject components and their leads

Project components and their leads

No parameter schema in public metadata yet.

jira_list_filtersYour filters and favourites, or search all visible

Your filters and favourites, or search all visible

No parameter schema in public metadata yet.

jira_get_filterOne filter with its full JQL

One filter with its full JQL

No parameter schema in public metadata yet.

jira_list_labelsLabels defined across the site

Labels defined across the site

No parameter schema in public metadata yet.

Sponsors

Configuration

JIRA_INSTANCE*

Jira instance name (e.g. 'mycompany' for mycompany.atlassian.net)

JIRA_USER_EMAIL*

Email associated with the API token

JIRA_API_TOKEN*secret

Scoped API token from https://id.atlassian.com/manage-profile/security/api-tokens

JIRA_SCOPES

Comma-separated scopes: read:jira-work, write:jira-work, read:jira-user, read:me. Defaults to read:jira-work

JIRA_CLOUD_ID

Atlassian Cloud ID (auto-fetched if not set). Find at https://yoursite.atlassian.net/_edge/tenant_info

Readme

mcp-jira-scoped

npm version License Node TypeScript

A Jira MCP server built around Atlassian's scoped API tokens, with scope enforcement in the server itself.

Most Jira MCP servers use classic (unscoped) API tokens with basic auth against yoursite.atlassian.net — including the most popular one, which still has scoped-token support open as a feature request. Atlassian is moving away from classic tokens. This server is built for scoped tokens against the modern api.atlassian.com gateway, and enforces your granted scopes server-side before any API call is made — the AI is never trusted to restrain itself.


View the full README on GitHub

Details

Repository
github.com/deepwired/mcp-jira
Category
Developer Tools
Package
mcp-jira-scoped
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related Developer Tools MCP servers

View all
1alyiox avatarAtlassian Attachmentsalyiox/mcp-atlassian-attachmentsMCP server for downloading, uploading, and deleting Jira Cloud attachments by ID.0stars
2b1ff avatarAtlassian Dc Mcp Confluenceb1ff/atlassian-dc-mcpMCP server for Atlassian Confluence Data Center - access and manage content108stars
3rog0x avatarGitrog0x/mcp-git-toolsGit log, diff, blame, branch stats for AI agents0stars
4dave-london avatarGithubdave-london/pareMCP server for GitHub operations (PRs, issues, actions) with structured, token-efficient output128stars
5aniongithub avatardevcontainer-mcpaniongithub/devcontainer-mcpManage dev container environments via MCP (Docker, DevPod, Codespaces).28stars
6tadas-github avatarA2asearch Mcptadas-github/a2asearch-mcpSearch 10,000+ AI agents, MCP servers, and CLI tools via A2ASearch from any MCP client.17stars