Agent Onboarding

Everything you need to onboard your AI agent to bugAgent.

If you're developing with AI, bugAgent offers several resources to improve your experience. Whether your agent is an autonomous coding assistant, a CI/CD bot, or a custom workflow — bugAgent gives it the ability to file, classify, and manage bugs without human intervention.

Prerequisites

Before your AI agent can start filing bugs, you'll need a human to complete a one-time setup:

Free Tier

Every bugAgent account starts on the Free plan. Your agent gets access to:

The 128 KB Free structured-content bound is separate from file attachments. AI test-case generation, AI tag suggestions, Figma import, and test-case file attachments require Enterprise. Free can use URL references. Enterprise test case storage and runs are unlimited, subject to general platform protections.

Jira Cloud sync is included on Free. View the Enterprise plan for higher limits, advanced testing, team features, and priority support.

bugAgent MCP Server

The hosted bugAgent MCP server connects your AI agent to bugAgent via the Model Context Protocol. It uses Streamable HTTP and gives your agent direct access to:

Setup

Recommended: hosted Streamable HTTP

Connect directly to https://mcp.bugagent.com/mcp with the header Authorization: Bearer ba_live_YOUR_KEY_HERE. Nothing needs to run locally. Here are examples for popular clients:

claude mcp add --transport http bugagent https://mcp.bugagent.com/mcp \
  --header "Authorization: Bearer ba_live_YOUR_KEY_HERE"

// .cursor/mcp.json
{
  "mcpServers": {
    "bugagent": {
      "type": "http",
      "url": "https://mcp.bugagent.com/mcp",
      "headers": {
        "Authorization": "Bearer ba_live_YOUR_KEY_HERE"
      }
    }
  }
}

# Add to ~/.codex/config.toml
[mcp_servers.bugagent]
url = "https://mcp.bugagent.com/mcp"
bearer_token_env_var = "BUGAGENT_API_KEY"

export BUGAGENT_API_KEY="ba_live_YOUR_KEY_HERE"

{
  "mcpServers": {
    "bugagent": {
      "type": "http",
      "url": "https://mcp.bugagent.com/mcp",
      "headers": {
        "Authorization": "Bearer ba_live_YOUR_KEY_HERE"
      }
    }
  }
}

Optional stdio bridge

Use the published bridge only when a client requires stdio and cannot connect to remote Streamable HTTP. The bridge command is npx -y bugagent-mcp:

{
  "mcpServers": {
    "bugagent": {
      "command": "npx",
      "args": ["-y", "bugagent-mcp"],
      "env": { "BUGAGENT_API_KEY": "ba_live_YOUR_KEY_HERE" }
    }
  }
}

Available MCP Tools

The complete delegated OAuth catalog contains 129 tools. This table is a short onboarding sample, not the canonical catalog. API-key clients see only tools allowed by their selected scopes; account, team, and API-key administration entries require OAuth.

Use the canonical MCP guide for human-readable details or download the generated mcp-tool-index.json for all runtime tools and access metadata.

Quick Start for Agents

Create a bug report programmatically using the REST API:

import os
import requests

api_key = os.environ["BUGAGENT_API_KEY"]
base_url = os.getenv("BUGAGENT_BASE_URL", "https://app.bugagent.com")
headers = {"Authorization": f"Bearer {api_key}"}

response = requests.get(
    f"{base_url}/api/reports",
    headers=headers,
    params={"project_id": os.environ["BUGAGENT_PROJECT_ID"], "limit": 5},
    timeout=20,
)
response.raise_for_status()
for report in response.json().get("reports", []):
    print(report["short_id"], report["title"])

const apiKey = process.env.BUGAGENT_API_KEY;
const projectId = process.env.BUGAGENT_PROJECT_ID;
const baseUrl = process.env.BUGAGENT_BASE_URL ?? "https://app.bugagent.com";
if (!apiKey || !projectId) throw new Error("Set BUGAGENT_API_KEY and BUGAGENT_PROJECT_ID");

const url = new URL("/api/reports", baseUrl);
url.searchParams.set("project_id", projectId);
url.searchParams.set("limit", "5");
const response = await fetch(url, {
  headers: { Authorization: `Bearer ${apiKey}` },
  signal: AbortSignal.timeout(20_000),
});
if (!response.ok) throw new Error(`bugAgent returned ${response.status}: ${await response.text()}`);
const payload = await response.json();
for (const report of payload.reports ?? []) console.log(report.short_id, report.title);

What Makes bugAgent Different?

Unlike traditional bug tracking platforms, bugAgent is built from the ground up for AI-native workflows.

Next Steps

Ready to dive deeper? Explore these resources: