jc-mcp
Token-efficient MCP server for Jira and Confluence that returns lean, flat responses to minimize token usage. Enables issue/comment/transition management, JQL/CQL search, and Confluence page operations.
README
<!-- mcp-name: io.github.maphnet/jc-mcp -->
jc-mcp
Token-efficient Jira & Confluence MCP server. Returns lean, flat responses that minimize token consumption while preserving the information LLM agents need.
Quick Start
-
Get an API token from id.atlassian.com
-
Add the server to your MCP client:
claude mcp add --scope user jc-mcp \
-e ATLASSIAN_URL=https://yoursite.atlassian.net \
-e ATLASSIAN_EMAIL=you@example.com \
-e ATLASSIAN_TOKEN=your-api-token \
-- npx -y @maphnet/jc-mcp
The --scope user flag makes the server available across all your projects. Omit it to add only for the current project. CloudId is auto-discovered from your site URL.
Updating
npx caches packages by version. To pull the latest release:
npx --yes @maphnet/jc-mcp@latest
Then restart your MCP client (Claude Code, Cursor, etc.) to pick up the new version.
Tools
| Tool | Description | Returns |
|---|---|---|
jcm_getIssue |
Read a Jira issue | Flat fields + markdown description |
jcm_getTransitions |
Available workflow transitions | [{id, name}] |
jcm_editIssue |
Update issue fields | {ok, key} |
jcm_transitionIssue |
Change workflow state | {ok, key} |
jcm_createIssue |
Create a new issue | {key, url} |
jcm_addComment |
Add a comment (plain text) | {ok, id} |
jcm_searchIssues |
JQL search | [{key, summary, status, assignee}] |
jcm_getCurrentUser |
Get the authenticated user | {accountId, displayName, email, active} |
jcm_lookupUser |
Find a user by email | [{accountId, displayName, email, active}] |
jcm_createVersion |
Create a release version | {id, name} |
jcm_listVersions |
List project versions | [{id, name, released, releaseDate}] |
jcm_releaseVersion |
Mark a version as released | {ok, id, name} |
jcm_getArticle |
Read a Confluence page | Title + markdown body |
jcm_createArticle |
Create a Confluence page | {id, url} |
jcm_updateArticle |
Update a Confluence page | {ok, id} |
jcm_searchArticles |
CQL search | [{id, title, spaceKey}] |
Why This Server?
Standard Atlassian MCP servers return raw API responses — deeply nested JSON with metadata LLM agents don't need. jc-mcp flattens and trims every response, cutting ~92% of tokens across typical operations:
| Operation | jc-mcp | Standard MCP | Reduction |
|---|---|---|---|
| Get issue | ~460 tokens | ~1,144 tokens | 60% |
| Search (5 issues) | ~105 tokens | ~6,204 tokens | 98% |
| Get transitions | ~17 tokens | ~313 tokens | 95% |
- Flat fields:
status: "In Progress"instead of nestedstatus.name+statusCategory+selflinks +iconUrl - Lean search results:
{key, summary, status, assignee}per issue — no descriptions, avatars, or project metadata - Minimal writes:
{ok: true, key: "PROJ-1"}— no re-fetch
Less tokens = faster responses, lower cost, more room in the context window.
Configuration
| Variable | Required | Description |
|---|---|---|
ATLASSIAN_URL |
Yes | Site URL, e.g. https://yoursite.atlassian.net |
ATLASSIAN_EMAIL |
Yes | Atlassian account email |
ATLASSIAN_TOKEN |
Yes | API token |
ATLASSIAN_CLOUD_ID |
No | Auto-discovered if omitted |
License
MIT
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.