jira-context-mcp
Fetches structured Jira issue context from a Jira URL, providing issue details, comments, attachments, and custom fields.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
jira-context-mcp
jira-context-mcp is a production-focused MCP server that fetches structured Jira issue context from a Jira URL. It is designed for coding agents like Codex and Claude Code so they can quickly understand issue intent and implementation context.
What This Server Does
Exposes one MCP tool:
get_jira_issue_from_urlValidates that the input URL belongs to your
JIRA_BASE_URLExtracts a Jira issue key from multiple Jira URL shapes
Calls Jira Cloud REST API:
GET /rest/api/3/issue/{issueIdOrKey}?expand=names,renderedFields
Converts Jira rich text (Atlassian Document Format) into plain text
Returns concise, agent-friendly structured issue context
Related MCP server: Jira MCP Server
Supported Jira Issue Types
This server is issue-type agnostic. It works for any Jira issue type, including:
Bug
Feature request
Task
Story
Epic
Requirement
Improvement
Support ticket
Custom issue types
Required Environment Variables
JIRA_EMAIL: Jira account emailJIRA_API_TOKEN: Jira API tokenJIRA_BASE_URL: Jira Cloud tenant URL (example:https://your-domain.atlassian.net)
Quick Setup Commands
Codex (no global install)
codex mcp add jira \
--env JIRA_EMAIL=you@example.com \
--env JIRA_API_TOKEN=your-token \
--env JIRA_BASE_URL=https://your-domain.atlassian.net \
-- npx -y github:TastyHeadphones/jira-context-mcpClaude Code (no global install)
claude mcp add jira \
-e JIRA_EMAIL=you@example.com \
-e JIRA_API_TOKEN=your-token \
-e JIRA_BASE_URL=https://your-domain.atlassian.net \
-- npx -y github:TastyHeadphones/jira-context-mcpOptional: install globally first
npm install -g github:TastyHeadphones/jira-context-mcpThen add with local binary:
codex mcp add jira \
--env JIRA_EMAIL=you@example.com \
--env JIRA_API_TOKEN=your-token \
--env JIRA_BASE_URL=https://your-domain.atlassian.net \
-- jira-context-mcpclaude mcp add jira \
-e JIRA_EMAIL=you@example.com \
-e JIRA_API_TOKEN=your-token \
-e JIRA_BASE_URL=https://your-domain.atlassian.net \
-- jira-context-mcpTool
get_jira_issue_from_url
Input:
{
"url": "string"
}Supported URL examples:
${JIRA_BASE_URL}/browse/ABC-123${JIRA_BASE_URL}/jira/software/projects/ABC/boards/1/backlog?selectedIssue=ABC-123Any Jira URL under
JIRA_BASE_URLcontaining an issue key likeABC-123
Returned structured data includes:
issueKey,issueUrl,summarydescription(plain text where possible)issueType,status,statusCategory,priorityassignee,reporterlabels,componentsfixVersions,affectedVersionscreated,updated,dueDateparent,epicsubtasks,linkedIssuesattachments(metadata only)comments(most recent 10)acceptanceCriteria(best-effort extraction from description/custom fields)customFields(non-empty, normalized, human-readable)
Create a Jira API Token
Click Create API token.
Name the token and copy it.
Use that value for
JIRA_API_TOKEN.
Run Locally
Install dependencies:
npm installSet environment variables (for example via
.envin your shell/session).Build:
npm run buildStart:
npm startDevelopment mode:
npm run devMCP Configuration Examples
Use this server entry in your MCP client config:
{
"mcpServers": {
"jira": {
"command": "node",
"args": ["/absolute/path/to/jira-context-mcp/dist/index.js"],
"env": {
"JIRA_EMAIL": "you@example.com",
"JIRA_API_TOKEN": "your-token",
"JIRA_BASE_URL": "https://your-domain.atlassian.net"
}
}
}
}Claude Code MCP configuration example
Use the same JSON block above in your Claude Code MCP server configuration file.
Codex MCP configuration example
Use the same JSON block above in your Codex MCP server configuration file.
Example Tool Call
{
"name": "get_jira_issue_from_url",
"arguments": {
"url": "https://your-domain.atlassian.net/browse/ABC-123"
}
}Example Output
{
"issueKey": "ABC-123",
"issueUrl": "https://your-domain.atlassian.net/browse/ABC-123",
"summary": "Prevent duplicate webhook retries",
"description": "As a platform engineer, I need retry deduplication ...",
"acceptanceCriteria": "- Duplicate deliveries are ignored\n- Metrics include dropped duplicates",
"issueType": "Story",
"status": "In Progress",
"statusCategory": "In Progress",
"priority": "High",
"assignee": {
"accountId": "5b10ac8d82e05b22cc7d4ef5",
"displayName": "Alex Example",
"emailAddress": null,
"active": true
},
"labels": ["webhook", "idempotency"],
"components": ["API"],
"fixVersions": ["2026.05"],
"affectedVersions": ["2026.04"],
"subtasks": [],
"linkedIssues": [],
"attachments": [],
"comments": [],
"customFields": []
}Security Notes
Keep
JIRA_API_TOKENsecret. Never commit it to source control.Use least-privilege Jira access for the account tied to the token.
This server only fetches issue data and attachment metadata; it does not download attachment files.
URL validation rejects URLs outside your configured
JIRA_BASE_URL.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Context for coding agents: checks a GitHub or Linear issue is ready before your agent starts it.
Fetch any URL as clean markdown, HTML, or a screenshot for AI agents.
Extract clean markdown, DESIGN.md specs, and link graphs from any URL for LLMs.
Turns any URL into SEO metadata, contacts, tech stack, and AI-ready Markdown, in one call.
Related MCP Servers
- FlicenseNot gradedqualityFmaintenanceA Model Context Protocol server that enables ChatGPT and other AI assistants to directly interact with JIRA issues, currently offering the ability to retrieve issue details.-
- AlicenseBqualityDmaintenanceEnables fetching and viewing Jira issue details directly through Claude Desktop using secure API token authentication. Provides comprehensive issue information including status, assignee, priority, and descriptions in both human-readable and structured formats.10567 npm1MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to fetch ProofHub task details, comments, and bug tracker links from a URL, streamlining development workflows.619 npmMIT
- AlicenseNot gradedqualityFmaintenanceIntegrates Jira tickets with GitHub Copilot Chat, fetching ticket details, linked tickets, and metadata to enhance context for AI-driven code suggestions.21 npmAGPL 3.0