Skip to main content
Glama

annsa_file

Add something new to the board. Use it to file what a customer said, a bug or finding you found, or an idea. It attaches to the matching priority if there is one; add stand_alone to make a new priority instead. The reply tells you which priority it landed on. It doesn't change rows that already exist; that's annsa.board. To tell the Annsa team about Annsa itself, use report.

Input Schema

NameRequiredDescriptionDefault
betNoThe bet a new priority goes on, by title or id; none if you leave it out.
skuNoFor add_transcript: the plan or product the customer is on.
fromNoWho said it: customer, team, agent, idea or roadmap.
lineNoFor submit from a scanner: the line number.
pathNoFor submit from a scanner: the file.
ruleNoFor submit from a scanner: the rule that fired.
textNoFor report, add_template, connect_goal and add_transcript: the words. submit takes feedback.
typeNoWhich kind: bug, feature, improvement, praise or question.
labelNoWhat to call this session, up to 60 characters. Shown as who did it.
themeNoThe group it belongs to, one of the workspace's themes.
titleNoFor add_priority, add_page, add_template or report: the title.
actionYessubmit: File what a customer said or what you found. With priority_number it attaches to that priority; with stand_alone it starts a new one. report: Tell the Annsa team about a bug, gap or idea in Annsa itself. Send text; title names the tool and action. Keep your customers' data out of it. add_page: Make a page from a template, private to you. Returns the link. add_template: Save a template with a title, text and when to use it. {blanks} in the text become its fields. connect_goal: Answer the welcome's optional question about what you want from Annsa, up to 300 characters. Goes to the Annsa team, not your board. add_transcript: Add a call transcript as customer feedback. What the customer asked for is filed from it. A person's action. import_direction: Import a strategy doc in two steps. First preview its lines, then add the ones you pick as ideas. A person's action. add_priority: Add a priority from a title and detail, with no customer words.
detailNoFor add_priority: the longer words of the row, up to 20000 characters.
doc_idNoWhich Direction page. Leave it out for a new page, or the Overview.
fieldsNoFor add_page: a value for each {blank} in the template.
insistNoFor submit and add_priority: file it even if a matching priority exists.
parentNoThe priority this one sits under. For bet op=place: the bet.
reasonNoFor add_priority: why you're filing it, in a line.
sourceNoWhere the feedback came from, like intercom. Defaults to mcp.mcp
verdictNoFor submit on a shipped priority: still_broken or fixed. false_positive doesn't close the row.
feedbackNoFor submit: what was said, word for word.
severityNo0 broken, 1 poor, 2 could be better, 3 minor. From an agent it's a proposal until a person sets it.
templateNoFor add_page: the template's key, from annsa.ask about=templates.
call_typeNoFor add_transcript: interview, sales_call, support or other (the default).
doc_titleNoThe page's title. Kept if you send none.
referenceNoA link someone can follow: a PR, URL or log line. A finding needs one.
selectionNoFor import_direction: which lines to add, by title. Leave it out to add all.
with_specNoFor submit and add_priority: also write a ready spec and return its spec_id.
origin_refNoWhere it came from, like a ticket or file:line. The same one again adds to the same row.
root_causeNoThe cause in one line, shaped 'When ___, ___ can't ___ because ___'. Up to 300 characters.
adjudicatedNoTrue if a person checked this scanner finding; raw scanner output is refused.
priority_idNoThe long id, instead of priority_number.
proposal_idNoFor import_direction: the id the preview returned, to add the lines you picked.
stand_aloneNoFor submit: start a new priority from this row. Not with priority_number.
when_to_useNoFor add_template: when an agent should pick this template.
revenue_bandNoWhat the customer pays: an amount like 499, or a tier word.
customer_nameNoThe customer who said it.
document_textNoFor import_direction: the document, at least 50 characters.
customer_emailNoTheir email, if you have it.
priority_numberNoThe # number, e.g. 20 for #20.
severity_reasonNoWhy this severity, in a line.

Output Schema

NameRequiredDescriptionDefault
whoNo
recordNo
messageNo
successNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed38 schema fields changed
    • changedInput schema / properties / action / description
      Previous value: -"submit: Adds one feedback row; an agent's is a finding. With priority_number it attaches there; with stand_alone it proposes a new priority. report: Tell the Annsa team about a bug, gap or idea in Annsa. Needs `text`; `title` names the tool and action. The Annsa team reads it, so keep your customers' data out. add_page: Makes a page from a template, private to you; returns its link. add_template: Saves a template (title, text, when_to_use), private to you; {blanks} are its fields. connect_goal: Answer the welcome's optional question: what the person wants from Annsa, up to 300 characters. Goes to the Annsa team, not your board. import_direction: Two steps: preview a strategy doc's lines, then add the ones you pick as ideas. add_priority: Adds a priority from a title and detail, with no customer words."New value: +"submit: File what a customer said or what you found. With priority_number it attaches to that priority; with stand_alone it starts a new one. report: Tell the Annsa team about a bug, gap or idea in Annsa itself. Send text; title names the tool and action. Keep your customers' data out of it. add_page: Make a page from a template, private to you. Returns the link. add_template: Save a template with a title, text and when to use it. {blanks} in the text become its fields. connect_goal: Answer the welcome's optional question about what you want from Annsa, up to 300 characters. Goes to the Annsa team, not your board. add_transcript: Add a call transcript as customer feedback. What the customer asked for is filed from it. A person's action. import_direction: Import a strategy doc in two steps. First preview its lines, then add the ones you pick as ideas. A person's action. add_priority: Add a priority from a title and detail, with no customer words."
    • changedInput schema / properties / adjudicated / description
      Previous value: -"Raw scanner output is refused unless someone checked it"New value: +"True if a person checked this scanner finding; raw scanner output is refused."
    • changedInput schema / properties / call_type / description
      Previous value: -"For add_transcript (default other)."New value: +"For add_transcript: interview, sales_call, support or other (the default)."
    • addedInput schema / properties / customer_email / description
      Added value: +"Their email, if you have it."
    • addedInput schema / properties / customer_name / description
      Added value: +"The customer who said it."
    • changedInput schema / properties / detail / description
      Previous value: -"The longer words of the row, up to 20000 characters"New value: +"For add_priority: the longer words of the row, up to 20000 characters."
    • changedInput schema / properties / doc_id / description
      Previous value: -"The Direction page to save into; leave it out for a new page."New value: +"Which Direction page. Leave it out for a new page, or the Overview."
    • changedInput schema / properties / doc_title / description
      Previous value: -"The page's title (kept if you send none)."New value: +"The page's title. Kept if you send none."
    • changedInput schema / properties / document_text / description
      Previous value: -"At least 50 characters"New value: +"For import_direction: the document, at least 50 characters."
    • changedInput schema / properties / feedback / description
      Previous value: -"The words, verbatim"New value: +"For submit: what was said, word for word."
    • addedInput schema / properties / fields / description
      Added value: +"For add_page: a value for each {blank} in the template."
    • changedInput schema / properties / from / description
      Previous value: -"Who said it"New value: +"Who said it: customer, team, agent, idea or roadmap."
    • changedInput schema / properties / insist / description
      Previous value: -"Files it without the check for a matching priority."New value: +"For submit and add_priority: file it even if a matching priority exists."
    • addedInput schema / properties / label / description
      Added value: +"What to call this session, up to 60 characters. Shown as who did it."
    • addedInput schema / properties / line / description
      Added value: +"For submit from a scanner: the line number."
    • changedInput schema / properties / origin_ref / description
      Previous value: -"Where it came from, like a ticket or file:line; the same one again adds to the same row."New value: +"Where it came from, like a ticket or file:line. The same one again adds to the same row."
    • addedInput schema / properties / parent / description
      Added value: +"The priority this one sits under. For bet op=place: the bet."
    • addedInput schema / properties / path / description
      Added value: +"For submit from a scanner: the file."
    • changedInput schema / properties / proposal_id / description
      Previous value: -"For import_direction: the id phase 1 returned, to land phase 2"New value: +"For import_direction: the id the preview returned, to add the lines you picked."
    • changedInput schema / properties / reason / description
      Previous value: -"Required for takeover, release, retract, correct and an agent's severity"New value: +"For add_priority: why you're filing it, in a line."
    • changedInput schema / properties / reference / description
      Previous value: -"A followable link (PR, URL, log line); findings need one"New value: +"A link someone can follow: a PR, URL or log line. A finding needs one."
    • changedInput schema / properties / revenue_band / description
      Previous value: -"An amount ('499') or a tier word"New value: +"What the customer pays: an amount like 499, or a tier word."
    • changedInput schema / properties / root_cause / description
      Previous value: -"When ___, ___ can't ___ because ___; sent on the submit. Max 300 characters"New value: +"The cause in one line, shaped 'When ___, ___ can't ___ because ___'. Up to 300 characters."
    • addedInput schema / properties / rule / description
      Added value: +"For submit from a scanner: the rule that fired."
    • changedInput schema / properties / selection / description
      Previous value: -"Titles to land in phase 2; omitted lands all"New value: +"For import_direction: which lines to add, by title. Leave it out to add all."
    • changedInput schema / properties / severity / description
      Previous value: -"0 broken, 1 poor, 2 could be better, 3 minor. From an agent: a proposal until a person types the P."New value: +"0 broken, 1 poor, 2 could be better, 3 minor. From an agent it's a proposal until a person sets it."
    • changedInput schema / properties / severity_reason / description
      Previous value: -"Why this P; sent on the submit with severity"New value: +"Why this severity, in a line."
    • changedInput schema / properties / source / description
      Previous value: -"Where the feedback came from, like intercom."New value: +"Where the feedback came from, like intercom. Defaults to mcp."
    • changedInput schema / properties / stand_alone / description
      Previous value: -"Makes a new priority from this row; not with priority_number."New value: +"For submit: start a new priority from this row. Not with priority_number."
    • addedInput schema / properties / template / description
      Added value: +"For add_page: the template's key, from annsa.ask about=templates."
    • addedInput schema / properties / text / description
      Added value: +"For report, add_template, connect_goal and add_transcript: the words. submit takes feedback."
    • changedInput schema / properties / theme / description
      Previous value: -"One of the workspace's themes"New value: +"The group it belongs to, one of the workspace's themes."
    • addedInput schema / properties / title / description
      Added value: +"For add_priority, add_page, add_template or report: the title."
    • changedInput schema / properties / type / description
      Previous value: -"What kind of row it is."New value: +"Which kind: bug, feature, improvement, praise or question."
    • changedInput schema / properties / verdict / description
      Previous value: -"On a shipped priority: still_broken or fixed. On release, false_positive does NOT close the row."New value: +"For submit on a shipped priority: still_broken or fixed. false_positive doesn't close the row."
    • addedInput schema / properties / when_to_use / description
      Added value: +"For add_template: when an agent should pick this template."
    • changedInput schema / properties / with_spec / description
      Previous value: -"Also writes a ready spec and returns its spec_id."New value: +"For submit and add_priority: also write a ready spec and return its spec_id."
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "message": {
      +      "type": "string"
      +    },
      +    "record": {
      +      "type": "object"
      +    },
      +    "success": {
      +      "type": "boolean"
      +    },
      +    "who": {
      +      "type": "object"
      +    }
      +  },
      +  "type": "object"
      +}
  2. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources