# GitHub Issues to Jira Sync

Syncs issues between GitHub and Jira bidirectionally. Creates Jira tickets from GitHub issues, updates status across systems, and keeps engineering and product.

## Toolkits Needed

You'll need access to these toolkits in your Arcade MCP Gateway:

- Github
- Linear
- Asana

## Setup Guide

1. **Sign up for Arcade**  
   Create a free Arcade account to get access to MCP Gateway.  
   [Create Arcade Account →](https://account.arcade.dev/)

2. **Create a new MCP Gateway**  
   Navigate to **MCP Gateway** page in Arcade, then click **Create MCP Gateway**.  
   Provide a slug that becomes your MCP URL (this is what LangSmith Fleet will discover automatically):  
   **Example:** If you choose slug `my-agent`, your MCP URL will be:  
   `https://api.arcade.dev/mcp/my-agent`

3. **Select the specific tools you need**  
   Arcade MCP Gateway gives you fine-grained control over exactly which tools your agent can access. Select these specific tools from the toolkits:
   - Github.ListPullRequests  
   - Github.GetPullRequest  
   - Github.CreatePullRequest  
   - Linear.ListIssues  
   - Linear.CreateIssue  
   - Linear.UpdateIssue  
   - Asana.GetTasksWithoutId  
   - Asana.CreateTask  
   - Asana.UpdateTask  
     
   **Why this matters:** Instead of granting access to entire toolkits with hundreds of tools, you're selecting only the 9 specific tools this agent actually needs. This precision reduces risk and keeps your agent focused.

4. **Open LangSmith Fleet and connect Arcade**  
   Arcade is available as a **native integration** in LangSmith Fleet. Open LangSmith, navigate to **Integrations** in the left sidebar, then select **Arcade** under the **Apps** section. Click **Connect** to link your Arcade account.  
   [Open LangSmith Fleet →](https://smith.langchain.com/)  
     
   Click **Connect**, then click **Allow** to authorize Arcade. Your gateways will be discovered automatically.

5. **Create your agent**  
   Create a new agent in LangSmith Fleet using the system prompt below and link your Arcade integration.
   
   View the system prompt
   Copy this system prompt and paste it into the "System Prompt" field when creating your agent in LangSmith Fleet:

```
   You are a GitHub Issues to Jira Sync agent that keeps issue trackers aligned.
   
   ## Your Capabilities
   - Read issues and PRs from GitHub
   - Track issues in Linear
   - Log sync status to Google Sheets
   - Notify on changes via Slack
   
   ## Workflow
   1. **Monitor** - Watch for GitHub changes
   2. **Match** - Find corresponding Linear issues
   3. **Sync** - Update status and details
   4. **Log** - Record sync history
   5. **Alert** - Notify on conflicts
   
   ## Example Interactions
   **User:** "Sync our GitHub issues with Linear"
   **Agent:** I'll sync GitHub issues to Linear...
   
   **Sync Summary:**
   - Issues checked: 45
   - Already synced: 38
   - Newly synced: 5
   - Conflicts: 2
   
   **Conflicts Found:**
   - Issue #123: Status mismatch (GitHub: closed, Linear: open)
   - Issue #456: Assignee differs
   
   Review conflicts?
   
   ## Guidelines
   - Sync regularly
   - Resolve conflicts quickly
   - Maintain audit trail
   - Preserve data integrity
   ```

6. **Add Arcade tools to your agent**  
   In your agent, click **Add tools** and select the Arcade tools from your connected gateway. Your gateway exposes only the specific tools you configured:
   
   - Github.ListPullRequests  
   - Github.GetPullRequest  
   - Github.CreatePullRequest  
   - Linear.ListIssues  
   - Linear.CreateIssue  
   - Linear.UpdateIssue  
   - Asana.GetTasksWithoutId  
   - Asana.CreateTask  
   - Asana.UpdateTask

7. **Start using your agent!**  
   That's it! Your agent is now connected to Arcade's tools. Start chatting with your agent to test it out.  
   You're all set!

## Try It: Example Prompt

Once your agent is set up, try this example prompt to test it:

Example Query

```
Sync GitHub issues with Linear for the mobile-app repo. Match by issue number, update statuses, and log the sync results to our tracking spreadsheet. Alert #engineering about any sync conflicts.
```

## Best For

- Product Managers
- Engineering Leads

## Ready to actually ship your agent?

Free to start. Ready for enterprise when you are.
[Try Free](https://app.arcade.dev/register) [Book a demo](/content/contact/index.html)