
Mcp Jira Scoped
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 toolsPublic 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*secretScoped API token from https://id.atlassian.com/manage-profile/security/api-tokens
JIRA_SCOPESComma-separated scopes: read:jira-work, write:jira-work, read:jira-user, read:me. Defaults to read:jira-work
JIRA_CLOUD_IDAtlassian Cloud ID (auto-fetched if not set). Find at https://yoursite.atlassian.net/_edge/tenant_info
Readme
mcp-jira-scoped
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.
Details
- Repository
- github.com/deepwired/mcp-jira
- Category
- Developer Tools
- Package
mcp-jira-scoped- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active