How to add Jira Context MCP to Windsurf

Feed Jira ticket context to AI coding agents like Cursor and let them fix issues automatically. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 25★ · sse · apikey

Windsurf config for Jira Context MCP

npx -y @smithery/cli install @rahulthedevil/Jira-Context-MCP --client claude

{
  "mcpServers": {
    "jira-context-mcp": {
      "serverUrl": "http://localhost:3000/sse"
    }
  }
}

Remote server — no local install needed. Restart the client after saving the config.

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the Jira Context MCP config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5Jira Context MCP's tools become available to Cascade.

Before you start

Node.js 20.17.0 or higher
A Jira account with API access
A Jira API token (generated at Atlassian API Tokens)

What Jira Context MCP can do in Windsurf

get_issue

Fetch detailed information about a specific Jira issue by issue key (e.g. issueKey:PROJECT-123).

get_assigned_issues

Retrieve issues assigned to you in a specific project (projectKey, maxResults).

get_issues_by_type

Filter issues by type such as Bug, Story, or Epic (issueType, projectKey, maxResults).

get_projects

List all available Jira projects you have access to.

get_issue_types

List all available Jira issue types.

get_recent_changes

Retrieve changes made in tickets over a specified period in a project (projectKey, maxDays).

Security

Requires a Jira account with API access and a Jira API token (generated at Atlassian API Tokens). Credentials (JIRA_BASE_URL, JIRA_USERNAME, JIRA_API_TOKEN) are supplied via a local .env file. The token grants access to your Jira data, so keep it secret and scope the account appropriately.

Jira Context MCP + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Jira Context MCP config there under the "mcpServers" key and restart the client.

Is Jira Context MCP safe to use with Windsurf?

Which AI clients does it work with?

It connects to Cursor via 'Connect to MCP Server' using the SSE URL (default http://localhost:3000/sse), and can be installed for Claude Desktop automatically via Smithery.

How do I authenticate with Jira?

Provide JIRA_BASE_URL, JIRA_USERNAME, and a JIRA_API_TOKEN (created at Atlassian API Tokens) in a local .env file.

Is this an official Atlassian server?

No. It is an open-source MIT-licensed project by Rahul Dey (@rahulthedevil), not an official Atlassian product.

View repo Full Jira Context MCP page