agentskit.js
ToolsIntegrations

jira

Jira issues — search via JQL, create. Basic auth (email + API token).

import { jira } from '@agentskit/tools/integrations'

const tools = jira({
  baseUrl: 'https://my-org.atlassian.net',
  email: process.env.JIRA_EMAIL!,
  apiToken: process.env.JIRA_API_TOKEN!,
})

Bundled: jira(config) returns both sub-tools. Calls Jira REST API v3 at your Atlassian site root.

#Sub-tools

NamePurpose
jira_search_issuesSearch Jira issues with a JQL query
jira_create_issueCreate a new Jira issue in a project

#Schema

#jira_search_issues

ParameterTypeRequiredDescription
jqlstringyesJQL query, e.g. project = ENG AND status = "In Progress"
maxResultsnumbernoMax issues to return (default 25)

Returns: key, summary, status, assignee for each match.

#jira_create_issue

ParameterTypeRequiredDescription
projectKeystringyesJira project key, e.g. ENG
summarystringyesIssue summary / title
descriptionstringnoIssue description (plain text; rendered as Atlassian Document Format)
issueTypestringnoe.g. Task, Bug, Story (default Task)

Returns: key and url (full Jira link to the created issue).

#Example — sprint assistant

import { createRuntime } from '@agentskit/runtime'
import { jira } from '@agentskit/tools/integrations'

const runtime = createRuntime({
  adapter,
  systemPrompt: 'You manage sprint work. Search for blockers and create follow-up tasks.',
  tools: jira({
    baseUrl: process.env.JIRA_BASE_URL!,
    email: process.env.JIRA_EMAIL!,
    apiToken: process.env.JIRA_API_TOKEN!,
  }),
})

await runtime.run('Find all in-progress issues assigned to alice@example.com in project ENG.')

#Security

  • Env vars required: JIRA_EMAIL (Atlassian account email), JIRA_API_TOKEN (Atlassian API token from id.atlassian.com/manage-profile/security/api-tokens), JIRA_BASE_URL (your Atlassian site, e.g. https://my-org.atlassian.net).
  • Authentication is HTTP Basic: email:apiToken base64-encoded. Never commit tokens; use env vars or a secrets manager.
  • Use a service-account email for production agents rather than a personal Atlassian account.
  • Atlassian Cloud enforces rate limits per site; high-volume queries should use maxResults pagination.
  • jira_create_issue writes to the project — gate via HITL for autonomous agents.

Explore nearby

✎ Edit this page on GitHub·Found a problem? Open an issue →·How to contribute →

On this page

Ask the docs

Ask anything about AgentsKit. Answers come from the docs corpus via OpenRouter free-tier models. Rate limited per IP.