> For the complete documentation index, see [llms.txt](https://docs.cogram.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cogram.com/integrations/mcp-tools.md).

# MCP tools and operations

Reference list of every tool and operation of the Cogram MCP server, with what each one changes and what it needs.

This page lists everything a connected AI application can do through Cogram's MCP server. Use it to decide which Tool access settings and licenses your organization needs before you turn MCP access on. For setup, see [MCP Server](https://docs.cogram.com/integrations/mcp-server.md).

This page is generated from the server's catalog. Do not edit it by hand.

## How to read the tables

* **Kind.** A **tool** is listed by the AI application under its own name. An **operation** is run through `run_read`, `run_write`, or `run_high_impact`.
* **Tier.** **Read** returns data and changes nothing. **Write** creates or changes records. **High impact** deletes records, removes or changes access, or sends something that cannot be recalled.
* **Effect.** **Immediate** changes are made at once. A **proposal** changes nothing until the user approves it from the notification bell in Cogram.
* **Module.** The licensed module the row needs. A write also needs the user's own seat for that module.
* **Required permission.** An organization permission the user needs. A user without it is not offered the row. Every row also checks the user's access to the records it names.
* **Notes.** A deprecated tool is an older tool name for the same read. It still works for now and will be hidden and then removed. A row marked limited release is not available to every organization yet.

A user is offered a row only when your [Tool access settings](https://docs.cogram.com/integrations/mcp-server.md#limit-what-connected-agents-can-do) and [licensing](https://docs.cogram.com/organization-administration/licensing.md) allow it.

## Projects

| Name                      | What it does                                                                     | Kind      | Tier        | Effect    | Module | Required permission | Notes                                             |
| ------------------------- | -------------------------------------------------------------------------------- | --------- | ----------- | --------- | ------ | ------------------- | ------------------------------------------------- |
| `search_projects`         | Search projects in Cogram by name, description, client, or address.              | Tool      | Read        | Immediate |        |                     |                                                   |
| `get_projects_by_id`      | Retrieve full details for specific projects, including meeting and email counts. | Operation | Read        | Immediate |        |                     | Deprecated tool `get_projects_by_id` still listed |
| `create_project`          | Create a project in Cogram. The connected user becomes its owner.                | Tool      | Write       | Immediate |        | Create project      |                                                   |
| `update_project`          | Change a project's details. Only the fields passed change.                       | Operation | Write       | Immediate |        |                     |                                                   |
| `archive_project`         | Archive a project and turn its email filing off.                                 | Operation | High impact | Immediate |        |                     |                                                   |
| `delete_project`          | Delete a project for good. This cannot be undone.                                | Operation | High impact | Immediate |        |                     |                                                   |
| `add_project_member`      | Add a person from the organization to a project.                                 | Operation | Write       | Immediate |        |                     |                                                   |
| `set_project_member_role` | Change the role of a direct member of a project.                                 | Operation | High impact | Immediate |        |                     |                                                   |
| `remove_project_member`   | Remove a direct member from a project.                                           | Operation | High impact | Immediate |        |                     |                                                   |
| `bind_project_group`      | Give a group of the organization a role on a project, or change the role it has. | Operation | High impact | Immediate |        |                     |                                                   |

## Project setup

| Name                            | What it does                                                                                                      | Kind      | Tier        | Effect    | Module | Required permission      | Notes                                                 |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------- | --------- | ----------- | --------- | ------ | ------------------------ | ----------------------------------------------------- |
| `list_project_templates`        | List the organization's project templates, ordered by name.                                                       | Operation | Read        | Immediate |        | Read project templates   | Deprecated tool `list_project_templates` still listed |
| `get_project_template`          | Get one project template with its full setup.                                                                     | Operation | Read        | Immediate |        | Read project templates   | Deprecated tool `get_project_template` still listed   |
| `list_project_template_options` | List the groups and the active project types a project template can use.                                          | Operation | Read        | Immediate |        | Read project templates   |                                                       |
| `create_project_template`       | Propose a new project template. Nothing is created until the connected user approves the proposal in Cogram.      | Operation | Write       | Proposal  |        | Manage project templates |                                                       |
| `update_project_template`       | Propose a change to a project template. Nothing changes until the connected user approves the proposal in Cogram. | Operation | Write       | Proposal  |        | Manage project templates |                                                       |
| `list_project_types`            | List the organization's project types, in display order.                                                          | Operation | Read        | Immediate |        |                          |                                                       |
| `create_project_type`           | Create a project type for the organization. Only an organization admin or owner can.                              | Operation | Write       | Immediate |        | Create project type      |                                                       |
| `update_project_type`           | Rename a project type or change its color. Only an organization admin or owner can.                               | Operation | Write       | Immediate |        |                          |                                                       |
| `delete_project_type`           | Delete a project type. This cannot be undone.                                                                     | Operation | High impact | Immediate |        |                          |                                                       |
| `list_project_stages`           | List the organization's project stages, in display order.                                                         | Operation | Read        | Immediate |        |                          |                                                       |
| `create_project_stage`          | Create a project stage for the organization. Only an organization admin or owner can.                             | Operation | Write       | Immediate |        | Create project stage     |                                                       |

## People

| Name                    | What it does                                                                                           | Kind      | Tier        | Effect    | Module | Required permission       | Notes                                             |
| ----------------------- | ------------------------------------------------------------------------------------------------------ | --------- | ----------- | --------- | ------ | ------------------------- | ------------------------------------------------- |
| `search_org_members`    | Search the people inside the connected user's own organization, by name or email, or list all of them. | Operation | Read        | Immediate |        |                           | Deprecated tool `search_org_members` still listed |
| `invite_user`           | Invite a person to the connected user's organization in Cogram.                                        | Tool      | Write       | Immediate |        | Manage organization users |                                                   |
| `set_org_role`          | Set a member's organization role: OWNER, ADMIN or MEMBER.                                              | Operation | High impact | Immediate |        | Manage organization users |                                                   |
| `create_group`          | Create a group of organization members.                                                                | Operation | Write       | Immediate |        | Create group for org      |                                                   |
| `add_group_member`      | Add organization members to a group.                                                                   | Operation | Write       | Immediate |        |                           |                                                   |
| `remove_group_member`   | Remove members from a group.                                                                           | Operation | High impact | Immediate |        |                           |                                                   |
| `assign_seat`           | Give a member a seat for one Cogram module.                                                            | Operation | Write       | Immediate |        | Manage licenses           |                                                   |
| `revoke_seat`           | Take a member's seat for one Cogram module away.                                                       | Operation | High impact | Immediate |        | Manage licenses           |                                                   |
| `add_users_to_projects` | Give existing organization members a role on one or more projects.                                     | Operation | Write       | Immediate |        | Read admin dashboard      |                                                   |

## Meetings

| Name                             | What it does                                                                      | Kind      | Tier        | Effect    | Module   | Required permission | Notes                                                         |
| -------------------------------- | --------------------------------------------------------------------------------- | --------- | ----------- | --------- | -------- | ------------------- | ------------------------------------------------------------- |
| `search_meetings`                | Search meetings in Cogram. 25 results per page.                                   | Tool      | Read        | Immediate | Meetings |                     |                                                               |
| `get_meetings_by_id`             | Retrieve full details for specific meetings.                                      | Operation | Read        | Immediate | Meetings |                     | Deprecated tool `get_meetings_by_id` still listed             |
| `get_meeting_transcript`         | Read the full verbatim transcript of one meeting.                                 | Operation | Read        | Immediate | Meetings |                     |                                                               |
| `search_meeting_attachments`     | Search files attached to meetings (PDF, image, DOCX, XLSX, and similar).          | Operation | Read        | Immediate | Meetings |                     | Deprecated tool `search_meeting_attachments` still listed     |
| `get_meeting_attachment_content` | Read the full content of one meeting attachment.                                  | Operation | Read        | Immediate | Meetings |                     | Deprecated tool `get_meeting_attachment_content` still listed |
| `move_meetings`                  | Move meetings to another project.                                                 | Operation | Write       | Immediate | Meetings |                     |                                                               |
| `delete_meetings`                | Delete meetings for good. This cannot be undone.                                  | Operation | High impact | Immediate | Meetings |                     |                                                               |
| `attend_meeting`                 | Send the Cogram notetaker to a meeting that is happening now, from its join link. | Operation | Write       | Immediate | Meetings |                     |                                                               |

## Emails

| Name                           | What it does                                                                                                | Kind      | Tier        | Effect    | Module           | Required permission | Notes                                                       |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------- | --------- | ----------- | --------- | ---------------- | ------------------- | ----------------------------------------------------------- |
| `search_emails`                | Search emails stored in Cogram.                                                                             | Tool      | Read        | Immediate | Email Management |                     |                                                             |
| `get_emails_by_id`             | Retrieve full details for specific emails, including their attachment list.                                 | Operation | Read        | Immediate | Email Management |                     | Deprecated tool `get_emails_by_id` still listed             |
| `search_email_attachments`     | Search the content of email attachments: PDFs, Excel sheets, Word documents, and text recognized in images. | Operation | Read        | Immediate | Email Management |                     | Deprecated tool `search_email_attachments` still listed     |
| `get_email_attachment_content` | Read the full extracted text of one email attachment.                                                       | Operation | Read        | Immediate | Email Management |                     | Deprecated tool `get_email_attachment_content` still listed |
| `export_emails`                | Export emails as files and return a download link.                                                          | Operation | Read        | Immediate | Email Management |                     |                                                             |
| `move_emails`                  | Move filed emails to another project.                                                                       | Operation | Write       | Immediate | Email Management |                     |                                                             |
| `delete_emails`                | Delete filed emails from Cogram for good. This cannot be undone.                                            | Operation | High impact | Immediate | Email Management |                     |                                                             |

## Tasks

| Name                          | What it does                                                                                    | Kind      | Tier  | Effect    | Module | Required permission | Notes                                                      |
| ----------------------------- | ----------------------------------------------------------------------------------------------- | --------- | ----- | --------- | ------ | ------------------- | ---------------------------------------------------------- |
| `search_board_items`          | Search project board items across every project the connected user can access.                  | Tool      | Read  | Immediate |        |                     |                                                            |
| `get_board_item`              | Retrieve one project board item with its full history timeline.                                 | Operation | Read  | Immediate |        |                     | Deprecated tool `get_board_item` still listed              |
| `get_board_items_for_meeting` | Retrieve the board items one meeting touched, whether it created them or moved them.            | Operation | Read  | Immediate |        |                     | Deprecated tool `get_board_items_for_meeting` still listed |
| `create_board_item`           | Create a task on a project's board.                                                             | Operation | Write | Immediate |        |                     |                                                            |
| `update_board_item`           | Update a task on a project's board: change its fields, reassign it, close it, or add a comment. | Operation | Write | Immediate |        |                     |                                                            |

## Contract administration

| Name                       | What it does                                                                                                                                                      | Kind      | Tier        | Effect    | Module                           | Required permission | Notes                                                 |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | ----------- | --------- | -------------------------------- | ------------------- | ----------------------------------------------------- |
| `search_rfis`              | Search RFIs (Requests for Information) across accessible projects.                                                                                                | Operation | Read        | Immediate | Correspondence                   |                     | Deprecated tool `search_rfis` still listed            |
| `get_rfis_by_id`           | Retrieve full details for specific RFIs: questions, answers, assignees, and ball-in-court.                                                                        | Operation | Read        | Immediate | Correspondence                   |                     | Deprecated tool `get_rfis_by_id` still listed         |
| `search_submittals`        | Search submittals — shop drawings, product data, samples — across accessible projects.                                                                            | Operation | Read        | Immediate | Correspondence                   |                     | Deprecated tool `search_submittals` still listed      |
| `get_submittals_by_id`     | Retrieve full details for specific submittals: description, approvers, and attachments.                                                                           | Operation | Read        | Immediate | Correspondence                   |                     | Deprecated tool `get_submittals_by_id` still listed   |
| `search_transmittals`      | Search transmittals: the formal envelopes used to exchange documents between organizations, such as submittal packages, drawing sets, and specification packages. | Operation | Read        | Immediate | Transmittals or Email Management |                     | Deprecated tool `search_transmittals` still listed    |
| `get_transmittals_by_id`   | Retrieve full details for specific transmittals: recipients, documents, and remarks.                                                                              | Operation | Read        | Immediate | Transmittals or Email Management |                     | Deprecated tool `get_transmittals_by_id` still listed |
| `create_rfi`               | Enter an RFI by hand from a contractor's question.                                                                                                                | Operation | Write       | Immediate | Correspondence                   |                     |                                                       |
| `set_rfi_status`           | Set the workflow status of an RFI in Cogram.                                                                                                                      | Operation | Write       | Immediate | Correspondence                   |                     |                                                       |
| `mark_rfi_responded`       | Record that an RFI was answered outside Cogram. Nothing is sent.                                                                                                  | Operation | Write       | Immediate | Correspondence                   |                     |                                                       |
| `respond_to_rfi`           | Send the answer to an RFI. The answer leaves Cogram and cannot be recalled.                                                                                       | Operation | High impact | Immediate | Correspondence                   |                     |                                                       |
| `set_rfi_assignee`         | Set or clear who in the team an RFI is assigned to.                                                                                                               | Operation | Write       | Immediate | Correspondence                   |                     |                                                       |
| `set_rfi_dates`            | Change the received and due dates of an RFI.                                                                                                                      | Operation | Write       | Immediate | Correspondence                   |                     |                                                       |
| `set_rfi_subject`          | Change the subject of an RFI.                                                                                                                                     | Operation | Write       | Immediate | Correspondence                   |                     |                                                       |
| `delete_rfis`              | Delete RFIs for good, with their thread and attachments. This cannot be undone.                                                                                   | Operation | High impact | Immediate | Correspondence                   |                     |                                                       |
| `create_submittal`         | Enter a submittal by hand from a contractor's package.                                                                                                            | Operation | Write       | Immediate | Correspondence                   |                     |                                                       |
| `set_submittal_status`     | Set the workflow status of a submittal in Cogram.                                                                                                                 | Operation | Write       | Immediate | Correspondence                   |                     |                                                       |
| `mark_submittal_responded` | Record that a submittal was returned outside Cogram. Nothing is sent.                                                                                             | Operation | Write       | Immediate | Correspondence                   |                     |                                                       |
| `respond_to_submittal`     | Return a submittal with its review action. The response leaves Cogram and cannot be recalled.                                                                     | Operation | High impact | Immediate | Correspondence                   |                     |                                                       |
| `set_submittal_assignee`   | Set or clear who in the team a submittal is assigned to.                                                                                                          | Operation | Write       | Immediate | Correspondence                   |                     |                                                       |
| `set_submittal_dates`      | Change the received and due dates of a submittal.                                                                                                                 | Operation | Write       | Immediate | Correspondence                   |                     |                                                       |
| `set_submittal_title`      | Change the title of a submittal.                                                                                                                                  | Operation | Write       | Immediate | Correspondence                   |                     |                                                       |
| `delete_submittals`        | Delete submittals for good, with their thread and attachments. This cannot be undone.                                                                             | Operation | High impact | Immediate | Correspondence                   |                     |                                                       |
| `create_transmittal`       | Create a draft transmittal: a formal envelope that sends project documents or drawings to people outside the team.                                                | Operation | Write       | Immediate | Transmittals or Email Management |                     |                                                       |
| `send_transmittal`         | Send a draft transmittal to its recipients. A sent transmittal cannot be unsent.                                                                                  | Operation | High impact | Immediate | Transmittals or Email Management |                     |                                                       |
| `close_transmittal`        | Mark a sent transmittal complete.                                                                                                                                 | Operation | Write       | Immediate | Transmittals or Email Management |                     |                                                       |

## Insights

| Name                        | What it does                                                                                                               | Kind      | Tier        | Effect    | Module   | Required permission | Notes |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------- | --------- | ----------- | --------- | -------- | ------------------- | ----- |
| `list_custom_insights`      | List custom insights: prompts that Cogram runs on a meeting's transcript after the meeting, such as "List the open risks". | Operation | Read        | Immediate | Meetings |                     |       |
| `list_insight_placeholders` | List the placeholders a custom insight's prompt can use in a scope.                                                        | Operation | Read        | Immediate | Meetings |                     |       |
| `test_custom_insight`       | Run prompt text on one meeting and return the output, without saving the insight.                                          | Operation | Write       | Immediate | Meetings |                     |       |
| `create_custom_insight`     | Create a custom insight for the connected user, a group, or the organization.                                              | Operation | Write       | Immediate | Meetings |                     |       |
| `set_custom_insight_active` | Switch a custom insight on or off.                                                                                         | Operation | Write       | Immediate | Meetings |                     |       |
| `update_custom_insight`     | Change a custom insight's name, description, or prompt text.                                                               | Operation | Write       | Immediate | Meetings |                     |       |
| `delete_custom_insight`     | Delete a custom insight and the results it produced on past meetings. This cannot be undone.                               | Operation | High impact | Immediate | Meetings |                     |       |
| `list_insight_preferences`  | List the insight preferences that apply to the connected user.                                                             | Operation | Read        | Immediate | Meetings |                     |       |
| `set_insight_preference`    | Write an insight preference: free-text guidance Cogram follows when it writes insights.                                    | Operation | Write       | Immediate | Meetings |                     |       |
| `delete_insight_preference` | Delete an insight preference. This cannot be undone.                                                                       | Operation | High impact | Immediate | Meetings |                     |       |

## Directory

| Name                              | What it does                                                                                    | Kind      | Tier  | Effect    | Module | Required permission      | Notes                                           |
| --------------------------------- | ----------------------------------------------------------------------------------------------- | --------- | ----- | --------- | ------ | ------------------------ | ----------------------------------------------- |
| `search_directory`                | Search the organization's directory of external people and companies.                           | Operation | Read  | Immediate |        |                          | Deprecated tool `search_directory` still listed |
| `preview_directory_company_links` | List directory contacts that have no company, each with the company its email domain points at. | Operation | Read  | Immediate |        |                          |                                                 |
| `preview_directory_project_links` | List people who are on a project's correspondence but missing from that project's directory.    | Operation | Read  | Immediate |        |                          |                                                 |
| `create_contact`                  | Create a contact in the organization's directory of external people.                            | Operation | Write | Immediate |        | Create directory contact |                                                 |
| `update_contact`                  | Update a contact in the organization's directory.                                               | Operation | Write | Immediate |        | Update directory contact |                                                 |
| `create_company`                  | Create a company in the organization's directory.                                               | Operation | Write | Immediate |        | Create directory company |                                                 |
| `update_company`                  | Update a company in the organization's directory.                                               | Operation | Write | Immediate |        | Update directory company |                                                 |
| `add_project_contact`             | Add an external person to a project's directory.                                                | Operation | Write | Immediate |        |                          |                                                 |

## Automations and agents

| Name                    | What it does                                                                         | Kind      | Tier  | Effect    | Module | Required permission | Notes                                           |
| ----------------------- | ------------------------------------------------------------------------------------ | --------- | ----- | --------- | ------ | ------------------- | ----------------------------------------------- |
| `search_automations`    | Search the agents the connected user created, by name or description.                | Operation | Read  | Immediate |        |                     | Deprecated tool `search_agents` still listed    |
| `get_automations_by_id` | Retrieve the full configuration of specific agents the connected user created.       | Operation | Read  | Immediate |        |                     | Deprecated tool `get_agents_by_id` still listed |
| `get_automation`        | Retrieve the full configuration of one automation.                                   | Operation | Read  | Immediate |        |                     |                                                 |
| `create_automation`     | Create an automation: a task that runs on a routine or on an event in Cogram.        | Operation | Write | Immediate |        |                     |                                                 |
| `update_automation`     | Change an automation. Only the fields passed change.                                 | Operation | Write | Immediate |        |                     |                                                 |
| `run_automation`        | Start a run of an automation now, outside its routine.                               | Operation | Write | Immediate |        |                     |                                                 |
| `set_automation_status` | Pause an automation, or make it active.                                              | Operation | Write | Immediate |        |                     |                                                 |
| `list_agents`           | List the Specialist Agents the connected user may use, by name or description.       | Operation | Read  | Immediate |        |                     |                                                 |
| `get_agent`             | Retrieve one Specialist Agent the connected user may use.                            | Operation | Read  | Immediate |        |                     |                                                 |
| `create_agent`          | Create a Specialist Agent: a reusable definition for Cogram's own assistant.         | Operation | Write | Immediate |        |                     |                                                 |
| `update_agent`          | Change a Specialist Agent the connected user manages. Only the fields passed change. | Operation | Write | Immediate |        |                     |                                                 |

## Documents and schedules

| Name                   | What it does                                                                | Kind      | Tier  | Effect    | Module | Required permission | Notes                                              |
| ---------------------- | --------------------------------------------------------------------------- | --------- | ----- | --------- | ------ | ------------------- | -------------------------------------------------- |
| `search_documents`     | Search documents indexed in Cogram: PDFs, DOCX, XLSX, and images.           | Operation | Read  | Immediate |        |                     | Deprecated tool `search_documents` still listed    |
| `get_documents_by_id`  | Retrieve full details, including extracted content, for specific documents. | Operation | Read  | Immediate |        |                     | Deprecated tool `get_documents_by_id` still listed |
| `get_project_schedule` | Get a project's schedule: its phases, activities and milestones.            | Operation | Read  | Immediate |        |                     | Limited release                                    |
| `create_schedule`      | Create a project's schedule with its first items.                           | Operation | Write | Immediate |        |                     | Limited release                                    |

## Drawings

| Name                 | What it does                                                                              | Kind      | Tier        | Effect    | Module        | Required permission | Notes                                             |
| -------------------- | ----------------------------------------------------------------------------------------- | --------- | ----------- | --------- | ------------- | ------------------- | ------------------------------------------------- |
| `search_drawings`    | Search construction drawings (sheets and plans) across accessible projects.               | Operation | Read        | Immediate | Field Reports |                     | Deprecated tool `search_drawings` still listed    |
| `get_drawings_by_id` | Retrieve full details for specific drawings, including revisions and linked observations. | Operation | Read        | Immediate | Field Reports |                     | Deprecated tool `get_drawings_by_id` still listed |
| `move_drawings`      | Move drawings to another project.                                                         | Operation | Write       | Immediate | Field Reports |                     |                                                   |
| `delete_drawings`    | Delete drawings for good, with every revision. This cannot be undone.                     | Operation | High impact | Immediate | Field Reports |                     |                                                   |

## Field reports

| Name                   | What it does                                                                                                                                     | Kind      | Tier        | Effect    | Module        | Required permission | Notes                                               |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | --------- | ----------- | --------- | ------------- | ------------------- | --------------------------------------------------- |
| `search_reports`       | Search field reports by name, type, or date range.                                                                                               | Operation | Read        | Immediate | Field Reports |                     | Deprecated tool `search_reports` still listed       |
| `get_reports_by_id`    | Retrieve full details for specific field reports, including their observations.                                                                  | Operation | Read        | Immediate | Field Reports |                     | Deprecated tool `get_reports_by_id` still listed    |
| `get_org_data_summary` | Count the records of every major data type in the organization: meetings, emails, projects, drawings, field reports, observations, agents, RFIs. | Operation | Read        | Immediate |               |                     | Deprecated tool `get_org_data_summary` still listed |
| `move_reports`         | Move field reports to another project.                                                                                                           | Operation | Write       | Immediate | Field Reports |                     |                                                     |
| `delete_reports`       | Delete field reports for good. This cannot be undone.                                                                                            | Operation | High impact | Immediate | Field Reports |                     |                                                     |

## Observations

| Name                     | What it does                                                             | Kind      | Tier        | Effect    | Module        | Required permission | Notes                                                 |
| ------------------------ | ------------------------------------------------------------------------ | --------- | ----------- | --------- | ------------- | ------------------- | ----------------------------------------------------- |
| `search_observations`    | Search field observations by description, status, type, or location.     | Operation | Read        | Immediate | Field Reports |                     | Deprecated tool `search_observations` still listed    |
| `get_observations_by_id` | Retrieve full details for specific field observations, including photos. | Operation | Read        | Immediate | Field Reports |                     | Deprecated tool `get_observations_by_id` still listed |
| `move_observations`      | Move observations that belong to no report to another project.           | Operation | Write       | Immediate | Field Reports |                     |                                                       |
| `delete_observations`    | Delete observations for good, with their photos. This cannot be undone.  | Operation | High impact | Immediate | Field Reports |                     |                                                       |

## Knowledge, skills, and email drafts

| Name                   | What it does                                                                                                                      | Kind      | Tier  | Effect    | Module | Required permission | Notes |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------- | --------- | ----- | --------- | ------ | ------------------- | ----- |
| `search_knowledge`     | Search the connected user's Knowledge: the notes, templates, and files saved as reference material for Cogram's assistant.        | Operation | Read  | Immediate |        |                     |       |
| `read_knowledge_entry` | Read the text of one Knowledge entry or one project document.                                                                     | Operation | Read  | Immediate |        |                     |       |
| `save_knowledge_note`  | Propose saving a note to Knowledge. Nothing is saved until the connected user approves the proposal in Cogram.                    | Operation | Write | Proposal  |        |                     |       |
| `save_knowledge_file`  | Propose saving a file to Knowledge. Nothing is saved until the connected user approves the proposal in Cogram.                    | Operation | Write | Proposal  |        |                     |       |
| `create_skill`         | Propose a new personal skill for Cogram's assistant. Nothing is created until the connected user approves the proposal in Cogram. | Operation | Write | Proposal  |        |                     |       |
| `propose_email`        | Propose an email for the connected user to approve. This operation sends nothing.                                                 | Operation | Write | Proposal  |        |                     |       |

## Organization settings

| Name                           | What it does                                                                              | Kind      | Tier  | Effect    | Module | Required permission          | Notes |
| ------------------------------ | ----------------------------------------------------------------------------------------- | --------- | ----- | --------- | ------ | ---------------------------- | ----- |
| `get_organization_settings`    | Read the organization settings that update\_organization\_settings can change.            | Operation | Read  | Immediate |        | Manage organization settings |       |
| `update_organization_settings` | Change organization settings. The change applies to everyone in the organization at once. | Operation | Write | Immediate |        | Manage organization settings |       |
| `update_organization_profile`  | Change the organization's profile: its name, headquarters address and firm details.       | Operation | Write | Immediate |        | Manage organization settings |       |

## Account settings

| Name                    | What it does                                                                                             | Kind      | Tier  | Effect    | Module | Required permission | Notes                                |
| ----------------------- | -------------------------------------------------------------------------------------------------------- | --------- | ----- | --------- | ------ | ------------------- | ------------------------------------ |
| `whoami`                | Identify the connected Cogram user: id, email, name, and organization.                                   | Tool      | Read  | Immediate |        |                     | Deprecated, no replacement operation |
| `get_my_settings`       | Read the connected user's own profile and preferences.                                                   | Operation | Read  | Immediate |        |                     |                                      |
| `update_my_profile`     | Change the connected user's own profile. Only the fields passed change.                                  | Operation | Write | Immediate |        |                     |                                      |
| `update_my_preferences` | Change the connected user's own notification, calendar, notetaker, email and meeting access preferences. | Operation | Write | Immediate |        |                     |                                      |

## Next steps

* [MCP Server](https://docs.cogram.com/integrations/mcp-server.md): administrator setup, limits, and troubleshooting.
* [Connecting AI apps](https://docs.cogram.com/integrations/connecting-ai-apps.md): the steps a user follows to connect.

Questions? Email <support@cogram.com> or use the in-app Help menu.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.cogram.com/integrations/mcp-tools.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
