> ## Documentation Index
> Fetch the complete documentation index at: https://docs.makershq.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP tool reference

> See what each Maker’s HQ MCP tool reads or changes and which project permission it needs.

[Connect an AI tool](https://docs.makershq.dev/integrations/ai-agents.md) first. Each tool checks the permissions you approved for the project it uses. Read and Write are separate. Some Write tools need an ID or current version from a Read tool.

## Find an approved project

| Tool | What it does |
| - | - |
| `list_projects` | List approved projects and the connection’s effective permissions for each. |
| `get_project` | Read one approved project’s name, website, and effective permissions. |

Follow `nextCursor` until it is null when a tool returns a page.

## Feature requests

| Tool | Permission | What it does |
| - | - | - |
| `list_feedback` | Read | List public requests with title search and status filters. |
| `get_feedback` | Read | Read one public request. |
| `list_comments` | Read | List public root comments or direct replies. |
| `set_feedback_status` | Write | Change a public request’s status using its last observed status. |
| `create_comment` | Write | Post a public comment or reply. |
| `create_public_request` | Write | Post a new request to the public board. |

## Release notes

| Tool | Permission | What it does |
| - | - | - |
| `list_releases` | Read | List drafts and published releases. |
| `get_release` | Read | Read a release and its current `updatedAt`. |
| `create_release_draft` | Write | Save a new unpublished draft. |
| `update_release_draft` | Write | Edit a draft’s title, Markdown, release date, or version. Pass the observed `expectedUpdatedAt`. Use null to clear the date or version. |
| `publish_release` | Write | Make the observed draft public. |

## Feature planning

| Tool | Permission | What it does |
| - | - | - |
| `list_board_column` | Read | Read public and private cards in one Build Board column. |
| `list_private_requests` | Read | Search or list private requests. |
| `get_private_request` | Read | Read a private request and its current `updatedAt`. |
| `list_private_comments` | Read | List root comments or direct replies on a private request. |
| `move_board_task` | Write | Reorder a card or move it to another status. A public card’s status also changes on the public board. |
| `create_private_request` | Write | Create a private Board task. |
| `update_private_request` | Write | Edit a private request’s title, description, or status using the observed `expectedUpdatedAt`. |
| `create_private_comment` | Write | Add a comment or reply to a currently private request. |

Change request visibility from the workspace. Making a private request public also shares its discussion.

## Check a change before repeating it

If a create or reply times out, look for the result on the project before trying again. If an edit reports a stale version or status, check the target in Maker’s HQ or with a Read tool before trying again.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.