The Jira tool lets Forge create issues in your Jira project directly from agent findings. Set it up on any agent — for example, a Security Engineer creating a ticket for each critical finding, or a Task Planner creating the entire sprint backlog.
Step 1: Get a Jira API token
Go to id.atlassian.com → Security → API tokens → Create API token. Give it a name like "Forge integration". Copy the token — it's only shown once.
Step 2: Store credentials in Secret Vault
Go to Settings → Integrations → Secret Vault. Add two secrets:
JIRA_EMAIL
Your Atlassian account email address.
JIRA_TOKEN
The API token you just created.
Step 3: Add the Jira tool
In your team editor, click the tools icon on the relevant agent. Add Tool → Jira. Configure:
Base URL
https://yourcompany.atlassian.net
{{secret.JIRA_EMAIL}}API token
{{secret.JIRA_TOKEN}}Project key
Your Jira project key, e.g. ENG or SEC.
Issue title template
[Forge] {{agent.title}} — FindingsFire condition
outcome == "completed"
Step 4: Test it
Run the team. After the agent completes, check your Jira project. A new issue should appear with the agent's findings as the description. If the issue isn't created, check the run's event log for error details.