AtminaAtmina Guide
Theme

Published with v0.343.0

Get support

You can reach Atmina support two ways: from the app yourself, or through an agent you have connected over MCP. Both open the same ticket, with the same ATM-#### reference, the same confirmation email, and the same conversation.

File a request in the app

Open Support in Atmina to create a request. Give it a specific title, describe what you expected and what happened, and include the Team or Knowledge Base involved without pasting credentials or private tokens.

Open an existing request to read replies and add more context. Email replies are joined to the same conversation, so keep the thread when responding.

For a connection problem, include the client or integration name, the visible error, and the approximate time. For a memory problem, include the file path or cited source and whether the issue appears in Files or search.

Let your agent file one

An agent connected over MCP can file a ticket for you with the create_support_ticket tool. Connect the agent first — see Connect your agent for the one-time setup, and MCP authentication and connections if a connection needs recovering.

Tell your agent what to report and ask it to file a support ticket. It calls the tool with your report in body, and it can add a short summary as title, a category (bug, question, billing, feedback, or other), a severity (low, normal, or high), and a free-form context object holding the mechanical detail.

A worked call looks like this:

{
  "tool": "create_support_ticket",
  "args": {
    "title": "Search returns nothing on the handbook base",
    "body": "Searching the handbook Knowledge Base answers with zero results for queries that matched last week. Reading the files directly still works.",
    "category": "bug",
    "severity": "high",
    "context": {
      "tool": "search",
      "kb": "acme/handbook",
      "query": "customer data retention",
      "error": "0 results, exhaustive: false"
    }
  }
}

It comes back with the ticket id, the ATM-#### reference, the status, and a link you can open, so your agent can tell you where the ticket went. Ask it for those before you close the session.

Anything in context is folded into the ticket text as JSON under an Agent context block, so you and the Atmina team read exactly what your agent sent. Nothing about the ticket is private to the agent.

Follow a ticket from your agent

The same connected agent can read the tickets you have already filed. Two tools do it, and both are read-only: they work on an agent connection you granted read-only access to.

list_support_tickets returns your own tickets, newest activity first — every ticket you have filed, whichever team you filed it under, including teams you have since left. Nobody else's are ever included, not even a teammate's. Narrow it with q (matched against the ATM-#### reference and the title), status, category, or unread, and page through a long history with limit and the cursor the previous page returned:

{
  "tool": "list_support_tickets",
  "args": {
    "status": "in_progress",
    "unread": true,
    "limit": 20
  }
}

Each ticket comes back with its id, reference, title, status, category, reported impact, when it was created, when it last moved, and has_unseen_update — true when Atmina has replied or the status has changed since you last caught up. The status is always one of received, in_progress, resolved, or closed, which is the same vocabulary you see in Support.

get_support_ticket reads one of them. Give it either the ticket id or the ATM-#### reference — whichever you have to hand:

{
  "tool": "get_support_ticket",
  "args": {
    "ticket": "ATM-1042",
    "mark_seen": true
  }
}

It returns the ticket, the whole conversation in order — each message marked you or support, with its time — and any attachments. Attachment view links are short-lived: open one when your agent gives it to you rather than saving it for later, because it expires.

mark_seen is how the unread badge in the app gets cleared. It defaults to false, so reading a ticket through your agent does not quietly mark it read — ask your agent to set it when you have actually caught up. When it is true it marks exactly the updates that call returned; a reply that arrives while the call is running stays unread, so it is still waiting for you the next time you look.

A ticket that is not yours is reported exactly as one that does not exist, by id and by reference alike, so neither you nor your agent can probe other people's tickets.

Reply and close from your agent

Two more tools finish the conversation without a trip to the browser. Both write on your behalf, so they need an agent connection you granted write permission to.

reply_to_support_ticket adds a message to a ticket you filed. It is the same message, in the same conversation, as one you type in Support: Atmina is told you have replied, and the ticket rises in their queue, which is ordered by most recent activity. Give it the ticket id or the ATM-#### reference and the words you want sent:

{
  "tool": "reply_to_support_ticket",
  "args": {
    "ticket": "ATM-1042",
    "body": "It started working again after last night's rebuild, but the first two queries after a sync still come back empty."
  }
}

Replying to a ticket Atmina has already resolved, or to one you closed, works and brings it back to their attention. It does not change the ticket's status on its own — Atmina decides whether to pick the work back up, which is why a problem that came back is never stranded in a state nobody is looking at.

close_support_ticket ends a ticket you no longer need help with. Pass a note to say why, or leave it out and a plain closing sentence is recorded instead:

{
  "tool": "close_support_ticket",
  "args": {
    "ticket": "ATM-1042",
    "note": "The rebuild fixed it. Nothing further needed, thanks."
  }
}

A closing message is always added to the conversation, with or without your note, so Atmina can see that you ended the ticket rather than that it was dropped. Closing the same ticket twice is safe: the second call leaves everything as it is and comes back with already_closed: true.

Two things about closing that are easy to assume wrongly:

What your agent can and cannot do

It canIt cannot
File a ticket for youEdit the title or message of a ticket after filing
List the tickets you have filedDelete a ticket
Read one ticket with its whole conversationSee anyone else's tickets, including a teammate's
Reply on a ticketChange a ticket's status by replying
Close a ticket you are done withClose a ticket someone else filed

There is no edit tool and no delete tool, and that is deliberate: the message you filed has already been sent to Atmina and to your own inbox, so a correction goes in a reply where both of you can see it alongside the original.

What happens next

The ticket is filed under your account, not your agent’s. You get the confirmation email, the request appears in Support alongside the ones you typed yourself, and you can reply to it there or by replying to the email.

A ticket your agent filed opens with a line naming the agent client that sent it — for example Filed by an agent: claude-code — so you can tell it apart from one you wrote. That line is part of the ticket text, so it is there in your conversation, in the confirmation email, and for whoever picks the ticket up.

The original message cannot be edited or deleted after it is filed. Corrections and new detail go in a reply, which is added to the same conversation.

Good to know

You can also email support@atmina.ai.

Check What’s in alpha for current product limits before opening a request.