Servidor MCP

Kaiku

            tech.kaiku/kaiku
        

Herramientas para desarrolladores Conocimiento y documentación Productividad Requiere autenticación MCP 2026-07-28

Qué hace este MCP

Manages team issues, comments, attachments, projects, wiki pages, and related development workflows.

add_attachment

Attach a file to an issue: pass its bytes as 'contentBase64', or its content as 'text' when the file is text. Attaching a filename the issue already has replaces that file rather than adding a second copy, so retrying this call cannot double it. A file on the person's own disk — a screenshot, a PDF — is better attached by path through the pm-files MCP server than typed out as base64; local_files_setup says how to connect it. Returns the attachment's download URL. Requires permission to edit issues in that project.

Esquema de entrada

{'type': 'object', 'required': ['key', 'filename'], 'properties': {'key': {'type': 'string', 'description': "Issue key, e.g. 'UK-1'."}, 'text': {'type': ['string', 'null'], 'default': None, 'description': "The file's content as text, stored as UTF-8 — for a log, CSV or Markdown file you are writing here. Alternative to 'contentBase64'; passing both is refused."}, 'filename': {'type': 'string', 'description': "File name to store, e.g. 'report.pdf'. Any directory part is dropped."}, 'mimeType': {'type': ['string', 'null'], 'default': None, 'description': "Content type to record for the listing, e.g. 'text/csv'. Ignored when the bytes identify themselves (a PNG is a PNG whatever you call it), and never used to serve the file."}, 'contentBase64': {'type': ['string', 'null'], 'default': None, 'description': "The file's bytes, base64-encoded (a 'data:…;base64,…' URL is accepted and unwrapped). Use 'text' instead when the file is text."}}}

add_comment

Add a comment to an issue, or reply to one of its comments ('replyTo' is a comment id from get_comments). A reply notifies the author of the comment it answers, whether or not they watch the issue — no mention needed — and they are told once even if also mentioned. Requires permission to comment in that project (read-only members cannot). Answers with 'notified' (who this actually reaches, the answered author included), 'answered' (for a reply: whose comment it answers, and 'notified' false with a 'reason' when they are not told) and 'unresolvedMentions' (what looked like a mention and reached nobody, each with a reason) — a wrong handle is stored as written and never refused, so that list is the only sign it did not land. Where the workspace has agents, [~agent:role] (e.g. [~agent:product]) calls one to answer in the thread on your behalf: 'agents' lists each call with its requestId and status, and an agent that will not come is in 'unresolvedMentions' with its reason (agent_unknown, agent_off, agent_plan, agent_budget, too_many).

Esquema de entrada

{'type': 'object', 'required': ['key', 'body'], 'properties': {'key': {'type': 'string', 'description': "Issue key, e.g. 'UK-1'."}, 'body': {'type': 'string', 'description': 'Comment body. Markdown is kept as written, and carries $…$ / $$…$$ LaTeX formulas and [~username] mentions (the username, which list_users hands you ready-made — never the display name).'}, 'replyTo': {'type': ['integer', 'null'], 'default': None, 'description': 'The comment this one answers, as returned by get_comments — on the same issue and not deleted.'}}}

add_wiki_attachment

Attach a file to a wiki page, identified by 'pageId' or by 'spaceKey' + 'title': pass its bytes as 'contentBase64', or its content as 'text' when the file is text. Re-attaching a filename the page already has replaces its bytes and bumps its version, as the wiki does everywhere else, so retrying this call cannot leave two copies. A file on the person's own disk — a screenshot, a PDF — is better attached by path through the pm-files MCP server than typed out as base64; local_files_setup says how to connect it. An attached file is not *on* the page until the body references it — the answer hands you the Markdown to add with update_wiki_page. An image may also carry a dark-theme version, attached as the same name with '-dark' before the extension (diagram.svg + diagram-dark.svg); the body still references the plain name. Requires permission to edit the page.

Esquema de entrada

{'type': 'object', 'required': ['filename'], 'properties': {'text': {'type': ['string', 'null'], 'default': None, 'description': "The file's content as text, stored as UTF-8 — for a log, CSV or Markdown file you are writing here. Alternative to 'contentBase64'; passing both is refused."}, 'title': {'type': ['string', 'null'], 'default': None, 'description': 'Exact page title, when identifying the page by title.'}, 'pageId': {'type': ['integer', 'null'], 'default': None, 'description': 'Page id (as returned by search_wiki).'}, 'comment': {'type': ['string', 'null'], 'default': None, 'description': "Short note about this upload, shown in the page's attachment list."}, 'filename': {'type': 'string', 'description': "File name to store, e.g. 'diagram.png'. Any directory part is dropped."}, 'mimeType': {'type': ['string', 'null'], 'default': None, 'description': "Content type to record for the listing, e.g. 'text/csv'. Ignored when the bytes identify themselves, and never used to serve the file."}, 'spaceKey': {'type': ['string', 'null'], 'default': None, 'description': 'Space key, when identifying the page by title.'}, 'contentBase64': {'type': ['string', 'null'], 'default': None, 'description': "The file's bytes, base64-encoded (a 'data:…;base64,…' URL is accepted and unwrapped). Use 'text' instead when the file is text."}}}

add_wiki_comment

Comment on a wiki page, or reply to one of its comments ('replyTo' is a comment id from get_wiki_page). A reply notifies the author of the comment it answers, whether or not they watch the page — no mention needed — and they are told once even if also mentioned. Identify the page by 'pageId', or by 'spaceKey' + 'title'. Markdown is rendered; mention someone as [@Their Name](user:username), the wiki's own form. Requires permission to comment in that project. Answers with 'notified' (who this actually reaches, the answered author included), 'answered' (for a reply: whose comment it answers, and 'notified' false with a 'reason' when they are not told) and 'unresolvedMentions' (what looked like a mention and reached nobody, each with a reason) — a wrong handle is stored as written and never refused, so that list is the only sign it did not land.

Esquema de entrada

{'type': 'object', 'required': ['body'], 'properties': {'body': {'type': 'string', 'description': 'Comment body as Markdown, which also carries $…$ / $$…$$ LaTeX formulas.'}, 'title': {'type': ['string', 'null'], 'default': None, 'description': 'Exact page title, when identifying the page by title.'}, 'pageId': {'type': ['integer', 'null'], 'default': None, 'description': 'Page id (as returned by search_wiki).'}, 'replyTo': {'type': ['integer', 'null'], 'default': None, 'description': 'The comment this one answers, as returned by get_wiki_page.'}, 'spaceKey': {'type': ['string', 'null'], 'default': None, 'description': 'Space key, when identifying the page by title.'}}}

admin_bank_transfer

Administrators only: where a bank transfer is to be sent (PM-625) — beneficiary, account and its own currency, bank and SWIFT, the intermediary bank if there is one, the purpose line, how many days a wire is given, and who last changed all of it. 'offered' is the one flag that answers «may a customer pick a transfer right now»: it is switched on AND carrying everything a payment needs, which is not the same as 'enabled'. A bill already issued carries its own frozen copy of these details and is not changed by what this returns. Amounts are always USD, whatever the account's own currency is.

Esquema de entrada

{'type': 'object', 'properties': {}}

admin_errors_week

Administrators only: the error collector's week — events and distinct errors per project against the week before, errors first seen that week with their release, the loudest by events and by people, and errors that came back after being resolved. The same numbers the weekly error report carries. A project the collector did not answer about has null counts and a reason, never zeros. Ask for an earlier week with weeksAgo.

Esquema de entrada

{'type': 'object', 'properties': {'weeksAgo': {'type': 'integer', 'default': 0, 'description': '0 is the last full week, 1 the one before it.'}}}

admin_funnel

Administrators only: the installation as a business over a period — registrations, how many of them became working companies, purchases and conversion by cohort, churn, and money. Money comes in two halves that must not be added together: 'stock' is what recurs every month at today's prices, 'revenue' is what actually arrived inside the period. Each carries its own currency. Figures come from the fleet's ledger, so 'machines' says how current each machine's copy is — a machine that is behind makes the totals older than they look, it does not make them wrong. 'activation' is how many of the companies registered in the period have had their first agent come in (the first request with a configured token), and how soon — within the hour, the day, the week. 'ai' is AI as money over the same period — what our key's calls cost at each provider, what companies were charged, the margin, the cost nobody was charged for and why, what has accrued and what 'ai' invoices still want — and is neither in 'stock' nor in 'revenue'. Its totals are null, never zero, while a machine has not reported its AI: 'ai.missing' names it and 'ai.reported' is the sum over the machines that did. Default period: the last 90 days.

Esquema de entrada

{'type': 'object', 'properties': {'to': {'type': ['string', 'null'], 'default': None, 'description': "End of the period, as YYYY-MM-DD, included. Use with 'from'."}, 'days': {'type': ['integer', 'null'], 'default': None, 'description': "How many days back from today. Defaults to 90, at most 730. Ignored when 'from' and 'to' are given."}, 'from': {'type': ['string', 'null'], 'default': None, 'description': "Start of the period, as YYYY-MM-DD. Use with 'to'."}}}

admin_invoices

Administrators only: what companies were asked to pay and what answered it — each invoice with its amount, its coin, whether it is paid and what is short, and the payments against it. Amounts are never added across coins: each row carries its own currency and they stay apart. The list is the fleet's ledger, so 'machines' says how current each machine's copy is. One invoice's delivery record belongs to the machine that took the payment and is not rolled up — the answer says so where it is missing rather than showing an empty list.

Esquema de entrada

{'type': 'object', 'properties': {'slug': {'type': ['string', 'null'], 'default': None, 'description': 'Only invoices of the company at this address.'}, 'limit': {'type': 'integer', 'default': 50, 'description': 'How many rows, newest first. Default 50, at most 100.'}, 'status': {'type': ['string', 'null'], 'default': None, 'description': "Only invoices in this state, e.g. 'open', 'paid', 'void'."}}}

admin_landing_week

Administrators only: the landing site's week — visits, where they came from, clicks on sign-up, and the registrations that followed. The same numbers the weekly report carries into the monitoring chat. Ask for an earlier week with weeksAgo. The rendered message is not returned, only the figures.

Esquema de entrada

{'type': 'object', 'properties': {'weeksAgo': {'type': 'integer', 'default': 0, 'description': '0 is the last full week, 1 the one before it.'}}}

admin_load

Administrators only: how loaded this machine is and what the language models cost. Load is this machine's own — database, streams, memory, processor, traffic and stored bytes, each as used against allowed, where an allowance is known. Model spend covers the assistant, search-by-sentence and translation over a rolling window, with totals and breakdowns by feature, by model and by day; costs are estimates from the prices recorded at the time. Who spent it is not returned here.

Esquema de entrada

{'type': 'object', 'properties': {'days': {'type': 'integer', 'default': 30, 'description': 'Window for model spend, in days. Default 30; 0 means all time.'}}}

admin_overview

Administrators only: the whole installation by the numbers — accounts, workspaces, projects, issues, comments and sprints, plus issues broken down by status and by project. Counted across every workspace, which is what makes it the installation's rather than one company's. A total is null, never zero, when a machine of the fleet did not answer: 'fleet' says which machines were asked and which are missing, and 'here' is always what this machine counted. The breakdowns are this machine's. Read a null as 'nobody knows', never as 'none'.

Esquema de entrada

{'type': 'object', 'properties': {}}

admin_set_bank_transfer

Administrators only, and this one CHANGES things: state where bank transfers are to be sent. Send the WHOLE set every time — anything left out is cleared, not kept, because details half of one bank and half of another are money sent to a mixture of two. Read admin_bank_transfer first and repeat what you are not changing. Switching the method on is refused while anything a payment needs is missing (beneficiary, account, swift, and a purpose line carrying {invoice}), and the refusal names the field; switching it off is never refused. 'minimumUsd' is a floor under the METHOD and not under the debt: a bill below it is offered the other ways to pay, and what is owed does not change. The change is recorded against the calling administrator. Bills already issued keep the details they were issued with.

Esquema de entrada

{'type': 'object', 'required': ['enabled'], 'properties': {'note': {'type': ['string', 'null'], 'default': None, 'description': 'A line for the payer, e.g. which charges are whose. Shown with the details.'}, 'swift': {'type': ['string', 'null'], 'default': None, 'description': "The bank's SWIFT/BIC."}, 'account': {'type': ['string', 'null'], 'default': None, 'description': 'The account number or IBAN.'}, 'enabled': {'type': 'boolean', 'description': 'Whether this installation takes transfers. On is refused while a required field is missing; off never is.'}, 'purpose': {'type': ['string', 'null'], 'default': None, 'description': "What the payer must write as the purpose. Has to carry {invoice} — a transfer that does not name its bill arrives as a sum nobody can place. Defaults to 'Invoice {invoice}'."}, 'bankName': {'type': ['string', 'null'], 'default': None, 'description': "The bank's name and address."}, 'minimumUsd': {'type': ['number', 'null'], 'default': None, 'description': 'The smallest bill that may be paid by transfer, in USD — correspondent fees eat a small one. Left out there is NO floor, which is the cleared state and not zero; a customer under it is offered the other ways to pay and told why.'}, 'beneficiary': {'type': ['string', 'null'], 'default': None, 'description': "Who the money is sent to — the account holder's name as the bank has it."}, 'daysToArrive': {'type': ['integer', 'null'], 'default': None, 'description': 'How many days a wire is given to arrive, 1 to 60. The period stays open that long. Left out, the stored number is kept (7 to start with).'}, 'accountCurrency': {'type': ['string', 'null'], 'default': None, 'description': "The account's OWN currency, e.g. 'AMD'. Bills stay in USD; this is what the receiving bank converts into."}, 'intermediaryBank': {'type': ['string', 'null'], 'default': None, 'description': "The intermediary bank's name, where one is needed."}, 'intermediarySwift': {'type': ['string', 'null'], 'default': None, 'description': "The intermediary bank's SWIFT/BIC."}, 'intermediaryAccount': {'type': ['string', 'null'], 'default': None, 'description': 'Our account at the intermediary bank.'}}}

admin_workspace_journal

Administrators only: what was done to one company and by whom — created, plan changed, period extended by hand, credited, suspended, resumed, erased — newest first, up to a hundred entries, each with the reason that was written down at the time. This is the answer to 'why is this company on a period nobody paid for'. The actor is our own operator, and is named because an entry without one answers nothing. A company living on another machine of the fleet is not here: the answer then names the machine to ask.

Esquema de entrada

{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': "The company's address — 'acme' in acme.kaiku.tech."}}}

admin_workspaces

Administrators only: every company on the installation — its plan, what state it is in (trial, active, over-limit, suspended…), when what it paid for runs out, how many days are left, what it is using against what it may use, and its balance. Ask with endingInDays to get only the ones running out that soon, which is how 'whose trial ends this week' is answered in one call. 'attention' is the console's own short list of rows somebody has to look at. A meter reading null means the machine holding that company was not asked, not that it is idle. Owners are left out unless withOwners is true, and an e-mail address is never returned.

Esquema de entrada

{'type': 'object', 'properties': {'slug': {'type': ['string', 'null'], 'default': None, 'description': "Only the company at this address ('acme' in acme.kaiku.tech)."}, 'status': {'type': ['string', 'null'], 'default': None, 'description': "Only companies in this state: 'trial', 'active', 'free', 'over-limit', 'expired', 'suspended'."}, 'withOwners': {'type': 'boolean', 'default': False, 'description': 'Include who owns each company — username and display name, never an e-mail. Off by default: this is a statistics surface, and a list of customers with names on it is a customer list.'}, 'endingInDays': {'type': ['integer', 'null'], 'default': None, 'description': 'Only companies whose paid-for period ends within this many days. 0 means already run out.'}}}

answer_issue_question

Answer a question that was put to you on an issue, by choosing one of its options. Only the person the question was addressed to may answer it; answering again with a different option changes the answer and says so in the thread. A question whose deadline already passed can still be answered — that replaces whatever the deadline took, and the change is recorded. The answer is written into the thread as an ordinary comment and the asker is told.

Esquema de entrada

{'type': 'object', 'required': ['questionId', 'option'], 'properties': {'note': {'type': ['string', 'null'], 'default': None, 'description': "Words of your own beside the option — a qualification, not the answer itself ('Postgres, but only after the migration lands'). Ignored when the asker switched free text off; check 'allowsFreeText' on the question."}, 'option': {'type': 'integer', 'description': 'Which option to choose, counted from 0 in the order they were offered.'}, 'questionId': {'type': 'integer', 'description': "The question's id, as returned by list_issue_questions or ask_issue_question."}}}

ask_issue_question

Ask one person a question with pre-written answer options, in an issue's thread — the way to get a decision that does not get lost in the comment stream. The question appears as an ordinary comment (so every Jira-speaking reader sees it) and is tracked separately: the person you ask sees it counted in their Questions list until they answer. It does not wait for ever — give 'defaultOption' and the deadline takes it if nobody answers, so a blocked run can go on. Requires permission to comment in that project. NOTE: this is not the bgs 'ask_question' tool, which is the background-agent ledger — this one is a question to a person on a PM issue.

Esquema de entrada

{'type': 'object', 'required': ['key', 'to', 'question', 'options'], 'properties': {'to': {'type': 'string', 'description': 'Who to ask: the username, which list_users hands you ready-made — never the display name. They must be able to see this project, and it cannot be you.'}, 'key': {'type': 'string', 'description': "Issue key, e.g. 'UK-1'."}, 'options': {'type': 'array', 'items': {'type': 'string'}, 'description': 'The answer options, in the order to offer them: at least 2, at most 8, each a short label rather than a paragraph. Fewer than two is not a question with options — that is a comment.'}, 'question': {'type': 'string', 'description': 'The question itself. Keep it to what the options answer.'}, 'ttlHours': {'type': ['integer', 'null'], 'default': None, 'description': 'How long to wait, in hours. Omitted is 48 (two days). 0 means no deadline at all — the question waits until somebody answers it, which is rarely what an agent wants.'}, 'allowFreeText': {'type': 'boolean', 'default': True, 'description': 'Whether the answerer may add words of their own beside the option they choose. Defaults to true. Set false when the answer has to be machine-comparable and nothing else.'}, 'defaultOption': {'type': ['integer', 'null'], 'default': None, 'description': 'Which option to take if nobody answers before the deadline, counted from 0. Give one whenever there is a safe assumption — it is what lets you carry on rather than stall. Omit it when no option is safe to assume: then the deadline only stops the waiting and decides nothing.'}}}

create_issue

Create an issue in a project visible to this token. Returns the new issue key. Requires permission to create issues in that project. Answers with 'notified' (who this actually reaches) and 'unresolvedMentions' (what looked like a mention and reached nobody, each with a reason) — a wrong handle is stored as written and never refused, so that list is the only sign it did not land.

Esquema de entrada

{'type': 'object', 'required': ['projectKey', 'summary'], 'properties': {'type': {'type': ['string', 'null'], 'default': None, 'description': "Issue type name, e.g. 'Task', 'Bug', 'Story', 'Epic'. Defaults to 'Task'."}, 'labels': {'type': ['string', 'null'], 'default': None, 'description': 'Labels to set, space or comma separated.'}, 'dueDate': {'type': ['string', 'null'], 'default': None, 'description': 'The day this is due, as YYYY-MM-DD. A calendar day, not a timestamp — do not send a time or a zone.'}, 'summary': {'type': 'string', 'description': 'Issue summary (title).'}, 'assignee': {'type': ['string', 'null'], 'default': None, 'description': 'Assignee username or email. Omit to leave unassigned.'}, 'priority': {'type': ['string', 'null'], 'default': None, 'description': "Priority name, e.g. 'High'."}, 'parentKey': {'type': ['string', 'null'], 'default': None, 'description': 'Parent issue key, to create this as a child/sub-task.'}, 'projectKey': {'type': 'string', 'description': "Project key, e.g. 'UK'."}, 'description': {'type': ['string', 'null'], 'default': None, 'description': 'Issue description. Markdown is kept as written, and carries $…$ / $$…$$ LaTeX formulas and [~username] mentions (the username, which list_users hands you ready-made — never the display name).'}}}

create_project

Administrators only: create a project — a new key, a starter board, and its own wiki space, led by you unless you name someone else. The key is yours to choose and is never invented for you: one already taken is refused, naming the project holding it, rather than quietly becoming KEY2 — the key shows in every issue key, link and commit, and renaming it later costs more than creating the project did. Calling it again with the same key and name returns that same project with created:false, so a retry after a lost answer cannot make a second project. Deleting one is not offered here: that is a decision a person makes looking at what is inside. Who may: an administrator of this workspace, or — for a subproject — the lead of the parent, since it hands over their own project's people.

Esquema de entrada

{'type': 'object', 'required': ['key', 'name'], 'properties': {'key': {'type': 'string', 'description': "Project key, 2–10 characters: a letter followed by letters or digits, e.g. 'BGS'. Uppercased."}, 'lead': {'type': ['string', 'null'], 'default': None, 'description': 'Username or email of the project lead. Defaults to you — a project with no lead is one nobody can configure: export, colour, the bgs connection and access grants all need a lead or an admin.'}, 'name': {'type': 'string', 'description': "Project name, e.g. 'Background agents'."}, 'parentKey': {'type': ['string', 'null'], 'default': None, 'description': "Key of the project this one is a subproject of. Everybody who may reach the parent may reach this project too, in the role they hold there — so add only the people the parent does not already have. Leave it out for a project of its own. One level: a subproject cannot have subprojects. The key here is still an ordinary key ('KYCB2B', not 'KYC-B2B'), because it is what every issue key is built from."}, 'description': {'type': ['string', 'null'], 'default': None, 'description': 'What the project is for. Markdown.'}, 'projectTypeKey': {'type': ['string', 'null'], 'default': None, 'description': "Jira project type: 'software' (the default), 'business' or 'service_desk'."}}}

create_project_rule

Add a rule to a project: when an issue enters 'status', append 'template' to its description. A rule appends its checklist to an issue's description when the issue ENTERS the rule's state — from the board, the Jira API or update_issue alike. The block starts with a hidden marker line '[//]: # (pm-rule:<id>)'; while that line is in the description, entering the state again adds nothing (the journal says 'alreadyThere'). A [~username] in the template is a mention: that person is notified when the checklist lands. A checklist that would make the description too long is not added and the journal says 'tooLong'; the move itself still happens. A rule with action 'agent' is a DUTY instead: it says which issues may be handed to an agent role (agentRole, e.g. 'product') and what the agent may do with them. Its 'template' is then the INSTRUCTION — what doing such an issue means in this project — and nothing is appended anywhere. A duty may have no state (pass an empty 'status'): then an issue is handed only by a person. agentActions is a list from: describe, subtasks, ask, wiki, report, support. agentFields names the fields it may set: priority, labels, duedate, or the project's own fields by name. doneStatus is the state it moves the issue to when done — never a finished one. capUsd raises what one task may cost, up to 5 dollars. Commenting is always allowed; finishing, deleting, reassigning and anything outside the issue never are. Saving or switching on a duty makes it yours: it runs on your behalf and access, and is switched off if you lose the project. The state and the type are NAMES of this project's own (list_project_rules lists them); an unknown one is refused with the list. Project lead or admin only.

Esquema de entrada

{'type': 'object', 'required': ['projectKey', 'name', 'status', 'template'], 'properties': {'name': {'type': 'string', 'description': "What the rule is called, e.g. 'Document pack'. At most 120 characters."}, 'type': {'type': ['string', 'null'], 'default': None, 'description': "Only issues of this type, by name, e.g. 'Bug'. Leave out for any type."}, 'label': {'type': ['string', 'null'], 'default': None, 'description': 'Only issues carrying this label (one word). Leave out for any label.'}, 'action': {'type': ['string', 'null'], 'default': None, 'description': "'checklist' (the default) or 'agent' for a duty. Fixed once the rule exists."}, 'capUsd': {'type': ['number', 'null'], 'default': None, 'description': 'For a duty: what one task may cost, in dollars, when more than the ordinary ceiling is needed. At most 5.'}, 'status': {'type': 'string', 'description': "The state whose ENTRY fires the rule, by name, e.g. 'Ready for review'. For a duty taken only by hand, an empty string."}, 'enabled': {'type': 'boolean', 'default': True, 'description': 'Whether the rule is on from the start. Default true.'}, 'template': {'type': 'string', 'description': "The checklist, as Markdown: a '### Heading' per group, '- [ ] item' per line, two spaces of indent to nest an item under another, and [~username] on an item to name who does it. For a duty: the instruction."}, 'agentRole': {'type': ['string', 'null'], 'default': None, 'description': "For a duty: the agent role's key, e.g. 'product'."}, 'doneStatus': {'type': ['string', 'null'], 'default': None, 'description': 'For a duty: the state it moves the issue to when done. Never a finished state. Leave out and it does not move the issue.'}, 'projectKey': {'type': 'string', 'description': "Project key, e.g. 'ONB'."}, 'agentFields': {'type': ['string', 'null'], 'default': None, 'description': "For a duty: the fields it may set, comma-separated — priority, labels, duedate, or a project field's name."}, 'agentActions': {'type': ['string', 'null'], 'default': None, 'description': 'For a duty: what the agent may do beyond commenting, comma-separated — describe, subtasks, ask, wiki, report, support.'}}}

create_wiki_page

Create a wiki page from Markdown in a space you can write to. Hangs off the space home page unless you name a parent (by 'parentId', or by 'parentTitle' within the same space). Returns the new page id and its URL. Mention someone as [@Their Name](user:username) — on a wiki page that is the form that notifies, not the [~username] used in issues; link another page as [text](page:Title) or [text](page:SPACE/Title). Answers with 'notified' (who this actually reaches) and 'unresolvedMentions' (what looked like a mention and reached nobody, each with a reason) — a wrong handle is stored as written and never refused, so that list is the only sign it did not land.

Esquema de entrada

{'type': 'object', 'required': ['spaceKey', 'title'], 'properties': {'title': {'type': 'string', 'description': 'Page title. Must be unique within the space — the title is how pages are addressed here.'}, 'labels': {'type': ['string', 'null'], 'default': None, 'description': 'Labels to set, space or comma separated.'}, 'markdown': {'type': ['string', 'null'], 'default': None, 'description': "Page body as Markdown, which also carries $…$ / $$…$$ LaTeX formulas and the wiki's macros on a line of their own — {toc}, {children}, {info} … {info}, {expand:title=…} … {expand}."}, 'parentId': {'type': ['integer', 'null'], 'default': None, 'description': 'Parent page id. Omit to hang the page off the space home page.'}, 'spaceKey': {'type': 'string', 'description': "Space key, e.g. 'PM'. Every project has exactly one space, keyed like the project."}, 'parentTitle': {'type': ['string', 'null'], 'default': None, 'description': "Parent page title, as an alternative to 'parentId'. Must be a page in the same space."}}}

decide_support_letter

Decide what a held or failed letter to the support address is. 'release' files it as if it had just arrived, past the spam filter and the limits: it joins the request it proves it answers, or opens a new one (and the sender gets the usual acknowledgement). 'dismiss' says it is not a request; its files are dropped and the row is deleted with the other unfiled letters after 30 days. Requires full write access to the support project.

Esquema de entrada

{'type': 'object', 'required': ['letterId', 'decision'], 'properties': {'decision': {'type': 'string', 'description': "'release' or 'dismiss'."}, 'letterId': {'type': 'integer', 'description': "The letter's id, from list_support_letters."}}}

delete_agent_usage

Remove one agent-usage record from an issue, by the id that get_agent_usage returns. For correcting a record's numbers, re-send it with report_agent_usage instead — the same source + externalId updates in place. Requires permission to edit the issue.

Esquema de entrada

{'type': 'object', 'required': ['key', 'id'], 'properties': {'id': {'type': 'integer', 'description': 'Record id, as returned by get_agent_usage.'}, 'key': {'type': 'string', 'description': "Issue key, e.g. 'UK-1'."}}}

delete_attachment

Remove a file from an issue, by 'filename' or by attachment 'id' — both come back from get_issue. Requires permission to edit issues in that project.

Esquema de entrada

{'type': 'object', 'required': ['key'], 'properties': {'id': {'type': ['integer', 'null'], 'default': None, 'description': "Attachment id, as listed by get_issue. An alternative to 'filename'."}, 'key': {'type': 'string', 'description': "Issue key, e.g. 'UK-1'."}, 'filename': {'type': ['string', 'null'], 'default': None, 'description': 'File name to remove, as listed by get_issue.'}}}

delete_project_field

Remove a column from a project. Answers with how many issues lost a value, because that number is what the decision was about — the issues themselves are untouched. Project lead or admin only.

Esquema de entrada

{'type': 'object', 'required': ['projectKey', 'name'], 'properties': {'name': {'type': 'string', 'description': "Field name, e.g. 'Provider'."}, 'projectKey': {'type': 'string', 'description': "Project key, e.g. 'CRM'."}}}

delete_project_issue_type

Remove an issue type of this project's own. Refused while any issue is of it or any field is kept for it — change those first; a rule on it goes with it. Project lead or admin only.

Esquema de entrada

{'type': 'object', 'required': ['projectKey', 'name'], 'properties': {'name': {'type': 'string', 'description': "The own type's name."}, 'projectKey': {'type': 'string', 'description': "Project key, e.g. 'TH'."}}}

delete_project_rule

Remove a project rule, by its id from list_project_rules. Checklists it already added stay in their issues; its journal goes with it. To stop it for a while instead, update_project_rule with enabled=false. Project lead or admin only.

Esquema de entrada

{'type': 'object', 'required': ['projectKey', 'id'], 'properties': {'id': {'type': 'integer', 'description': "The rule's id, from list_project_rules."}, 'projectKey': {'type': 'string', 'description': "Project key, e.g. 'ONB'."}}}

delete_wiki_attachment

Remove a file from a wiki page, by its 'filename' as listed by get_wiki_page. Identify the page by 'pageId', or by 'spaceKey' + 'title'. References to it in the page body are left alone — they simply stop resolving, so tidy the body too if it named the file. Requires permission to edit the page.

Esquema de entrada

{'type': 'object', 'required': ['filename'], 'properties': {'title': {'type': ['string', 'null'], 'default': None, 'description': 'Exact page title, when identifying the page by title.'}, 'pageId': {'type': ['integer', 'null'], 'default': None, 'description': 'Page id (as returned by search_wiki).'}, 'filename': {'type': 'string', 'description': 'File name to remove, as listed by get_wiki_page.'}, 'spaceKey': {'type': ['string', 'null'], 'default': None, 'description': 'Space key, when identifying the page by title.'}}}

delete_wiki_page

Delete a wiki page. Identify it by 'id', or by 'spaceKey' + 'title'. A page with children takes its whole subtree with it, so that is refused unless you pass includeChildren: true — the answer names what would go. The space home page can never be deleted. Requires permission to edit the wiki.

Esquema de entrada

{'type': 'object', 'properties': {'id': {'type': ['integer', 'null'], 'default': None, 'description': 'Page id (as returned by search_wiki).'}, 'title': {'type': ['string', 'null'], 'default': None, 'description': 'Exact page title, when identifying the page by title.'}, 'spaceKey': {'type': ['string', 'null'], 'default': None, 'description': 'Space key, when identifying the page by title.'}, 'includeChildren': {'type': 'boolean', 'default': False, 'description': "Delete the page's descendants along with it. Off by default."}}}

get_agent_usage

What background-agent runs have cost an issue (local or mirrored/upstream): one record per run (tokens by kind, machine time, agent/model/host) plus the totals. A null metric means nobody reported it — which is not the same as zero, so 'reporting' says how many records carried each metric.

Esquema de entrada

{'type': 'object', 'required': ['key'], 'properties': {'key': {'type': 'string', 'description': "Issue key, e.g. 'UK-1'."}}}

get_attachment

Read one file attached to an issue — its bytes, base64-encoded — by the issue key and the 'filename' as get_issue lists it. The bytes travel as text through the conversation and cost roughly a third more than the file itself, so there is a size ceiling; the pm-files MCP server saves a file to a path instead, without spending the conversation on it (local_files_setup says how to connect it). Reading needs only permission to see the issue.

Esquema de entrada

{'type': 'object', 'required': ['key', 'filename'], 'properties': {'key': {'type': 'string', 'description': "Issue key, e.g. 'UK-1'."}, 'filename': {'type': 'string', 'description': 'File name, as listed by get_issue.'}}}

get_change

The files one merge request, pull request or commit touches, with their diffs. Large diffs arrive cut.

Esquema de entrada

{'type': 'object', 'required': ['change'], 'properties': {'repo': {'type': ['string', 'null'], 'default': None, 'description': "Which repository, as 'group/repo'. Omit when only one is open."}, 'change': {'type': 'string', 'description': "The merge request or pull request number ('!12', '#12' or '12'), or a commit's hash."}}}

get_comments

Read the discussion on an issue, oldest first. Without 'startAt' you get the END of the thread — the most recent 'limit' comments — because catching up means reading the latest, not the first ever written; 'earlier' says how many stand before the page you got, and 'startAt' walks back through them. Each 'body' comes back exactly as written, which is also the text update_comment's 'edits' are matched against. A reply carries 'replyTo', the id of the comment it answers (null otherwise) — pass the same id to add_comment's 'replyTo' to answer one. Comments that were deleted are not listed. Needs only permission to see the issue.

Esquema de entrada

{'type': 'object', 'required': ['key'], 'properties': {'key': {'type': 'string', 'description': "Issue key, e.g. 'UK-1'."}, 'limit': {'type': 'integer', 'default': 20, 'description': 'How many comments to return (default 20, max 100).'}, 'startAt': {'type': ['integer', 'null'], 'default': None, 'description': "Where to start, counted from the OLDEST comment as 0. Omit for the most recent page; pass 'startAt' - 'limit' from a previous answer to step back one page."}}}

get_issue

Get one issue by key (e.g. 'UK-1') if it is visible to this token, including its description, status, assignee, labels, sub-tasks, the issues it is linked to and the wiki pages linked to it. 'comments' is a COUNT, not the text — read the thread itself with get_comments whenever it is not zero: decisions, the map of what is attached and how to run the thing are often written there rather than in the description.

Esquema de entrada

{'type': 'object', 'required': ['key'], 'properties': {'key': {'type': 'string', 'description': "Issue key, e.g. 'UK-1'."}}}

get_project_rule_runs

A project rule's journal, newest first: each time an issue entered the rule's state and matched its conditions — which issue, who moved it, and the outcome: 'applied' (checklist added), 'alreadyThere' (its marker line was already in the description, nothing added) or 'tooLong' (the description would have been too long, nothing added); for a duty, 'handed' (the issue went to its agent), 'busy' (an agent already had it), 'tooMany' (the duty's fifty a day were used up) or 'refused' with a 'reason' (agent_off, agent_budget, …), and 'ownerLost' when the duty was switched off because its owner lost the project. The place to look when a checklist did not appear or an agent did not take an issue. Any member may read it.

Esquema de entrada

{'type': 'object', 'required': ['projectKey', 'id'], 'properties': {'id': {'type': 'integer', 'description': "The rule's id, from list_project_rules."}, 'limit': {'type': 'integer', 'default': 20, 'description': 'How many lines, newest first (default 20, max 100).'}, 'projectKey': {'type': 'string', 'description': "Project key, e.g. 'ONB'."}}}

get_support_letter

Read one letter to the support address whole — the quoted thread and the signature that the request's comment leaves out, the HTML part as text, and the headers. 'letterId' comes from list_support_letters or from get_support_request's messages. A letter in a request is readable by whoever can read that issue; any other only by the support project's full members.

Esquema de entrada

{'type': 'object', 'required': ['letterId'], 'properties': {'letterId': {'type': 'integer', 'description': "The letter's id."}}}

get_support_request

Read who is behind a support request: the requester's name and email, whether they asked signed in (and from which workspace), their client version, what the product knew when they asked from inside it ('context': the screen, the client, the last refusal the server gave them with its request id), and which comments of the issue the requester can see ('messages', by comment id and direction; 'autoRule' names the rule when the desk's automatic answer wrote it rather than a person, 'autoWording' says whether the model worded it or the template went). Every other comment on the issue is internal — the requester never sees it. Answers found=false for an issue that is not a support request.

Esquema de entrada

{'type': 'object', 'required': ['key'], 'properties': {'key': {'type': 'string', 'description': "Issue key of the request, e.g. 'SUPPORT-12'."}}}

get_wiki_attachment

Read one file attached to a wiki page — its bytes, base64-encoded — identifying the page by 'pageId' or by 'spaceKey' + 'title' and the file by 'filename' as get_wiki_page lists it. This is how a file is copied from one page to another: read it here, write it with add_wiki_attachment. The bytes travel as text through the conversation and cost roughly a third more than the file itself, so there is a size ceiling; for anything larger — or for putting the file on disk — the pm-files MCP server saves it to a path instead (local_files_setup says how to connect it). Reading needs only permission to see the page.

Esquema de entrada

{'type': 'object', 'required': ['filename'], 'properties': {'title': {'type': ['string', 'null'], 'default': None, 'description': 'Exact page title, when identifying the page by title.'}, 'pageId': {'type': ['integer', 'null'], 'default': None, 'description': 'Page id (as returned by search_wiki).'}, 'filename': {'type': 'string', 'description': 'File name, as listed by get_wiki_page.'}, 'spaceKey': {'type': ['string', 'null'], 'default': None, 'description': 'Space key, when identifying the page by title.'}}}

get_wiki_page

Get one wiki page by id, or by space key + title, if it is visible to this token. Returns the page text, its labels, its parent and child pages, its comments, and the issues linked to it. Pass withMarkdown: true when you intend to edit it — you then get the page's Markdown source to change and hand back to update_wiki_page, and each comment's own Markdown, version and anchor for update_wiki_comment. A large page is read a part at a time: 'outline' lists its headings and how big each section is, then 'section' returns one of them (or 'offset'/'limit' a run of lines), and update_wiki_page's 'edits' changes just the words you mean without sending the page back.

Esquema de entrada

{'type': 'object', 'properties': {'id': {'type': ['integer', 'null'], 'default': None, 'description': 'Page id (as returned by search_wiki).'}, 'limit': {'type': ['integer', 'null'], 'default': None, 'description': "How many lines to return from 'offset' (default 200)."}, 'title': {'type': ['string', 'null'], 'default': None, 'description': 'Exact page title, when looking the page up by title.'}, 'offset': {'type': ['integer', 'null'], 'default': None, 'description': "Return only the Markdown source from this 1-based line on — for a page without headings to navigate by. Pair with 'limit'."}, 'outline': {'type': 'boolean', 'default': False, 'description': "Return the page's table of contents instead of its body: per heading its level, text, anchor, the 1-based lines its section spans in the Markdown source, and its size in characters. Start here on a large page."}, 'section': {'type': ['string', 'null'], 'default': None, 'description': "Return only this section's Markdown — its heading line down to the next heading of the same or a higher level, subsections included. Name it by its anchor (as 'outline' gives it: the id a {toc} entry links to) or by its heading text."}, 'spaceKey': {'type': ['string', 'null'], 'default': None, 'description': 'Space key, when looking the page up by title.'}, 'withRelated': {'type': 'boolean', 'default': False, 'description': "With 'outline', 'section' or 'offset': also return the page's children, attachments, comments and linked issues, which a partial read otherwise leaves out."}, 'withMarkdown': {'type': 'boolean', 'default': False, 'description': "Return the Markdown source ('markdown') instead of the plain text — what to edit and pass back to update_wiki_page, and, for each comment, to update_wiki_comment. Off by default: reading costs less as text."}}}

link_issues

Link two issues: link_issues('PM-419', 'PM-417', 'is blocked by') records that PM-419 is blocked by PM-417. 'type' is the PHRASE, said as a person says it — 'blocks', 'is blocked by', 'duplicates', 'is duplicated by', 'clones', 'relates to' — so the direction is in the words and the arguments cannot disagree; a bare type name ('Blocks') points outward, as it does in Jira. A phrase this workspace does not have is REFUSED and the ones it does have are named, rather than quietly becoming 'relates to'. The link then shows on both issues (get_issue returns 'links'), and linking the same pair the same way again changes nothing. Requires permission to edit BOTH issues — a link is a change to the issue at each end.

Esquema de entrada

{'type': 'object', 'required': ['from', 'to', 'type'], 'properties': {'to': {'type': 'string', 'description': "The issue at the other end, e.g. 'PM-417'."}, 'from': {'type': 'string', 'description': "The issue the phrase is said about, e.g. 'PM-419'."}, 'type': {'type': 'string', 'description': "How 'from' relates to 'to', in words: 'blocks', 'is blocked by', 'duplicates', 'clones', 'relates to'. Whatever this workspace's link types call themselves — a refusal lists them."}}}

link_wiki_page

Link a wiki page to an issue. The link then shows on both the issue and the page, and survives the page being renamed or moved. Identify the page by 'pageId', or by 'spaceKey' + 'title'. Linking the same page again updates that link instead of adding a second one. Requires permission to edit the issue.

Esquema de entrada

{'type': 'object', 'required': ['issueKey'], 'properties': {'title': {'type': ['string', 'null'], 'default': None, 'description': 'Exact page title, when identifying the page by title.'}, 'pageId': {'type': ['integer', 'null'], 'default': None, 'description': 'Page id (as returned by search_wiki).'}, 'issueKey': {'type': 'string', 'description': "Issue key, e.g. 'UK-1'."}, 'spaceKey': {'type': ['string', 'null'], 'default': None, 'description': 'Space key, when identifying the page by title.'}, 'relationship': {'type': ['string', 'null'], 'default': None, 'description': "How the page relates to the issue, free text — e.g. 'documentation' (the default), 'specification', 'design'."}}}

list_code

List a directory of a repository connected to a project. Only repositories whose owners opened them to agents can be read.

Esquema de entrada

{'type': 'object', 'properties': {'path': {'type': ['string', 'null'], 'default': None, 'description': 'Directory inside the repository. Omit for its root.'}, 'repo': {'type': ['string', 'null'], 'default': None, 'description': "Which repository, as 'group/repo'. Its last segment alone is enough when unambiguous; omit it when only one is open."}, 'reference': {'type': ['string', 'null'], 'default': None, 'description': 'Branch, tag or commit. Omit for the default branch.'}}}

list_credentials

List the credentials attached to an issue or a wiki page that this token may read — names and who attached them, never the values. Pass issueKey or pageId. Use reveal_credential to read one value, and only when you are about to use it.

Esquema de entrada

{'type': 'object', 'properties': {'pageId': {'type': ['integer', 'null'], 'default': None, 'description': 'Wiki page id.'}, 'issueKey': {'type': ['string', 'null'], 'default': None, 'description': "Issue key, e.g. 'UK-1'."}}}

list_issue_questions

Questions with answer options, in either direction: what is waiting on YOU to answer (role='to_me'), what YOU asked and are waiting on somebody for (role='asked'), or everything on one issue. This is how you find out whether the question you asked has been answered — poll it, since ask_issue_question does not wait. With no 'key' the default is role='to_me'; with a 'key' it is every question on that issue. Open ones by default; pass state='all' for the answered, withdrawn and expired ones too.

Esquema de entrada

{'type': 'object', 'properties': {'key': {'type': ['string', 'null'], 'default': None, 'description': "Limit to one issue, e.g. 'UK-1'. Omit to look across every project this token can reach."}, 'from': {'type': ['string', 'null'], 'default': None, 'description': "'agent' for only what an agent put to somebody (a resolution, PM-602), 'people' for only what a person asked. Omit for both."}, 'role': {'type': ['string', 'null'], 'default': None, 'description': "Whose questions: 'to_me' (waiting on you to answer), 'asked' (you asked them, and you are waiting), or 'any'. Defaults to 'to_me' with no key, and to 'any' when a key is given."}, 'limit': {'type': 'integer', 'default': 20, 'description': 'How many to return (default 20, max 100).'}, 'state': {'type': ['string', 'null'], 'default': 'open', 'description': "'open' (the default — still waiting on somebody) or 'all', which adds the answered, the withdrawn and the expired (the deadline passed with no default and no answer)."}}}

list_mcp_connections

List the external MCP connections configured for a project. Auth tokens are never returned (only whether one is set).

Esquema de entrada

{'type': 'object', 'required': ['projectKey'], 'properties': {'projectKey': {'type': 'string', 'description': "Project key, e.g. 'UK'."}}}

list_project_fields

The columns a project keeps about its issues: name, kind, and a list's options with their colours. Also the customfield_… name each one answers to, for searching by JQL. Any member may read them.

Esquema de entrada

{'type': 'object', 'required': ['projectKey'], 'properties': {'projectKey': {'type': 'string', 'description': "Project key, e.g. 'CRM'."}}}

list_project_rules

A project's rules: when an issue enters a state, a checklist from a template is appended to its description. A rule appends its checklist to an issue's description when the issue ENTERS the rule's state — from the board, the Jira API or update_issue alike. The block starts with a hidden marker line '[//]: # (pm-rule:<id>)'; while that line is in the description, entering the state again adds nothing (the journal says 'alreadyThere'). A [~username] in the template is a mention: that person is notified when the checklist lands. A checklist that would make the description too long is not added and the journal says 'tooLong'; the move itself still happens. A rule with action 'agent' is a DUTY instead: it says which issues may be handed to an agent role (agentRole, e.g. 'product') and what the agent may do with them. Its 'template' is then the INSTRUCTION — what doing such an issue means in this project — and nothing is appended anywhere. A duty may have no state (pass an empty 'status'): then an issue is handed only by a person. agentActions is a list from: describe, subtasks, ask, wiki, report, support. agentFields names the fields it may set: priority, labels, duedate, or the project's own fields by name. doneStatus is the state it moves the issue to when done — never a finished one. capUsd raises what one task may cost, up to 5 dollars. Commenting is always allowed; finishing, deleting, reassigning and anything outside the issue never are. Saving or switching on a duty makes it yours: it runs on your behalf and access, and is switched off if you lose the project. Answers with each rule's id (the other rule tools take it), action, state, conditions (type, label — null means any), template and whether it is on, and for a duty its 'agent' part; with the state and type names a rule may use, the agent roles, actions and fields a duty may name where agents are on; and 'canEdit'. Any member may read them.

Esquema de entrada

{'type': 'object', 'required': ['projectKey'], 'properties': {'projectKey': {'type': 'string', 'description': "Project key, e.g. 'ONB'."}}}

list_projects

List the projects visible to this token (a project-scoped token sees only its project). A project with a 'parent' is a subproject of that one: it has its own issues, board and wiki, and shares only who may reach it.

Esquema de entrada

{'type': 'object', 'properties': {}}

list_support_letters

List letters to the support address that did not become part of a request: 'held' (looked like spam, or too many at once from one address or on one request), 'failed' (we could not file them), 'ignored' (an autoresponder, a bounce, a mailing list, our own letter), 'dismissed'. Without 'state', held and failed — the ones waiting for a person. Each has an id, the reason, the sender, the subject and the file names. Only a full member of the support project may read them: they are strangers' words.

Esquema de entrada

{'type': 'object', 'properties': {'state': {'type': ['string', 'null'], 'default': None, 'description': "One of 'held', 'failed', 'ignored', 'dismissed'. Omit for held and failed."}}}

list_support_queue

The support desk's queue: open requests, the most urgent first — overdue, then due soonest, then those waiting on their requester. Each item says whose turn it is ('clock.turn': 'first' = nobody has answered yet, 'reply' = the requester wrote again, 'requester' = we answered last and the clock is stopped), since when it has waited, the working hours waited, when the answer is due and whether it is 'onTime', 'dueSoon' or 'overdue'; plus the assignee. 'numbers' has the current counts and, over the last 30 days, the median time to a first human answer and to resolution (in working hours — weekdays only) and the share answered within the promise. An automatic acknowledgement or automatic answer is never counted as an answer; 'numbers.auto' says how many requests the automatic answer got, how many were then resolved with no human reply and no further word from the requester ('settled'), and how many requesters wrote again after it ('askedAgain') — per rule too. An item's 'autoRule' is set when the request got an automatic answer. Readable by anybody who can read the support project.

Esquema de entrada

{'type': 'object', 'properties': {'who': {'type': ['string', 'null'], 'default': None, 'description': "'all' (default), 'mine' (assigned to you) or 'unassigned'."}}}

list_tracks

The tracks a project is cut into: a track is a LABEL the project declared meaningful — a play, a campaign, a rollout — and work joins one by carrying that label. A track has no key of its own; its issues keep the project's key, which is what makes it a different thing from a subproject (a separate project, see create_project's parentKey). Any member may read them.

Esquema de entrada

{'type': 'object', 'required': ['projectKey'], 'properties': {'projectKey': {'type': 'string', 'description': "Project key, e.g. 'TH'."}}}

list_users

List the people you can assign work to or mention: the members of the projects this token can see. Optionally filter by free text (username, display name or email) or narrow to one project. Mention someone in a description or comment as [~username] — a mention matches the username, never the display name — and pass the same username (or the email) as 'assignee'.

Esquema de entrada

{'type': 'object', 'properties': {'text': {'type': ['string', 'null'], 'default': None, 'description': 'Free text to match in username, display name or email.'}, 'limit': {'type': 'integer', 'default': 50, 'description': 'Max users to return (default 50, max 200).'}, 'projectKey': {'type': ['string', 'null'], 'default': None, 'description': 'Restrict to members of this project key (must be visible to the token).'}, 'includeInactive': {'type': 'boolean', 'default': False, 'description': 'Include deactivated accounts, which can be neither assigned nor mentioned. Off by default.'}}}

list_wiki_spaces

List the wiki spaces visible to this token. Every project has exactly one space, keyed like the project.

Esquema de entrada

{'type': 'object', 'properties': {}}

local_files_setup

How the person connects pm-files — a small local MCP server that attaches files from their own computer to issues and wiki pages by path, and saves attachments back to files, so no bytes pass through the conversation. Call it when you need a local file (a screenshot, a document, anything past the base64 ceiling) and pm-files is not among your tools: hand the person the command for their client, with this workspace's address already in it. It never contains a token, and you must never ask for one — the command takes it from the person's clipboard. Changes nothing.

Esquema de entrada

{'type': 'object', 'properties': {}}

move_issue

Move an issue into another project, taking its comments, history, attachments, links and sub-tasks with it. The key does NOT change: 'PM-12' stays 'PM-12' wherever it lives, so every existing link and branch name goes on working. Call it with apply=false first (the default): the answer says what the move would cost — values in columns the target project does not have are LOST, the sprint is cleared, and a secret attached to the issue becomes readable by the target project's lead. Refuses when the target has no state by the issue's status name; say what that state becomes with 'statuses'. A sub-task cannot move on its own — move its parent. Needs full write access in BOTH projects.

Esquema de entrada

{'type': 'object', 'required': ['key', 'toProject'], 'properties': {'key': {'type': 'string', 'description': "The issue to move, e.g. 'PM-12'."}, 'apply': {'type': 'boolean', 'default': False, 'description': 'false (the default) answers what the move would do and changes nothing. true does it.'}, 'statuses': {'type': ['string', 'null'], 'default': None, 'description': "What each source status becomes in the target project, as 'In Review=Review, Blocked=On hold'. Only needed for states the target does not already have under the same name."}, 'toProject': {'type': 'string', 'description': "Project key to move it into, e.g. 'CRM'."}}}

read_code

Read one file from a repository connected to a project. A long file arrives cut and says so; generated and binary files are not read.

Esquema de entrada

{'type': 'object', 'required': ['path'], 'properties': {'path': {'type': 'string', 'description': "The file's path inside the repository, e.g. 'src/app/main.ts'. Not a URL."}, 'repo': {'type': ['string', 'null'], 'default': None, 'description': "Which repository, as 'group/repo'. Omit when only one is open."}, 'reference': {'type': ['string', 'null'], 'default': None, 'description': 'Branch, tag or commit. Omit for the default branch.'}}}

remove_track

Undeclare a track. THE LABEL STAYS ON THE WORK: what goes is the declaration, so the issues keep their tag and declaring the track again brings exactly the same ones back. Nothing here can lose work — but the name, icon and place ARE lost, and the track's issues count as 'outside every track' afterwards. For a track that is merely finished, archive it instead: set_track with archived=true. Needs permission to write in the project.

Esquema de entrada

{'type': 'object', 'required': ['projectKey', 'tag'], 'properties': {'tag': {'type': 'string', 'description': "The track's tag, e.g. 'cherry-orchard'."}, 'projectKey': {'type': 'string', 'description': "Project key, e.g. 'TH'."}}}

reply_to_requester

Write to the person who opened a support request. The text becomes a comment the requester can read on their page and is emailed to them — unlike add_comment, which is always internal and never reaches the requester. Write it to the customer, in their language (get_support_request says which). Requires full write access to the support project. Answers with the comment id and whether the letter went ('emailed'; 'emailError' when it failed — the reply is kept either way).

Esquema de entrada

{'type': 'object', 'required': ['key', 'body'], 'properties': {'key': {'type': 'string', 'description': "Issue key of the request, e.g. 'SUPPORT-12'."}, 'body': {'type': 'string', 'description': 'What to tell the requester. Markdown is kept as written.'}}}

report_agent_usage

Record what one agent run cost an issue (local or mirrored/upstream): tokens by kind and machine time. Re-sending the same 'source' + 'externalId' updates that record instead of adding a second one, so a retry never doubles the spend. Omit a metric you did not measure — omitted is 'not reported', which is different from zero. Requires permission to edit the issue.

Esquema de entrada

{'type': 'object', 'required': ['key', 'source', 'externalId'], 'properties': {'key': {'type': 'string', 'description': "Issue key, e.g. 'UK-1'."}, 'host': {'type': ['string', 'null'], 'default': None, 'description': 'Which host it ran on.'}, 'note': {'type': ['string', 'null'], 'default': None, 'description': 'Short note, e.g. the outcome.'}, 'agent': {'type': ['string', 'null'], 'default': None, 'description': "Which agent did the work, e.g. 'claude-code'."}, 'model': {'type': ['string', 'null'], 'default': None, 'description': "Which model it ran on, e.g. 'claude-opus-5'."}, 'runId': {'type': ['string', 'null'], 'default': None, 'description': 'The run this record belongs to, when one run reports several records (different models or hosts).'}, 'source': {'type': 'string', 'description': "Who is reporting, e.g. 'bg-agent-api'. Idempotency is scoped to it."}, 'costUsd': {'type': ['number', 'null'], 'default': None, 'description': 'Cost in USD, if you know the rates that applied.'}, 'endedAt': {'type': ['string', 'null'], 'format': 'date-time', 'default': None, 'description': 'When the run ended (ISO 8601).'}, 'startedAt': {'type': ['string', 'null'], 'format': 'date-time', 'default': None, 'description': 'When the run started (ISO 8601).'}, 'externalId': {'type': 'string', 'description': 'Your own key for this record (usually the run id). Re-sending it updates the record.'}, 'inputTokens': {'type': ['integer', 'null'], 'default': None, 'description': 'Input (prompt) tokens.'}, 'agentSeconds': {'type': ['integer', 'null'], 'default': None, 'description': 'Wall-clock seconds the run took. Machine time, not a worklog.'}, 'outputTokens': {'type': ['integer', 'null'], 'default': None, 'description': 'Output (completion) tokens.'}, 'cacheReadTokens': {'type': ['integer', 'null'], 'default': None, 'description': 'Cache-read tokens.'}, 'cacheWriteTokens': {'type': ['integer', 'null'], 'default': None, 'description': 'Cache-write tokens.'}}}

reveal_credential

Read one credential's value, by the id from list_credentials. This is the same act as pressing reveal on the screen and carries the same cost: it is recorded against the token you are using, and the person who owns the secret can see that you read it. Call it when you are about to use the value, not to have it on hand. The answer is marked secret: do not copy it into a comment, a description, a merge request or a log.

Esquema de entrada

{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'integer', 'description': 'Credential id, from list_credentials.'}}}

search_code

Find where a string appears in the code of the repositories connected to a project, with the file, the line number and the lines around it. Only repositories whose owners opened them to agents are searched, and the answer says when what it searched was out of date.

Esquema de entrada

{'type': 'object', 'required': ['query'], 'properties': {'path': {'type': ['string', 'null'], 'default': None, 'description': "Narrow to files whose path contains this, such as 'src/' or '.ts'."}, 'repo': {'type': ['string', 'null'], 'default': None, 'description': "Which repository, as 'group/repo'. Omit to search every repository open here."}, 'query': {'type': 'string', 'description': 'What to look for, taken literally unless regexp is set. A space is a space, not two terms.'}, 'regexp': {'type': 'boolean', 'default': False, 'description': 'Read query as a regular expression. One with no literal in it may not finish in time.'}, 'caseSensitive': {'type': 'boolean', 'default': False, 'description': 'Match case. Off by default.'}}}

search_issues

Search the issues visible to this token, with a JQL query — the same JQL the Jira REST surface takes, read by the same parser. A query naming a field this tracker does not have is REFUSED and named, never run: it would match everything and read as an answer. Without `jql`, the shorthand arguments filter instead. Most recently created first unless the query says ORDER BY. Archived issues are left out unless the query names `archived`, and `archivedLeftOut` says how many matches that hid — an empty list with it is not "there are none".

Esquema de entrada

{'type': 'object', 'properties': {'jql': {'type': ['string', 'null'], 'default': None, 'description': 'A JQL query, e.g. `assignee = currentUser() AND statusCategory != Done ORDER BY updated DESC`. FIELDS: project, status, statuscategory, issuetype, type, priority, resolution, assignee, reporter, creator, key, issuekey, id, summary, description, sprint, parent, epic, labels, archived, agent, text, created, updated, duedate. OPERATORS: = != ~ !~ > >= < <=, IN (...), NOT IN (...), IS EMPTY, IS NOT EMPTY, combined with AND / OR, with parentheses around a sub-expression — `project = PM AND (status = Blocked OR priority = Highest)` — plus an optional trailing ORDER BY <field> [DESC]. `~` means contains (substring) and is the one to use for free text — `text` searches summary, description and comments. `>` `>=` `<` `<=` are for created/updated/duedate only, with absolute YYYY-MM-DD values: there are NO relative-date functions, so compute the date yourself. The only function is currentUser(), for assignee/reporter/creator. `archived` is this tracker\'s own field: archived issues are left out unless the query mentions it. `epic` is this tracker\'s own too, and it is the wide one: `epic = PM-12` matches that epic AND the work under it — its children and their sub-tasks — which is how one asks for an epic\'s whole board in a single clause. `parent` is the narrow one: direct children only, and never the epic itself. `agent` is this tracker\'s own as well: `agent = product` is an issue an agent of that role has right now — working on it or waiting on its question — and `agent IS NOT EMPTY` is any agent; the assignee of such an issue is still the person it works for. Quote values containing spaces. Seeded values — status: Backlog, "To Do", "In Progress", "In Review", Blocked, Done; statusCategory: "To Do", "In Progress", Done; priority: Highest, High, Medium, Low, Lowest; type: Epic, Story, Task, Bug, "Sub-task". A project\'s own columns (PM-170) can be searched too, by name — Segment = AI — or as customfield_20003 / cf[20003]; list_project_fields names them.'}, 'text': {'type': ['string', 'null'], 'default': None, 'description': 'Shorthand for `key ~ … OR summary ~ …`. Narrows the query further when `jql` is given too.'}, 'limit': {'type': 'integer', 'default': 25, 'description': 'Max issues to return (default 25, max 100).'}, 'status': {'type': ['string', 'null'], 'default': None, 'description': "Shorthand for `status = …` (e.g. 'In Progress', 'Done'). Narrows the query further when `jql` is given too."}, 'projectKey': {'type': ['string', 'null'], 'default': None, 'description': 'Shorthand for `project = …` (must be visible to the token). Narrows the query further when `jql` is given too.'}}}

search_wiki

Search wiki pages visible to this token by free text (matched in the title, the body, and the labels written on an attached SVG diagram). Optionally restrict to one space key. Most recently updated first.

Esquema de entrada

{'type': 'object', 'properties': {'text': {'type': ['string', 'null'], 'default': None, 'description': 'Free text to match in the page title, its body, or the text of an attached SVG diagram.'}, 'limit': {'type': 'integer', 'default': 25, 'description': 'Max pages to return (default 25, max 100).'}, 'spaceKey': {'type': ['string', 'null'], 'default': None, 'description': "Restrict to this space key (e.g. 'PM')."}}}

set_issue_fields

Fill in a project's own columns on one issue, by their NAMES: 'Segment=AI; Country=Poland; Started=2026-08-01', or a JSON object. A country column takes the country's name or its two-letter code. An empty value clears the field, which is not the same as an empty one. A value that does not fit the field's kind — an option nobody offered, a date that is not one, a country that is neither — refuses the WHOLE call rather than writing part of it.

Esquema de entrada

{'type': 'object', 'required': ['key', 'values'], 'properties': {'key': {'type': 'string', 'description': "Issue key, e.g. 'CRM-1'."}, 'values': {'type': 'string', 'description': "Field names to values, as 'Segment=AI; Country=Poland' or a JSON object. List values are given by option name, people by username, dates as 2026-08-21."}}}

set_project_field

Add a column to a project, or edit the one that already has this name. Keyed by name rather than by id: 'make sure there is a Segment field with these options' is the request, and a name is what you just read. A field's KIND cannot be changed once it exists. Project lead or admin only.

Esquema de entrada

{'type': 'object', 'required': ['projectKey', 'name'], 'properties': {'icon': {'type': ['string', 'null'], 'default': None, 'description': 'The glyph that mark wears, from the palette list_project_fields returns. Not for a country field: that one marks a card with the flag of the country the issue holds, so passing an icon is refused rather than ignored.'}, 'kind': {'type': ['string', 'null'], 'default': None, 'description': "What it holds: 'text', 'number', 'date' (a day), 'datetime' (a day and a time, written like 2026-10-01T19:30+03:00), 'user', 'select' (a list) or 'country' (a country, written as its name or its two-letter code and shown with a flag). Required when creating; ignored when the field already exists, since a kind cannot change."}, 'name': {'type': 'string', 'description': "Field name, e.g. 'Segment'. An existing field with this name is edited rather than duplicated."}, 'newName': {'type': ['string', 'null'], 'default': None, 'description': 'Rename the field to this. Leave out to keep the name.'}, 'options': {'type': ['string', 'null'], 'default': None, 'description': "For a list: its options, as 'AI:green, Skins:orange, GameCards' or a JSON array of {name, color}. A colour is optional and must be one of: orange, amber, red, pink, purple, blue, teal, green. Options left out are REMOVED — send the whole set."}, 'showIcon': {'type': ['boolean', 'null'], 'default': None, 'description': 'Mark a board card when this field has a value: true to switch the mark on, false off. Leave out to keep it as it is.'}, 'issueType': {'type': ['string', 'null'], 'default': None, 'description': "Keep the field for issues of one type only, by name — e.g. 'Показ' — or '' for every type. Leave out to keep it as it is."}, 'projectKey': {'type': 'string', 'description': "Project key, e.g. 'CRM'."}}}

set_project_issue_type

Add an issue type of this project's own — e.g. 'Показ' — or rename one it already has. Keyed by name. The shared types (Epic, Story, Task, Bug, Sub-task, Client) are every project's and cannot be renamed here. Another project never sees this type. Project lead or admin only.

Esquema de entrada

{'type': 'object', 'required': ['projectKey', 'name'], 'properties': {'name': {'type': 'string', 'description': "The type's name. An own type of this project with this name is renamed (with newName) rather than duplicated."}, 'newName': {'type': ['string', 'null'], 'default': None, 'description': 'Rename the type to this. Leave out to add or keep it.'}, 'subtask': {'type': ['boolean', 'null'], 'default': None, 'description': 'When adding: true for a sub-task type, whose issues hang off a parent. Cannot be changed afterwards.'}, 'projectKey': {'type': 'string', 'description': "Project key, e.g. 'TH'."}}}

set_project_parent

Make an existing project a subproject of another, or take it back out with an empty parentKey. This is about ACCESS, not about names or issues: everyone who may reach the parent may reach the subproject too, in the role they hold there. Nothing is renamed, no issue moves, and the keys stay ordinary keys. Attaching needs an admin or somebody who leads BOTH projects, since neither can be volunteered by whoever leads the other; detaching needs a lead of either, since it only takes access away. One level: a subproject cannot have subprojects.

Esquema de entrada

{'type': 'object', 'required': ['projectKey'], 'properties': {'parentKey': {'type': ['string', 'null'], 'default': None, 'description': "Key of the project it becomes a subproject of, e.g. 'KYC'. Leave it out (or empty) to detach it and leave it a project of its own."}, 'projectKey': {'type': 'string', 'description': "Key of the project to move, e.g. 'KYCB2B'."}}}

set_track

Declare a track on a project, or edit the one that already has this tag. The tag is the LABEL issues carry to join it ('cherry-orchard'), so it cannot contain a space — labels are stored space-separated. The name is what a reader sees ('The Cherry Orchard'); leave it out and the tag speaks for itself. Declaring a track writes nothing to any issue: the ones already carrying the label are in it at once. Needs permission to write in the project.

Esquema de entrada

{'type': 'object', 'required': ['projectKey', 'tag'], 'properties': {'tag': {'type': 'string', 'description': "The label that puts an issue in this track, e.g. 'cherry-orchard'. No spaces. An existing track with this tag is edited rather than duplicated; matched exactly, so 'Hamlet' and 'hamlet' are two tags, as they are two labels."}, 'icon': {'type': ['string', 'null'], 'default': None, 'description': 'One or two emoji shown BESIDE the name, never instead of it. Leave it out to keep what is there; send an empty string to take it off. Anything that is not an emoji is refused rather than ignored.'}, 'name': {'type': ['string', 'null'], 'default': None, 'description': "What a reader sees, e.g. 'The Cherry Orchard'. Leave it out to keep what is there; send an empty string to drop it and let the tag speak."}, 'newTag': {'type': ['string', 'null'], 'default': None, 'description': 'Rename the tag to this. The label on existing issues is NOT rewritten, so work in the old tag leaves the track — rename only when the issues are being relabelled too.'}, 'archived': {'type': ['boolean', 'null'], 'default': None, 'description': "true takes the track off the row above the board WITHOUT undeclaring it — a play that has been staged: its name, icon, place and tag are kept, its issues stay in it (they do not become 'outside every track'), and links to it keep working. false puts it back in the row. Leave it out to keep what is there. Prefer this to remove_track for a track that is finished."}, 'position': {'type': ['integer', 'null'], 'default': None, 'description': 'Where it sits in the row above the board, counting from 1. Leave it out and a new track goes last, an existing one stays where it is.'}, 'projectKey': {'type': 'string', 'description': "Project key, e.g. 'TH'."}}}

unlink_issues

Remove a link between two issues: name both ends (and, when more than one link joins them, the phrase — 'blocks', 'relates to'), or give the 'linkId' get_issue returned. Ambiguity is refused rather than guessed: two issues joined twice and no phrase given comes back with the links listed. Requires permission to edit BOTH issues. The issues themselves are untouched.

Esquema de entrada

{'type': 'object', 'properties': {'to': {'type': ['string', 'null'], 'default': None, 'description': "The other end, e.g. 'PM-417'. Not needed when 'linkId' is given."}, 'from': {'type': ['string', 'null'], 'default': None, 'description': "One end, e.g. 'PM-419'. Not needed when 'linkId' is given."}, 'type': {'type': ['string', 'null'], 'default': None, 'description': "Which link, when the two issues are joined by more than one: the phrase as get_issue says it ('blocks', 'is blocked by', 'relates to')."}, 'linkId': {'type': ['integer', 'null'], 'default': None, 'description': "The link's id, as get_issue returns it in 'links'."}}}

unlink_wiki_page

Remove the link between an issue and a wiki page. Identify the page by 'pageId', or by 'spaceKey' + 'title'. Requires permission to edit the issue. The page itself is not touched.

Esquema de entrada

{'type': 'object', 'required': ['issueKey'], 'properties': {'title': {'type': ['string', 'null'], 'default': None, 'description': 'Exact page title, when identifying the page by title.'}, 'pageId': {'type': ['integer', 'null'], 'default': None, 'description': 'Page id (as returned by search_wiki).'}, 'issueKey': {'type': 'string', 'description': "Issue key, e.g. 'UK-1'."}, 'spaceKey': {'type': ['string', 'null'], 'default': None, 'description': 'Space key, when identifying the page by title.'}}}

update_comment

Edit a comment on an issue: pass 'body' to replace the whole of it, or 'edits' to change part of it — exact find-and-replace against the comment as get_comments hands it back, each 'oldText' occurring exactly once. One body axis per call. With 'edits' the answer says where each one landed rather than giving the comment back, so correcting one number in a long comment costs neither a resend nor a re-read. Nothing here takes a version and none is needed: an 'oldText' is matched against the comment as it stands now, so an edit whose text somebody has since rewritten is refused rather than applied over their words. The author may edit their own comment; anyone with full write access in the project may edit any. Answers with 'notified' — and note that this is only the people the *edit* newly reaches: names already present in the old text are not notified again, and the comment is not re-announced to watchers.

Esquema de entrada

{'type': 'object', 'required': ['key', 'commentId'], 'properties': {'key': {'type': 'string', 'description': "Issue key the comment is on, e.g. 'UK-1'."}, 'body': {'type': ['string', 'null'], 'default': None, 'description': 'The new body, replacing the old one entirely. Markdown is kept as written, and carries $…$ / $$…$$ LaTeX formulas and [~username] mentions.'}, 'edits': {'type': ['array', 'null'], 'items': {'type': ['object', 'null'], 'properties': {'newText': {'type': ['string', 'null'], 'description': "What to put in its place. An empty string deletes. To insert, put an anchor in 'oldText' and the same anchor plus the addition here."}, 'oldText': {'type': ['string', 'null'], 'description': "The text to replace, exactly as it stands in the Markdown source — whitespace and line breaks included. Must occur exactly once unless 'replaceAll' is set; include a few surrounding words to make it unique."}, 'replaceAll': {'type': 'boolean', 'description': 'Replace every occurrence rather than requiring exactly one.'}}}, 'default': None, 'description': "Exact replacements in the comment, changing part of it in place. Matched against the body as get_comments returns it — stored as written, so what you read is what an 'oldText' has to equal, whitespace and line breaks included. Every edit is looked for in that text, not in what the edits before it produced; if any one does not fit, none is applied."}, 'commentId': {'type': 'integer', 'description': "The comment's id, as returned by get_comments or add_comment."}}}

update_issue

Update an issue: any of summary, description, type, assignee, priority, labels, dueDate, parentKey, or status (which performs the transition, and fires the project's rules — a rule may append a checklist to the description, in which case 'description' is listed in 'changed'). Only the fields you pass are changed. A project's workflow may put conditions on a move — that only certain people may make it, or that it must set certain fields — and a refusal names the condition and, where it is about who you are, lists the states you CAN reach. Fields a move requires must be sent in this same call, with 'resolution' and 'fields': a value set by an earlier call does not satisfy the condition. Answers with 'notified' (who this actually reaches) and 'unresolvedMentions' (what looked like a mention and reached nobody, each with a reason) — a wrong handle is stored as written and never refused, so that list is the only sign it did not land.

Esquema de entrada

{'type': 'object', 'required': ['key'], 'properties': {'key': {'type': 'string', 'description': "Issue key, e.g. 'UK-1'."}, 'type': {'type': ['string', 'null'], 'default': None, 'description': "New issue type name, e.g. 'Task', 'Bug', 'Story', 'Epic'."}, 'fields': {'type': ['string', 'null'], 'default': None, 'description': "The project's own columns to fill in with this update, by their NAMES: 'Segment=AI; Country=Poland', or a JSON object. Same shape as set_issue_fields — this exists here because a move a workflow conditions on a column has to set it in the same call."}, 'labels': {'type': ['string', 'null'], 'default': None, 'description': 'Labels to set, space or comma separated. Replaces the existing set.'}, 'status': {'type': ['string', 'null'], 'default': None, 'description': "Status name to move the issue to, e.g. 'In Progress', 'Done'."}, 'dueDate': {'type': ['string', 'null'], 'default': None, 'description': 'The day this is due, as YYYY-MM-DD. A calendar day, not a timestamp. Pass an empty string to clear it.'}, 'summary': {'type': ['string', 'null'], 'default': None, 'description': 'New summary (title).'}, 'assignee': {'type': ['string', 'null'], 'default': None, 'description': "Assignee username or email. Pass an empty string to unassign. 'agent:<role>' (e.g. 'agent:product') hands the issue to that agent instead: you become the assignee and the agent works on your behalf — allowed only where a switched-on duty of that role in this project takes issues like this one (list_project_rules shows the duties)."}, 'priority': {'type': ['string', 'null'], 'default': None, 'description': "Priority name, e.g. 'High'."}, 'parentKey': {'type': ['string', 'null'], 'default': None, 'description': "Key of the issue this one hangs off, e.g. 'PM-276' — moves it under that story or epic. To DETACH it instead, send detachParent: true; an empty string still works but is easy to lose on the way. Nothing is renamed and the key never changes: an issue keeps the key of the project it lives in. A sub-task must stay in its parent's project; anything else may cross projects."}, 'resolution': {'type': ['string', 'null'], 'default': None, 'description': "Resolution name to set, e.g. 'Fixed', 'Won't Do'. Some workflows require one on the move into a finished state; sending it here is how that condition is met."}, 'description': {'type': ['string', 'null'], 'default': None, 'description': 'New description. Markdown, with $…$ / $$…$$ LaTeX formulas and [~username] mentions.'}, 'detachParent': {'type': 'boolean', 'default': False, 'description': 'Take this issue out from under its parent and leave it top-level. The reliable way to detach: unlike an empty parentKey it cannot arrive as the two characters "" or be dropped as «nothing was sent». Refused together with a parentKey, since the two would be asking for opposite things.'}}}

update_project_rule

Change a project rule, by its id from list_project_rules. Only what you pass changes: pass just 'enabled' to switch a rule on or off, or any of the others to edit it. An empty string for 'type' or 'label' removes that condition; for a duty, an empty 'status', 'agentActions', 'agentFields' or 'doneStatus' clears that one. A rule's action cannot change. A rule appends its checklist to an issue's description when the issue ENTERS the rule's state — from the board, the Jira API or update_issue alike. The block starts with a hidden marker line '[//]: # (pm-rule:<id>)'; while that line is in the description, entering the state again adds nothing (the journal says 'alreadyThere'). A [~username] in the template is a mention: that person is notified when the checklist lands. A checklist that would make the description too long is not added and the journal says 'tooLong'; the move itself still happens. A rule with action 'agent' is a DUTY instead: it says which issues may be handed to an agent role (agentRole, e.g. 'product') and what the agent may do with them. Its 'template' is then the INSTRUCTION — what doing such an issue means in this project — and nothing is appended anywhere. A duty may have no state (pass an empty 'status'): then an issue is handed only by a person. agentActions is a list from: describe, subtasks, ask, wiki, report, support. agentFields names the fields it may set: priority, labels, duedate, or the project's own fields by name. doneStatus is the state it moves the issue to when done — never a finished one. capUsd raises what one task may cost, up to 5 dollars. Commenting is always allowed; finishing, deleting, reassigning and anything outside the issue never are. Saving or switching on a duty makes it yours: it runs on your behalf and access, and is switched off if you lose the project. Project lead or admin only.

Esquema de entrada

{'type': 'object', 'required': ['projectKey', 'id'], 'properties': {'id': {'type': 'integer', 'description': "The rule's id, from list_project_rules."}, 'name': {'type': ['string', 'null'], 'default': None, 'description': 'A new name.'}, 'type': {'type': ['string', 'null'], 'default': None, 'description': 'Only issues of this type, by name. An empty string means any type.'}, 'label': {'type': ['string', 'null'], 'default': None, 'description': 'Only issues with this label. An empty string means any label.'}, 'capUsd': {'type': ['number', 'null'], 'default': None, 'description': 'For a duty: what one task may cost, in dollars, at most 5; 0 goes back to the ordinary ceiling.'}, 'status': {'type': ['string', 'null'], 'default': None, 'description': 'A new state to fire on, by name.'}, 'enabled': {'type': ['boolean', 'null'], 'default': None, 'description': 'true to switch the rule on, false to switch it off.'}, 'template': {'type': ['string', 'null'], 'default': None, 'description': 'A new checklist template (Markdown). Replaces the old one for issues that enter the state from now on; checklists already added stay as they are.'}, 'agentRole': {'type': ['string', 'null'], 'default': None, 'description': 'For a duty: a new agent role key.'}, 'doneStatus': {'type': ['string', 'null'], 'default': None, 'description': 'For a duty: a new review state; an empty string and it no longer moves the issue.'}, 'projectKey': {'type': 'string', 'description': "Project key, e.g. 'ONB'."}, 'agentFields': {'type': ['string', 'null'], 'default': None, 'description': 'For a duty: the whole new list of fields, comma-separated.'}, 'agentActions': {'type': ['string', 'null'], 'default': None, 'description': 'For a duty: the whole new list of actions, comma-separated.'}}}

update_wiki_comment

Edit a comment on a wiki page — your own, or anyone's with full write access in that project. Read it first with get_wiki_page(withMarkdown: true), which gives each comment its 'markdown' and 'version'. Pass 'markdown' to replace the whole comment, or 'edits' to change part of it (exact find-and-replace on that Markdown, each 'oldText' occurring exactly once) — the answer then says where each landed, not the comment. An inline comment's anchor moves with 'inlineSelection': the page text it should point at, copied exactly; an empty string turns it into an ordinary footer comment, which is the only way it ever stops being anchored. Mention someone as [@Their Name](user:username), the wiki's own form. Answers with 'notified' — only the people the *edit* newly reaches, since names already in the old text are not notified again and the page is not re-announced to its watchers.

Esquema de entrada

{'type': 'object', 'required': ['commentId'], 'properties': {'edits': {'type': ['array', 'null'], 'items': {'type': ['object', 'null'], 'properties': {'newText': {'type': ['string', 'null'], 'description': "What to put in its place. An empty string deletes. To insert, put an anchor in 'oldText' and the same anchor plus the addition here."}, 'oldText': {'type': ['string', 'null'], 'description': "The text to replace, exactly as it stands in the Markdown source — whitespace and line breaks included. Must occur exactly once unless 'replaceAll' is set; include a few surrounding words to make it unique."}, 'replaceAll': {'type': 'boolean', 'description': 'Replace every occurrence rather than requiring exactly one.'}}}, 'default': None, 'description': "Exact replacements in the comment's Markdown — the text get_wiki_page returns as a comment's 'markdown'. Every 'oldText' is matched against it as you read it (not against the result of the other edits) and must occur exactly once unless 'replaceAll' is set; if any edit does not fit, none is applied."}, 'markdown': {'type': ['string', 'null'], 'default': None, 'description': 'The whole comment, replacing what is there. Markdown, which also carries $…$ / $$…$$ LaTeX formulas.'}, 'commentId': {'type': 'integer', 'description': "The comment's id, as get_wiki_page lists it or add_wiki_comment returned."}, 'inlineMatch': {'type': ['integer', 'null'], 'default': None, 'description': "Which occurrence of 'inlineSelection' on the page to anchor to, counted from 1. Only needed when the text occurs more than once."}, 'expectedVersion': {'type': ['integer', 'null'], 'default': None, 'description': "The version you read (from get_wiki_page). If the comment has moved on since, the edit is refused instead of overwriting somebody else's."}, 'inlineSelection': {'type': ['string', 'null'], 'default': None, 'description': "Move the inline anchor: the page text this comment should point at, copied exactly from the page. An empty string detaches it, making it a footer comment. Refused when the page does not carry that text, or carries it more than once and 'inlineMatch' does not say which — never resolved by guessing."}}}

update_wiki_page

Edit a wiki page: retitle it, change its body, move it under another parent (or to the top of its space), or set its labels. Identify it by 'id', or by 'spaceKey' + 'title'. To change part of the body, pass 'edits' (exact find-and-replace on the Markdown source, each 'oldText' occurring exactly once) or 'replaceSection' — the answer says where each landed, not the page, so a one-line fix to a long page costs one line. 'markdown' replaces the whole body — read it first with get_wiki_page(withMarkdown: true) and edit that, or the page's links, images and macros are dropped; 'appendMarkdown' adds to the end and leaves what is there untouched. Mention someone as [@Their Name](user:username), the wiki's own form. Requires permission to edit the page. Answers with 'notified' (who this actually reaches) and 'unresolvedMentions' (what looked like a mention and reached nobody, each with a reason) — a wrong handle is stored as written and never refused, so that list is the only sign it did not land.

Esquema de entrada

{'type': 'object', 'properties': {'id': {'type': ['integer', 'null'], 'default': None, 'description': 'Page id (as returned by search_wiki).'}, 'edits': {'type': ['array', 'null'], 'items': {'type': ['object', 'null'], 'properties': {'newText': {'type': ['string', 'null'], 'description': "What to put in its place. An empty string deletes. To insert, put an anchor in 'oldText' and the same anchor plus the addition here."}, 'oldText': {'type': ['string', 'null'], 'description': "The text to replace, exactly as it stands in the Markdown source — whitespace and line breaks included. Must occur exactly once unless 'replaceAll' is set; include a few surrounding words to make it unique."}, 'replaceAll': {'type': 'boolean', 'description': 'Replace every occurrence rather than requiring exactly one.'}}}, 'default': None, 'description': "Exact replacements in the page's Markdown source — the text get_wiki_page returns with 'section', 'offset' or withMarkdown: true. Every 'oldText' is matched against the page as you read it (not against the result of the other edits) and must occur exactly once unless 'replaceAll' is set; if any edit does not fit, none is applied. Pair with 'expectedVersion'."}, 'title': {'type': ['string', 'null'], 'default': None, 'description': 'Current page title, when identifying the page by title.'}, 'labels': {'type': ['string', 'null'], 'default': None, 'description': 'Labels to set, space or comma separated. Replaces the existing set.'}, 'message': {'type': ['string', 'null'], 'default': None, 'description': 'Short note for the page history, e.g. why you changed it.'}, 'markdown': {'type': ['string', 'null'], 'default': None, 'description': "The complete new body as Markdown — replaces what is there. Carries $…$ / $$…$$ LaTeX formulas and the wiki's macros on a line of their own ({toc}, {children}, {info} … {info}, {expand:title=…} … {expand})."}, 'newTitle': {'type': ['string', 'null'], 'default': None, 'description': "New title. The page's existing links follow the rename."}, 'parentId': {'type': ['integer', 'null'], 'default': None, 'description': 'Move the page under this parent page id.'}, 'spaceKey': {'type': ['string', 'null'], 'default': None, 'description': 'Space key, when identifying the page by title.'}, 'minorEdit': {'type': 'boolean', 'default': False, 'description': 'Mark this as a minor edit in the history.'}, 'toTopLevel': {'type': 'boolean', 'default': False, 'description': "Move the page to the top of its space, out from under any parent, so it sits beside the space's other root pages. Use this instead of parentId/parentTitle — a tool argument has no way to say 'no parent' by leaving one out."}, 'parentTitle': {'type': ['string', 'null'], 'default': None, 'description': 'Move the page under the page with this title, in the same space.'}, 'appendMarkdown': {'type': ['string', 'null'], 'default': None, 'description': "Markdown to add to the end of the page, leaving the rest as it is. Same syntax as 'markdown'."}, 'replaceSection': {'type': ['object', 'null'], 'default': None, 'properties': {'section': {'type': ['string', 'null'], 'description': 'The section to replace: its anchor as get_wiki_page(outline: true) gives it, or its heading text.'}, 'markdown': {'type': ['string', 'null'], 'description': 'The Markdown that replaces it, heading line included — the section as get_wiki_page(section: …) returned it, changed. An empty string removes the section.'}}, 'description': "Replace one whole section: 'section' names it as get_wiki_page's 'section' does (anchor or heading text), 'markdown' is what replaces it — heading line included, as reading the section returned it. Can be combined with 'edits' elsewhere on the page."}, 'expectedVersion': {'type': ['integer', 'null'], 'default': None, 'description': "The version you read (from get_wiki_page). If the page has moved on since, the edit is refused instead of overwriting someone else's."}}}

upsert_mcp_connection

Admin only: create or update a project's external MCP connection. Pass 'id' to update an existing one (omit to create). 'token' is stored server-side and never returned; omit it to keep the current token when updating.

Esquema de entrada

{'type': 'object', 'required': ['projectKey'], 'properties': {'id': {'type': ['integer', 'null'], 'default': None, 'description': 'Existing connection id to update; omit to create a new one.'}, 'url': {'type': ['string', 'null'], 'default': None, 'description': 'MCP server URL — use https (required when creating).'}, 'name': {'type': ['string', 'null'], 'default': None, 'description': 'Connection display name (required when creating).'}, 'token': {'type': ['string', 'null'], 'default': None, 'description': 'Bearer auth token. Omit to keep the current token when updating.'}, 'enabled': {'type': ['boolean', 'null'], 'default': None, 'description': 'Whether the connection is enabled.'}, 'projectKey': {'type': 'string', 'description': "Project key, e.g. 'UK'."}}}

withdraw_issue_question

Take back a question you asked, when it no longer needs answering — you worked it out, or the task moved on. The comment stays in the thread (the conversation happened) and the question stops counting on the other person's list. The person who asked, or anybody with full write access in the project.

Esquema de entrada

{'type': 'object', 'required': ['questionId'], 'properties': {'questionId': {'type': 'integer', 'description': "The question's id, as returned by list_issue_questions or ask_issue_question."}}}

Añadido

                            set_project_issue_type
                        

25 de September de 2026 a las 02:49

Modificado

                            set_project_field
                        

25 de September de 2026 a las 02:49

Añadido

                            local_files_setup
                        

25 de September de 2026 a las 02:49

Modificado

                            get_wiki_attachment
                        

25 de September de 2026 a las 02:49

Modificado

                            get_attachment
                        

25 de September de 2026 a las 02:49

Añadido

                            delete_project_issue_type
                        

25 de September de 2026 a las 02:49

Modificado

                            add_wiki_attachment
                        

25 de September de 2026 a las 02:49

Modificado

                            add_attachment
                        

25 de September de 2026 a las 02:49

Añadido

                            withdraw_issue_question
                        

23 de September de 2026 a las 02:40

Añadido

                            upsert_mcp_connection
                        

23 de September de 2026 a las 02:40

Añadido

                            update_wiki_page
                        

23 de September de 2026 a las 02:40

Añadido

                            update_wiki_comment
                        

23 de September de 2026 a las 02:40

Añadido

                            update_project_rule
                        

23 de September de 2026 a las 02:40

Añadido

                            update_issue
                        

23 de September de 2026 a las 02:40

Añadido

                            update_comment
                        

23 de September de 2026 a las 02:40

Añadido

                            unlink_wiki_page
                        

23 de September de 2026 a las 02:40

Añadido

                            unlink_issues
                        

23 de September de 2026 a las 02:40

Añadido

                            set_track
                        

23 de September de 2026 a las 02:40

Añadido

                            set_project_parent
                        

23 de September de 2026 a las 02:40

Añadido

                            set_project_field
                        

23 de September de 2026 a las 02:40

Añadido

                            set_issue_fields
                        

23 de September de 2026 a las 02:40

Añadido

                            search_wiki
                        

23 de September de 2026 a las 02:40

Añadido

                            search_issues
                        

23 de September de 2026 a las 02:40

Añadido

                            search_code
                        

23 de September de 2026 a las 02:40

Añadido

                            reveal_credential
                        

23 de September de 2026 a las 02:40

Añadido

                            report_agent_usage
                        

23 de September de 2026 a las 02:40

Añadido

                            reply_to_requester
                        

23 de September de 2026 a las 02:40

Añadido

                            remove_track
                        

23 de September de 2026 a las 02:40

Añadido

                            read_code
                        

23 de September de 2026 a las 02:40

Añadido

                            move_issue
                        

23 de September de 2026 a las 02:40

Detalles del servidor

Versión

1.3.0

Transporte

Streamable HTTP

Herramientas

Latencia

1747 ms

Último escaneo

1 de October de 2026 a las 02:40

Detectado por primera vez

23 de September de 2026 a las 02:17

Endpoint

https://app.kaiku.tech/mcp

Escaneos recientes

Parcial

1 de October de 2026 a las 02:40

Parcial

27 de September de 2026 a las 02:42

Correcto

25 de September de 2026 a las 02:49

Correcto

23 de September de 2026 a las 02:40

Kaiku

Qué hace este MCP

Herramientas

Cambios recientes en herramientas

Servidores MCP similares

ainote

WhiteMagic — governed local memory for agent continuity

Atlassian Rovo MCP Server

ctlsurf

Stable Baseline

Dayze — Life Context

YouSpot

cypher-mcp