Skip to main content
Support

Support Through Your AI Assistant

If you've connected an AI assistant (an "MCP harness" — Claude, ChatGPT, Cursor, and so on) to StackJack, it can work with StackJack support directly. StackJack exposes a set of built-in stackjack_…

Written By Christopher Scaminaci

Last updated 3 days ago

If you've connected an AI assistant (an "MCP harness" — Claude, ChatGPT, Cursor, and so on) to StackJack, it can work with StackJack support directly. StackJack exposes a set of built-in stackjack_* tools that let your assistant check platform status and file, read, and reply to support tickets on your behalf.

Tickets your assistant files are opened in Featurebase, the same place your widget conversations live, so you and the StackJack team work one thread either way.

Checking platform status and advisories

These tools are available to any connected assistant:

ToolWhat it does
stackjack_get_service_statusOverall platform status, component health, and any advisories relevant to the connectors your organization uses.
stackjack_list_advisoriesLists platform advisories — incidents, maintenance windows, release notices, and tool recommendations — with filters for kind, severity, and connector.
stackjack_get_release_notesStackJack release notes, optionally only those newer than a version you specify.
stackjack_get_tool_guidancePer-tool guidance, such as deprecation or replacement recommendations.
stackjack_refresh_tool_listReports the current StackJack catalog version and how to refresh the tool list. StackJack cannot push a live update into an open session, so the assistant has to re-list its tools, or disconnect and reconnect.

There is no public status page — asking your assistant to run stackjack_get_service_status is the way to answer "is StackJack having an issue right now?"

Ticket tools

ToolWhat it does
stackjack_create_support_ticketOpens a new support ticket for your organization in Featurebase. Gated per automation — see "When an automation files a ticket" below.
stackjack_list_support_ticketsLists your organization's tickets with status and priority.
stackjack_get_support_ticketFetches one ticket with its mirrored message thread.
stackjack_add_support_ticket_messageAdds a reply to a ticket, and mirrors it onto the Featurebase conversation. Gated per automation, same as above.

All four ticket tools are available automatically to any assistant you connect yourself. They don't need to be added to your connection's allowed-tools list, and a restricted tool list doesn't hide them — the same is true of the status and advisory tools above. (Only StackJack's automation tools work differently: running an automation requires the Agentic Orchestration feature and, per client, an explicit grant.)

Ticket ids. stackjack_create_support_ticket returns two numbers. ticketId is StackJack's own id, and it is the one stackjack_get_support_ticket and stackjack_add_support_ticket_message accept. ticketNumber is the Featurebase number a person quotes when following the ticket up with support.

StackJack automations are the exception. An automation runs against its own MCP connection, and on those connections the two write tools — stackjack_create_support_ticket and stackjack_add_support_ticket_message — are unavailable unless a person has turned them on for that specific automation. The two read tools stay available either way.

Filing a ticket after a failed tool call

When one of your assistant's StackJack tool calls fails with an error worth escalating (authentication failures, upstream connector errors, timeouts, and similar), the error response your assistant receives includes a ready-made support ticket draft — a suggested subject, description with the failing tool and error details, and a priority. Your assistant can show you the draft and file it with one stackjack_create_support_ticket call, so "that failed — want me to open a ticket with StackJack?" is a one-step handoff.

Tickets filed this way by an assistant you connected carry the technical context (failing tool, error type, correlation id) into the Featurebase ticket body, so support can start from the actual failure, and the same diagnostics bundle a widget-filed ticket gets is attached automatically. Any error context your assistant includes is validated, length-capped, and put through pattern-based masking of common credentials and tokens before it's stored — the same best-effort masking described in Submitting a ticket, not a guarantee that every sensitive value has been removed. Tell your assistant not to paste secrets, and read what it proposes before you approve the ticket. You also get a "we received your request" email from StackJack on this path. Tickets filed by an automation work differently — see the next section.

Opening a ticket does not start StackJack's automated research. A StackJack operator starts that deliberately, and only operators see the result. See Replies and notifications.

Guardrails you might notice

  • Duplicate suppression. If a matching assistant-created ticket (same failing tool and error) was already opened in the last 15 minutes and isn't closed, StackJack returns the existing ticket's id instead of creating a duplicate — your assistant will report that a matching ticket already exists.
  • Volume cap: 30 attempts per hour. An organization gets 30 create attempts per hour, counted across every connected assistant and automation together. The counter increments before the duplicate check, so an attempt that is answered with an existing ticket id still spends one of the 30 — the cap is a runaway-loop guard, not a count of tickets you received. Beyond 30, creation is rejected until the next hour; open urgent issues in the messenger instead.
  • No diagnostics in responses. Ticket responses returned to your assistant never include the internal diagnostic files — those are for the support team.
  • The support lane can report itself unavailable, and not every failure means the same thing. If StackJack's connection to Featurebase is not configured, no ticket was attempted and nothing exists anywhere — that one is unambiguous. If the call to Featurebase was attempted and failed, your assistant is told no ticket was opened, and StackJack releases its duplicate guard so a retry is free to try again. A third outcome is possible but rare: the Featurebase ticket is created first and StackJack's own record is written second, so an unexpected failure between the two can return an error over a ticket that does exist. Before refiling the same report, ask your assistant to run stackjack_list_support_tickets, or look in the messenger. StackJack also holds a short duplicate claim on an identical report, so an immediate retry converges on the ticket the first attempt opened rather than opening a second one.

When an automation files a ticket

A StackJack automation can open a support ticket when a run hits a platform or connector error. This is a separate, narrower path from the assistant you connected yourself, and it is off unless someone turns it on.

It's off by default, and only a person can turn it on

  • New automations start with ticket filing off. The automation reports the error in its run output only.
  • Automations that existed before this changed keep the capability, because it used to be implicit — they were switched on so nobody lost it silently. The diagnostics opt-in below was left off for every automation, new and existing alike.
  • An automation can never grant itself either setting. They're writable only from the Portal; an attempt to set them from the AI-assistant side is refused outright, in either direction. That's deliberate — an automation that could enable its own diagnostics and then file a ticket would be a way to push your data out.

You control both settings per automation: open the automation's builder in the Portal (Automations → the automation, or /automations/builder/<automation-id> directly), scroll to Guardrails and deploy, and use the two controls in the Guardrails and consent card:

SettingWhat it does
Allow this agent to raise a StackJack support ticket for errors encounteredThe main switch. Off = the automation can't file or reply to tickets at all.
Allow submitting diagnostic data with potential payload/PII dataAppears only while the switch above is on, and is off by default. Controls how much detail the ticket's diagnostics carry (below).

Turning the main switch off also clears the diagnostics opt-in, so re-enabling later is a fresh decision rather than a silent restore.

While the main switch is off, the two ticket-writing tools don't appear in that automation's tool list at all, and a call to either one is refused with a message naming the setting to turn on.

What's in the diagnostics when the opt-in is off

With the diagnostics opt-in off — the default for every automation — a ticket the automation files gets a platform-only diagnostics bundle. Specifically omitted:

  • Member and invite records, and any email addresses.
  • Identity ids for your users.
  • Connector validation-error and "why it was disabled" text (free-form fields most likely to contain a leaked value or customer data).
  • Error message text from your recent tool calls.

What remains is the platform picture support needs to triage: connector types with their enabled/valid status, plan and subscription state, counts (how many active members, how many pending invites), and which tool calls ran, whether they succeeded, and how long they took. The bundle is explicitly marked as having identity detail omitted, so support knows to ask you rather than assume.

Turning the opt-in on restores the full bundle — the same one a widget-filed ticket gets.

One thing this setting does not cover: every ticket, from every source, also carries StackJack's own server-log bundle for your organization. Neither switch affects it. That bundle goes through the same pattern-based masking of common credentials and tokens described in Submitting a ticket — a best-effort filter for recognized secret shapes, not a promise that every sensitive value has been removed.

Repeat errors are appended, not re-filed

If the same automation hits the same failing tool and error type again within 24 hours, StackJack adds an occurrence note to the ticket it already opened instead of filing a new one, mirrors that note onto the Featurebase conversation, and reports the existing ticket's id.

You'll see those notes in the conversation — they read "Automated occurrence report: this agent hit the same error signature again…" and appear as your organization's own messages, because your automation, not StackJack support, wrote them.

Closed tickets are excluded from that match — if you close a ticket and the failure comes back, the automation opens a fresh one rather than reopening the closed thread.

The daily cap

Across all of your organization's automations, at most 20 new automation-filed tickets per day. Past that, further tickets are suppressed: no ticket is created, and the automation is told this is expected rather than an error, so it doesn't retry or treat the suppression as its own failure. If something needs attention while you're capped, open it in the support widget.

Where the two surfaces meet

Featurebase holds the conversation; StackJack holds its own mirrored copy. A ticket your assistant opens appears in your widget, and a reply you send from the widget becomes visible to your assistant through stackjack_get_support_ticket once StackJack mirrors the update. Internal operator notes — including StackJack's AI research findings — are deliberately left out of that mirror, so your assistant never sees them either.