# MCP tools

> Every tool of the bymundi MCP server, grouped by area, with the permission each needs.

Every tool the bymundi MCP server can offer. A key sees only the tools its permissions allow ([permissions](https://api.bymundi.com/docs/guides/permissions.md)).

## Account

| Tool | What it does | Needs |
|---|---|---|
| [`whoami`](https://api.bymundi.com/docs/mcp/tools/whoami.md) | Who am I | any key |

## Catalog

| Tool | What it does | Needs |
|---|---|---|
| [`search_catalog`](https://api.bymundi.com/docs/mcp/tools/search_catalog.md) | Search or browse the catalog | `catalog:read` |
| [`get_catalog_entity`](https://api.bymundi.com/docs/mcp/tools/get_catalog_entity.md) | Get a catalog entry | `catalog:read` |
| [`search_library`](https://api.bymundi.com/docs/mcp/tools/search_library.md) | Search or browse the block library | `catalog:read` |
| [`get_library_entry`](https://api.bymundi.com/docs/mcp/tools/get_library_entry.md) | Get a library block | `catalog:read` |
| [`list_trip_templates`](https://api.bymundi.com/docs/mcp/tools/list_trip_templates.md) | Search or browse trip templates | `catalog:read` |
| [`get_trip_template`](https://api.bymundi.com/docs/mcp/tools/get_trip_template.md) | Get a trip template | `catalog:read` |
| [`create_catalog_entity`](https://api.bymundi.com/docs/mcp/tools/create_catalog_entity.md) | Create a catalog entry | `catalog:write` |
| [`update_catalog_entity`](https://api.bymundi.com/docs/mcp/tools/update_catalog_entity.md) | Update a catalog entry | `catalog:write` |
| [`delete_catalog_entity`](https://api.bymundi.com/docs/mcp/tools/delete_catalog_entity.md) | Delete a catalog entry | `catalog:write` |
| [`restore_catalog_entity`](https://api.bymundi.com/docs/mcp/tools/restore_catalog_entity.md) | Restore a deleted catalog entry | `catalog:write` |
| [`list_catalog_features`](https://api.bymundi.com/docs/mcp/tools/list_catalog_features.md) | List the agency's rasgos | `catalog:read` |
| [`start_catalog_image_upload`](https://api.bymundi.com/docs/mcp/tools/start_catalog_image_upload.md) | Start a catalog photo upload | `catalog:write` |
| [`complete_catalog_image_upload`](https://api.bymundi.com/docs/mcp/tools/complete_catalog_image_upload.md) | Complete a catalog photo upload | `catalog:write` |
| [`upload_catalog_image`](https://api.bymundi.com/docs/mcp/tools/upload_catalog_image.md) | Upload a small catalog photo | `catalog:write` |
| [`list_routes`](https://api.bymundi.com/docs/mcp/tools/list_routes.md) | List routes | `catalog:read` |
| [`get_route`](https://api.bymundi.com/docs/mcp/tools/get_route.md) | Get a route | `catalog:read` |
| [`create_route`](https://api.bymundi.com/docs/mcp/tools/create_route.md) | Create a route | `catalog:write` |
| [`update_route`](https://api.bymundi.com/docs/mcp/tools/update_route.md) | Update a route | `catalog:write` |
| [`delete_route`](https://api.bymundi.com/docs/mcp/tools/delete_route.md) | Delete a route | `catalog:write` |
| [`save_library_entry`](https://api.bymundi.com/docs/mcp/tools/save_library_entry.md) | Save a block to the library | `catalog:write`, `trips:read` |
| [`update_library_entry`](https://api.bymundi.com/docs/mcp/tools/update_library_entry.md) | Update a library block | `catalog:write` |
| [`delete_library_entry`](https://api.bymundi.com/docs/mcp/tools/delete_library_entry.md) | Delete a library block | `catalog:write` |
| [`save_trip_template`](https://api.bymundi.com/docs/mcp/tools/save_trip_template.md) | Save a trip as a template | `catalog:write`, `trips:read` |
| [`update_trip_template`](https://api.bymundi.com/docs/mcp/tools/update_trip_template.md) | Update a trip template | `catalog:write` |
| [`delete_trip_template`](https://api.bymundi.com/docs/mcp/tools/delete_trip_template.md) | Delete a trip template | `catalog:write` |

## Changes

| Tool | What it does | Needs |
|---|---|---|
| [`list_changes`](https://api.bymundi.com/docs/mcp/tools/list_changes.md) | List changes | any key |
| [`undo_change`](https://api.bymundi.com/docs/mcp/tools/undo_change.md) | Undo a change | any key |

## Documents

| Tool | What it does | Needs |
|---|---|---|
| [`list_documents`](https://api.bymundi.com/docs/mcp/tools/list_documents.md) | List a trip's documents and folders | `documents:read` |
| [`read_document`](https://api.bymundi.com/docs/mcp/tools/read_document.md) | Read a document | `documents:read` |
| [`start_document_upload`](https://api.bymundi.com/docs/mcp/tools/start_document_upload.md) | Start a document upload | `documents:write` |
| [`complete_document_upload`](https://api.bymundi.com/docs/mcp/tools/complete_document_upload.md) | Complete a document upload | `documents:write` |
| [`upload_document`](https://api.bymundi.com/docs/mcp/tools/upload_document.md) | Upload a small document | `documents:write` |
| [`update_document`](https://api.bymundi.com/docs/mcp/tools/update_document.md) | Update a document | `documents:write` |
| [`delete_document`](https://api.bymundi.com/docs/mcp/tools/delete_document.md) | Delete a document | `documents:write` |
| [`create_document_folder`](https://api.bymundi.com/docs/mcp/tools/create_document_folder.md) | Create a document folder | `documents:write` |
| [`rename_document_folder`](https://api.bymundi.com/docs/mcp/tools/rename_document_folder.md) | Rename a document folder | `documents:write` |
| [`delete_document_folder`](https://api.bymundi.com/docs/mcp/tools/delete_document_folder.md) | Delete a document folder | `documents:write` |

## Itinerary

| Tool | What it does | Needs |
|---|---|---|
| [`sync_itinerary`](https://api.bymundi.com/docs/mcp/tools/sync_itinerary.md) | Sync the itinerary with the design | `trips:write` |
| [`get_itinerary`](https://api.bymundi.com/docs/mcp/tools/get_itinerary.md) | Read a trip's itinerary | `trips:read` |
| [`get_blocks`](https://api.bymundi.com/docs/mcp/tools/get_blocks.md) | Read blocks in full | `trips:read` |
| [`apply_itinerary_changes`](https://api.bymundi.com/docs/mcp/tools/apply_itinerary_changes.md) | Change the itinerary | `trips:write` |

## Planning

| Tool | What it does | Needs |
|---|---|---|
| [`search_places`](https://api.bymundi.com/docs/mcp/tools/search_places.md) | Search places for a day | `trips:read`, `catalog:read` |
| [`suggest_routes`](https://api.bymundi.com/docs/mcp/tools/suggest_routes.md) | Suggest saved routes for a day | `trips:read`, `catalog:read` |
| [`plan_day`](https://api.bymundi.com/docs/mcp/tools/plan_day.md) | Check whether a day fits | `trips:read`, `catalog:read` |
| [`fill_days`](https://api.bymundi.com/docs/mcp/tools/fill_days.md) | Fill days with routes or stops | `trips:write`, `catalog:read` |
| [`insert_library_entry`](https://api.bymundi.com/docs/mcp/tools/insert_library_entry.md) | Insert a library block into a trip | `trips:write`, `catalog:read` |

## Quote templates

| Tool | What it does | Needs |
|---|---|---|
| [`list_quote_templates`](https://api.bymundi.com/docs/mcp/tools/list_quote_templates.md) | List quote templates | `quotes:read` |

## Quotes

| Tool | What it does | Needs |
|---|---|---|
| [`list_quotes`](https://api.bymundi.com/docs/mcp/tools/list_quotes.md) | List quotes | `quotes:read` |
| [`get_quote`](https://api.bymundi.com/docs/mcp/tools/get_quote.md) | Get a quote | `quotes:read` |
| [`create_quote`](https://api.bymundi.com/docs/mcp/tools/create_quote.md) | Create a quote | `quotes:write` |
| [`update_quote`](https://api.bymundi.com/docs/mcp/tools/update_quote.md) | Update a quote | `quotes:write` |
| [`edit_quote_lines`](https://api.bymundi.com/docs/mcp/tools/edit_quote_lines.md) | Edit a quote's lines and packages | `quotes:write` |
| [`sync_quote_with_design`](https://api.bymundi.com/docs/mcp/tools/sync_quote_with_design.md) | Sync a quote with the trip's design | `quotes:write` |
| [`send_quote`](https://api.bymundi.com/docs/mcp/tools/send_quote.md) | Send a quote | `quotes:write` |
| [`accept_quote`](https://api.bymundi.com/docs/mcp/tools/accept_quote.md) | Accept a quote on the customer's behalf | `quotes:write` |
| [`reject_quote`](https://api.bymundi.com/docs/mcp/tools/reject_quote.md) | Reject a quote on the customer's behalf | `quotes:write` |
| [`reopen_quote`](https://api.bymundi.com/docs/mcp/tools/reopen_quote.md) | Reopen a quote | `quotes:write` |
| [`delete_quote`](https://api.bymundi.com/docs/mcp/tools/delete_quote.md) | Delete a quote | `quotes:write` |

## Travelers

| Tool | What it does | Needs |
|---|---|---|
| [`get_travelers`](https://api.bymundi.com/docs/mcp/tools/get_travelers.md) | Get a trip's travelers | `travelers:read` |
| [`add_traveler`](https://api.bymundi.com/docs/mcp/tools/add_traveler.md) | Add a traveler | `travelers:write` |
| [`update_traveler`](https://api.bymundi.com/docs/mcp/tools/update_traveler.md) | Update a traveler | `travelers:write` |
| [`remove_traveler`](https://api.bymundi.com/docs/mcp/tools/remove_traveler.md) | Remove a traveler | `travelers:write` |
| [`add_trip_contact`](https://api.bymundi.com/docs/mcp/tools/add_trip_contact.md) | Add the booking contact | `travelers:write` |
| [`update_trip_contact`](https://api.bymundi.com/docs/mcp/tools/update_trip_contact.md) | Update the booking contact | `travelers:write` |
| [`remove_trip_contact`](https://api.bymundi.com/docs/mcp/tools/remove_trip_contact.md) | Remove the booking contact | `travelers:write` |
| [`resend_access_email`](https://api.bymundi.com/docs/mcp/tools/resend_access_email.md) | Resend an access email | `travelers:write` |

## Trips

| Tool | What it does | Needs |
|---|---|---|
| [`list_trips`](https://api.bymundi.com/docs/mcp/tools/list_trips.md) | List trips | `trips:read` |
| [`list_archived_trips`](https://api.bymundi.com/docs/mcp/tools/list_archived_trips.md) | List archived trips | `trips:read` |
| [`get_trip`](https://api.bymundi.com/docs/mcp/tools/get_trip.md) | Get a trip | `trips:read` |
| [`create_trip`](https://api.bymundi.com/docs/mcp/tools/create_trip.md) | Create a trip | `trips:write` |
| [`update_trip`](https://api.bymundi.com/docs/mcp/tools/update_trip.md) | Update a trip | `trips:write` |
| [`archive_trip`](https://api.bymundi.com/docs/mcp/tools/archive_trip.md) | Archive a trip | `trips:write` |
| [`restore_trip`](https://api.bymundi.com/docs/mcp/tools/restore_trip.md) | Restore an archived trip | `trips:write` |
| [`duplicate_trip`](https://api.bymundi.com/docs/mcp/tools/duplicate_trip.md) | Duplicate a trip | `trips:write` |
| [`publish_trip`](https://api.bymundi.com/docs/mcp/tools/publish_trip.md) | Publish a trip | `trips:write` |
| [`unpublish_trip`](https://api.bymundi.com/docs/mcp/tools/unpublish_trip.md) | Unpublish a trip | `trips:write` |
| [`set_trip_commercial_state`](https://api.bymundi.com/docs/mcp/tools/set_trip_commercial_state.md) | Set a trip's commercial state | `trips:write` |