{"article":{"id":47563484102413,"url":"https://scorohelp.zendesk.com/api/v2/help_center/en-us/articles/47563484102413.json","html_url":"https://support.scoro.com/hc/en-us/articles/47563484102413-Scoro-MCP-server-supported-tools","author_id":11281704014989,"comments_disabled":true,"draft":false,"promoted":false,"position":5,"vote_sum":0,"vote_count":0,"upvote_count":0,"downvote_count":0,"section_id":17979204918157,"created_at":"2026-07-22T13:53:50Z","updated_at":"2026-11-16T16:30:28Z","name":"Scoro MCP server – supported tools","title":"Scoro MCP server – supported tools","source_locale":"en-us","locale":"en-us","outdated":false,"outdated_locales":[],"edited_at":"2026-11-16T08:14:01Z","user_segment_id":null,"permission_group_id":36242615867021,"content_tag_ids":[],"label_names":["Scoro mcp server"],"body":"<div class=\"bg-grey\"><p><strong>Scoro MCP server</strong> is available on the <strong>Standard</strong> and <strong>Enterprise platforms</strong> and across all legacy plans (Essential, Pro, Standard, Ultimate, Core, Growth, Performance, Enterprise). Learn more about our <a href=\"https://www.scoro.com/pricing/\" target=\"_blank\" rel=\"noopener noreferrer\">Plans &amp; Pricing</a>.</p></div><p>The Scoro MCP server equips external AI assistants (such as Claude or ChatGPT) with tools to interact directly with your Scoro site. Depending on your user permissions and site configuration, these tools enable your AI assistant to search, create, update, and manage data across Scoro.</p><div class=\"bg-grey\"><p>This article provides the full list of the available Scoro MCP tools. You can always ask your AI tool what tools are available. <a href=\"https://support.scoro.com/hc/en-us/articles/12780488077325\" target=\"_blank\" rel=\"noopener noreferrer\">Permission sets</a> control what MCP tools you can use.</p></div><div class=\"bg-grey\">\n<p><strong>Jump to...</strong></p>\n<ul>\n<li data-list-item-id=\"e9e1ff5c5ab09285c68e8935ce3ce0c61\"><a href=\"#h_01KY52ME5FQREXTS0X2H0C2Z13\">Multi-entity support</a></li>\n<li data-list-item-id=\"ea90679b309c3087eeb198e6cef76ed67\"><a href=\"#h_01KY52ME5G5YK1PRKTEW4550FT\">Site administration</a></li>\n<li data-list-item-id=\"e46a3ff86c2a68c43aaadc79b6952e206\"><a href=\"#h_01M5MBW6B8VWEK6TN7F8JNXSFT\">Project management</a></li>\n<li data-list-item-id=\"e5fabf3ae3fb145e3ccdab3bf866644e0\"><a href=\"#h_01KY52ME5MVKA7PD5B44TVV2T6\">Task management</a></li>\n<li data-list-item-id=\"ec285ee4c611458e46b186814cb0aceb4\"><a href=\"#h_01KY52ME5QPQM3SCYMF4YAYDX4\">Calendar and resource planning</a></li>\n<li data-list-item-id=\"e97a5e279a29b64e74b3b64b42bf118b3\"><a href=\"#h_01KY52ME5TAZG881GMXPRW9RP4\">Time tracking and time off</a></li>\n<li data-list-item-id=\"ec33c7baf83aad22be12445fc24e64106\"><a href=\"#h_01KY52ME5XQYXF528WJWC1SEZ3\">Contacts and CRM</a></li>\n<li data-list-item-id=\"ec3e6791aad869c96074cece6eea5fe2c\"><a href=\"#h_01KY52ME60VK9XTPDMCZXYSHG4\">Sales and billing</a></li>\n<li data-list-item-id=\"eacf12d1585c635f16baddd80d1cf4f8b\"><a href=\"#h_01KY52ME65Y40A0YKGSZ6C5MN8\">Purchases and expenses</a></li>\n<li data-list-item-id=\"ec276458725e0f4f68796a6385d9af928\"><a href=\"#h_01KY52ME67CXY8ZMM08YFF006C\">Products and pricing</a></li>\n<li data-list-item-id=\"e74aa9d9e1edd68b3c6e17e1aaae39262\"><a href=\"#h_01KY52ME69QJGWDANF18YXDAZP\">Financial setup and accounting</a></li>\n<li data-list-item-id=\"ecdfc5cc3da9a2220d39d9d01dfce56ce\"><a href=\"#h_01KY52ME6AXS5ZNDC9WENM8KKE\">Custom fields and custom modules</a></li>\n<li data-list-item-id=\"e48cde931f0daafd4fe01517d5567b9c6\"><a href=\"#h_01KY52ME6B5EFTRVFHYKM7DT7P\">Files and PDFs</a></li>\n<li data-list-item-id=\"ef8ca704bbd326f8c4c9d7defb0785afe\"><a href=\"#h_01KY52ME6CAWA8RY0ABWQVAC6A\">Universal tools</a></li>\n<li data-list-item-id=\"ed03bc1f5e13036cf6eb892f62beddaa5\"><a href=\"#h_01M5MC1398GK2NXEB1S7YQMPDF\">ELI (Scoro's AI assistant) tools</a></li>\n</ul>\n</div><h2 id=\"h_01KY52ME5FQREXTS0X2H0C2Z13\" data-pm-slice=\"1 3 []\"><strong>Multi-entity support</strong></h2><p>If your Scoro site uses multiple business entities (company accounts), all supported MCP tools accept an optional entity context (<code>scoroCompanyAccountId</code>). This allows your AI assistant to target specific business units (e.g., \"New York\" or \"Paris\") when pulling data or performing actions. Use the <code>get_me</code> tool to discover which company accounts are available.</p><h2 id=\"h_01KY52ME5G5YK1PRKTEW4550FT\"><strong>Site administration</strong></h2><h3 id=\"h_01KY52ME5G3ED7RE3KWXZ522P0\">Users, roles, and permissions</h3><ul>\n<li data-list-item-id=\"e5e1d4c783b7ca115f5047522f120287d\">\n<strong>Tools:</strong> <code>get_users</code>, <code>get_me</code>, <code>get_roles</code>, <code>create_role</code>, <code>update_role</code>, <code>get_permission_sets</code>, <code>get_user_groups</code>\n</li>\n<li data-list-item-id=\"e1a65319705ec972fed7db7b041729e11\">\n<strong>Description:</strong> Manage user profiles, inspect current user authentication, configure user roles, and review permission sets and user groups.</li>\n</ul><h3 id=\"h_01KY52ME5HBZKQ48PF082VT6V5\">Labor costs</h3><ul>\n<li data-list-item-id=\"e92c18d2a3b3c3e61ebe13839cf200861\">\n<strong>Tools:</strong> <code>get_labor_costs</code>, <code>create_labor_cost</code>, <code>update_labor_cost</code>\n</li>\n<li data-list-item-id=\"e2fa265608f9adadde8f49f025d452ebd\">\n<strong>Description:</strong> Configure internal hourly labor cost rates for users, roles, or site defaults.</li>\n</ul><h3 id=\"h_01KY52ME5JCCNDW07V1A6G3E8J\">Site settings and configuration</h3><ul>\n<li data-list-item-id=\"e1fadb9c94851c4f11f681960bd4072d6\">\n<strong>Tools:</strong> <code>get_settings</code>, <code>update_settings</code>, <code>create_activity_type</code>, <code>update_activity_type</code>, <code>get_site_configuration</code>, <code>get_validation_fields</code>, <code>get_bookmarks</code>\n</li>\n<li data-list-item-id=\"e3f72b50f75745fbce9289b334c32d218\">\n<strong>Description:</strong> Discover site-wide metadata (statuses, activity types, price lists, resources), inspect required/unique field rules, retrieve saved bookmarks, and update site or user settings.</li>\n</ul><h3 id=\"new-subsection-company-account-settings\" data-lfile-container=\"61e010a4-4735-4105-81c2-a37c7a522079\" data-pm-slice=\"1 3 []\">Company account settings</h3><ul>\n<li data-list-item-id=\"e5e4ca9c904d98dda0ab2d7894a6e9abf\">\n<code>get_company_settings</code>: retrieve a company account's branding and identity details.</li>\n<li data-list-item-id=\"e8843702e1277a29bc463df7d8b478fe8\">\n<code>update_company_settings</code>: update name, address, VAT and registration numbers, contact details, website (email and bank account can't be updated).</li>\n<li data-list-item-id=\"e0b569293edbcb0119442e47612dff70d\">\n<code>upload_company_logo</code>: upload the site logo, print logo, or both (png, jpg, jpeg, gif, jfif, svg).</li>\n</ul><h3 id=\"h_01M5MBT5K249AMVMS5QB6818MQ\">Currencies</h3><ul>\n<li data-list-item-id=\"e1bdd22f750769590fb0d234d44d438d5\">\n<code>get_currencies</code>: retrieve currencies from the preset catalogue with their active status.</li>\n<li data-list-item-id=\"ef41219050606f493061b95d966bd290b\">\n<code>update_currency</code>: activate or deactivate a currency, or set the site's default currency.</li>\n</ul><h2 id=\"h_01M5MBW6B8VWEK6TN7F8JNXSFT\"><strong>Project management</strong></h2><h3 id=\"h_01KY52ME5MRRR2CSCENS2P7PAP\">Projects</h3><ul>\n<li data-list-item-id=\"eddb7464b47b415eb8a4a92bbf74f007c\">\n<strong>Tools:</strong> <code>get_projects</code>, <code>create_project</code>, <code>update_project</code>, <code>get_project_budget</code>, <code>get_project_role_prices</code>, <code>upsert_project_role_prices</code>\n</li>\n<li data-list-item-id=\"ebd4e2ac38dfe9155095d80c2583c9078\">\n<strong>Description:</strong> Create and manage projects, inspect planned vs. actual budget data (labor, costs, revenue), and configure role-based selling prices.</li>\n</ul><h3 id=\"h_01KY52ME5NYFP92RAMBBTDDT6X\">Project phases</h3><ul>\n<li data-list-item-id=\"e2bb14c804ad3a589da5fa2f207ef979d\">\n<strong>Tools:</strong> <code>get_project_phases</code>, <code>create_project_phase</code>, <code>update_project_phase</code>\n</li>\n<li data-list-item-id=\"e11437f07268a947be4f1d97ee2206693\">\n<strong>Description:</strong> Track and manage project milestones, deadlines, and phase timelines.</li>\n</ul><h3 id=\"h_01M6DZHD2H1SHDQ55TMEE45B27\">Project templates</h3><ul data-lfile-container=\"61e010a4-4735-4105-81c2-a37c7a522079\" data-pm-slice=\"3 3 []\">\n<li data-list-item-id=\"e59a8440f0bf9600f5aaa1b67c98283c7\">\n<strong>Tools: </strong><code>get_project_templates</code>, <code>create_project_template</code>, <code>update_project_template</code>, <code>get_project_template_phases</code>, <code>create_project_template_phase</code>, <code>update_project_template_phase</code>, <code>delete_project_template_phase</code>\n</li>\n<li data-list-item-id=\"ef86a734a2b46bc168ba8d1f9f45a940e\">\n<strong>Description:</strong> Retrieve, create, update, and delete project templates and their phases and milestones.</li>\n</ul><h2 id=\"h_01KY52ME5MVKA7PD5B44TVV2T6\">Task management</h2><h3 id=\"h_01KY52ME5PB135B8CQ7TMKG05W\">Tasks</h3><ul>\n<li data-list-item-id=\"e31afa941c6375d3abb758a00cf311c11\">\n<strong>Tools:</strong> <code>get_tasks</code>, <code>create_task</code>, <code>update_task</code>\n</li>\n<li data-list-item-id=\"e1a16fea44bcd71a16f7279145c71566e\">\n<strong>Description:</strong> Complete task lifecycle management, including filtering by project, assignee, status, priority, and due dates.</li>\n</ul><h3 id=\"h_01KY52ME5Q2DFYMJYDTEZ6SRGE\">Task bundles</h3><ul>\n<li data-list-item-id=\"eb35e4f3dd8b8e4cb09fea741ea580af2\">\n<code>get_task_bundles</code>: retrieve reusable task bundle templates to quickly structure project work.</li>\n<li data-list-item-id=\"edf3d03c4dff89f5fdb8ddefff6c796dc\"><p data-lfile-container=\"61e010a4-4735-4105-81c2-a37c7a522079\" data-pm-slice=\"1 1 []\"><code>create_task_bundle</code>: creates a new, empty task bundle. Add tasks to it with the <code>create_task_bundle_task</code> tool.</p></li>\n<li data-list-item-id=\"e0b8927f6615cbe8ec86453205b338f25\"><p data-lfile-container=\"61e010a4-4735-4105-81c2-a37c7a522079\" data-pm-slice='1 1 [\"table\",{\"bid\":\"mxcz5jctjkw.1140\"},\"tableRow\",{\"bid\":\"mxcz5jctjkw.1281\"},\"cell\",{\"bid\":\"mxcz5jctjkw.1282\",\"header\":false,\"colspan\":1,\"rowspan\":1,\"colwidth\":null,\"align\":null,\"background\":null}]'><code>update_task_bundle</code>: updates a task bundle's details – the task bundle name, status (activate or deactivate it), and shared status (whether it's shared with other users).</p></li>\n<li data-list-item-id=\"eb87a15c66c44d32b3bac8056d7f387f1\"><p data-lfile-container=\"61e010a4-4735-4105-81c2-a37c7a522079\" data-pm-slice='1 1 [\"table\",{\"bid\":\"mxcz5jctjkw.1140\"},\"tableRow\",{\"bid\":\"mxcz5jctjkw.1368\"},\"cell\",{\"bid\":\"mxcz5jctjkw.1369\",\"header\":false,\"colspan\":1,\"rowspan\":1,\"colwidth\":null,\"align\":null,\"background\":null}]'><code>create_task_bundle_task</code>: adds a task to a task bundle.</p></li>\n<li data-list-item-id=\"ecee00f9604a03d5547daed7d59a2857d\"><p data-lfile-container=\"61e010a4-4735-4105-81c2-a37c7a522079\" data-pm-slice='1 1 [\"table\",{\"bid\":\"mxcz5jctjkw.1140\"},\"tableRow\",{\"bid\":\"mxcz5jctjkw.1457\"},\"cell\",{\"bid\":\"mxcz5jctjkw.1458\",\"header\":false,\"colspan\":1,\"rowspan\":1,\"colwidth\":null,\"align\":null,\"background\":null}]'><code>update_task_bundle_task</code>: updates a task inside a task bundle.</p></li>\n</ul><h3 id=\"h_01M5MBV3RVXA15WBT63743BCEN\" data-lfile-container=\"61e010a4-4735-4105-81c2-a37c7a522079\" data-pm-slice=\"1 3 []\">Task dependencies</h3><ul>\n<li data-list-item-id=\"edac83efda31c94c2f35654836bfc2152\">\n<code>get_task_dependencies</code>: list dependency links for a task, as predecessor or successor.</li>\n<li data-list-item-id=\"e2c8991b93d413fd5590e15a558755af5\">\n<code>create_task_dependency</code>: link two tasks in a project, with a dependency type and a lag or lead in days; use a negative number for lead.</li>\n<li data-list-item-id=\"eeb60dbe0ec02a61756bbb5b1b7f02d9d\">\n<code>update_task_dependency</code>: change the dependency type or lag. You can't change the two linked tasks; delete the dependency and create a new one instead.</li>\n<li data-list-item-id=\"e80959630042846a087124d6252f9b7eb\">\n<code>delete_task_dependency</code>: remove a dependency link.</li>\n</ul><h2 id=\"h_01KY52ME5QPQM3SCYMF4YAYDX4\"><strong>Calendar and resource planning</strong></h2><h3 id=\"h_01KY52ME5Q605F5VSRTDFMPVNN\">Calendar events</h3><ul>\n<li data-list-item-id=\"ebf8c406e546e896e58076c9dec94f95e\">\n<strong>Tools:</strong> <code>get_calendar_events</code>, <code>create_calendar_event</code>, <code>update_calendar_event</code>, <code>get_free_time_slots</code>\n</li>\n<li data-list-item-id=\"ed7952f5f8983ed8628db097a9870cfcc\">\n<strong>Description:</strong> Manage calendar events, invite attendees, and calculate mutually available meeting slots across teams within a date range.</li>\n</ul><h3 id=\"h_01KY52ME5RDM1T465CBWVCG6WY\">Bookings</h3><ul>\n<li data-list-item-id=\"e5c9246cd5e6600ffe6b0eac94986a1b1\">\n<strong>Tools:</strong> <code>get_bookings</code>, <code>create_booking</code>, <code>update_booking</code>\n</li>\n<li data-list-item-id=\"e81b0ff2c0ba1b18d5b608780d09e3007\">\n<strong>Description:</strong> Retrieve, create, and update resource capacity allocations (bookings) on projects for future capacity planning across users and roles.</li>\n</ul><h3 id=\"h_01KY52ME5SMVEBBAS832TAJ5Y2\">Availabilities</h3><ul>\n<li data-list-item-id=\"eea19c32675d2917a18d589e040b959e6\">\n<strong>Tools:</strong> <code>get_availabilities</code>\n</li>\n<li data-list-item-id=\"e98cd916137ec520e53de6f340c4e4d68\">\n<strong>Description:</strong> Check user and role work capacity (in seconds) over specific time periods for workload and staffing analysis.</li>\n</ul><h3 id=\"h_01KY52ME5SKA0MVECNHJN5YXZ6\">Event resources</h3><ul>\n<li data-list-item-id=\"ed20deff49d0826403ef58b27f79b8202\">\n<strong>Tools:</strong> <code>get_event_resources</code>\n</li>\n<li data-list-item-id=\"e1a991cd0bcfafa3a70f0758b85903ab0\">\n<strong>Description:</strong> Fetch bookable event resources (meeting rooms, equipment) for allocation in calendar events and schedules.</li>\n</ul><h2 id=\"h_01KY52ME5TAZG881GMXPRW9RP4\"><strong>Time tracking and time off</strong></h2><h3 id=\"h_01KY52ME5TP996BX0JRSK8G97Q\">Time entries</h3><ul>\n<li data-list-item-id=\"e7f8b1277920e2ad09928fdaf46b66b51\">\n<strong>Tools:</strong> <code>get_time_entries</code>, <code>create_time_entry</code>, <code>update_time_entry</code>\n</li>\n<li data-list-item-id=\"ec88f76f86b6841a42170bbb450fa098c\">\n<strong>Description:</strong> Log completed work hours, edit time entries, and review billable time records.</li>\n</ul><h3 id=\"h_01KY52ME5VRGWS6PYR9E5SNQAK\">Time trackers</h3><ul>\n<li data-list-item-id=\"e273da5f8741216470f5a272542342431\">\n<strong>Tools:</strong> <code>get_time_trackers</code>, <code>start_time_tracker</code>, <code>pause_time_tracker</code>, <code>resume_time_tracker</code>, <code>complete_time_tracker</code>, <code>update_time_tracker</code>\n</li>\n<li data-list-item-id=\"e67b4c86e5b81715afacb93355cefa7ab\">\n<strong>Description:</strong> Start, pause, resume, complete (stop), and manage real-time work stopwatches linked to tasks.</li>\n</ul><h3 id=\"h_01KY52ME5VRKG850X2GEWE4N85\">Time off</h3><ul>\n<li data-list-item-id=\"eb92862993c03b92c5f4e59e6ca2f1188\">\n<strong>Tools:</strong> <code>get_user_timeoffs</code>, <code>get_time_offs</code>, <code>create_time_off</code>, <code>update_time_off</code>\n</li>\n<li data-list-item-id=\"ed1a198ebfbf00f1a1a720339bdfbe0b2\">\n<strong>Description:</strong> Retrieve and log time-off records (vacations, sick leave, etc.) for team members.</li>\n</ul><h3 id=\"h_01KY52ME5WSXAN4973C7H6ZZXV\">Time off types</h3><ul>\n<li data-list-item-id=\"e47e8ca1e30ce3fb97d89c62f49934f8b\">\n<strong>Tools:</strong> <code>get_time_off_types</code>, <code>create_time_off_type</code>, <code>update_time_off_type</code>\n</li>\n<li data-list-item-id=\"e84efe4419cb7923e11b9044994f0d65d\">\n<strong>Description:</strong> Retrieve and define custom types of time off (e.g., vacation, sick leave, parental leave).</li>\n</ul><h2 id=\"h_01KY52ME5XQYXF528WJWC1SEZ3\"><strong>Contacts and CRM</strong></h2><h3 id=\"h_01KY52ME5XA3QAZ51CM6KK519E\">Companies</h3><ul>\n<li data-list-item-id=\"e6985d648ba399acdcf2009d2cffb9891\">\n<strong>Tools:</strong> <code>get_companies</code>, <code>create_company</code>, <code>update_company</code>\n</li>\n<li data-list-item-id=\"ed1000e4eba0d3cc9e22c41a639b77f40\">\n<strong>Description:</strong> Search, create, and manage company contact profiles in the CRM.</li>\n</ul><h3 id=\"h_01KY52ME5Y32FF9PQ9DD813AQW\">Persons</h3><ul>\n<li data-list-item-id=\"e52a8996a81fc911c3258a092abbacfe8\">\n<strong>Tools:</strong> <code>get_persons</code>, <code>create_person</code>, <code>update_person</code>\n</li>\n<li data-list-item-id=\"e4b4e8fde4ca6cd28f7cc9bf8e26d519c\">\n<strong>Description:</strong> Search, create, and manage individual person contact profiles.</li>\n</ul><h3 id=\"h_01KY52ME5ZE4Q9WDXZZH8ZTH3V\">Contact metadata and addresses</h3><ul>\n<li data-list-item-id=\"eb6bedcdcc38c6328e6c889452ea38d07\">\n<strong>Tools:</strong> <code>get_contact_categories</code>, <code>get_contact_relation_types</code>, <code>get_contact_addresses</code>\n</li>\n<li data-list-item-id=\"ec15cea65463024fd29c617f7858e46b0\">\n<strong>Description:</strong> Retrieve contact classification categories, relationship labels between contacts, and physical/postal addresses.</li>\n</ul><h3 id=\"h_01KY52ME5ZYVKZG81ETF0VA0AF\">Client profiles</h3><ul>\n<li data-list-item-id=\"e30dfab2c935cfea9260643a3107fef43\">\n<strong>Tools:</strong> <code>get_client_profiles</code>, <code>create_client_profile</code>, <code>update_client_profile</code>\n</li>\n<li data-list-item-id=\"ef5ac3b8f8b2760a3a39463820f79c3c8\">\n<strong>Description:</strong> Manage reusable sets of billing defaults (discounts, tax rates, payment terms, currency) for client companies.</li>\n</ul><h2 id=\"h_01KY52ME60VK9XTPDMCZXYSHG4\"><strong>Sales and billing</strong></h2><h3 id=\"h_01KY52ME60FDMD74GNHKETPTE3\">Quotes and templates</h3><ul>\n<li data-list-item-id=\"ea653269454176ea09dcf9962c40e823f\">\n<strong>Tools:</strong> <code>get_quotes</code>, <code>get_quote_lines</code>, <code>create_quote</code>, <code>update_quote</code>, <code>upsert_quote_lines</code>, <code>delete_quote_line</code>, <code>get_quote_role_prices</code>, <code>upsert_quote_role_prices</code>, <code>get_quote_templates</code>, <code>create_quote_template</code>, <code>update_quote_template</code>\n</li>\n<li data-list-item-id=\"e37c17f9f63cd06a2c6aea045bc5a8d85\">\n<strong>Description:</strong> Create and manage sales proposals, line items, quote templates, and role-based proposal pricing.</li>\n</ul><h3 id=\"h_01KY52ME61DJV6HGMX4FKX10KR\">Orders</h3><ul>\n<li data-list-item-id=\"ecdfaf63303567d0bd5048b9af9983b89\">\n<strong>Tools:</strong> <code>get_orders</code>, <code>get_order_lines</code>, <code>create_order</code>, <code>update_order</code>, <code>upsert_order_lines</code>, <code>delete_order_line</code>, <code>get_order_role_prices</code>, <code>upsert_order_role_prices</code>\n</li>\n<li data-list-item-id=\"e2a2c25ebb8903c565a534149a5c5194f\">\n<strong>Description:</strong> Manage sales orders (order confirmations) positioned between the quote and invoice stages.</li>\n</ul><h3 id=\"h_01KY52ME62BFCPBQCK5NDVHPTV\">Invoices and payments</h3><ul>\n<li data-list-item-id=\"eb4b60714369729138a33c6d63e3aeb9d\">\n<strong>Tools:</strong> <code>get_invoices</code>, <code>get_invoice_lines</code>, <code>create_invoice</code>, <code>update_invoice</code>, <code>upsert_invoice_lines</code>, <code>delete_invoice_line</code>, <code>get_invoice_role_prices</code>, <code>upsert_invoice_role_prices</code>, <code>get_invoice_payments</code>, <code>get_invoice_payment</code>, <code>create_invoice_payment</code>, <code>get_invoice_payment_allocations</code>, <code>create_invoice_payment_allocation</code>, <code>delete_invoice_payment_allocation</code>\n</li>\n<li data-list-item-id=\"e8d06d4db6bbd0c3cd67eb010ac54f90b\">\n<strong>Description:</strong> Retrieve and issue customer invoices, line items, role pricing rules, payment receipts, and invoice payment allocations.</li>\n</ul><h3 id=\"h_01KY52ME635YR68BJKESYRD7TP\">Scheduled invoices</h3><ul>\n<li data-list-item-id=\"ee40789e7d87fdd8a8205e7ec0935625b\">\n<strong>Tools:</strong> <code>get_scheduled_invoices</code>, <code>get_scheduled_invoice</code>, <code>create_scheduled_invoice</code>, <code>update_scheduled_invoice</code>, <code>get_scheduled_invoice_lines</code>, <code>upsert_scheduled_invoice_lines</code>, <code>delete_scheduled_invoice_line</code>, <code>get_scheduled_invoice_role_prices</code>, <code>upsert_scheduled_invoice_role_prices</code>\n</li>\n<li data-list-item-id=\"e0fda60a8216ec7aa93070483b0396a97\">\n<strong>Description:</strong> Manage recurring invoice templates, automated issuance schedules, line items, and role pricing rules.</li>\n</ul><h3 id=\"h_01KY52ME63014FA4A5BWNGMRXE\">Prepayments</h3><ul>\n<li data-list-item-id=\"e2f3bf81c7d88b5ec64590e572b3e981f\">\n<strong>Tools:</strong> <code>get_prepayments</code>, <code>create_prepayment</code>, <code>update_prepayment</code>, <code>upsert_prepayment_lines</code>, <code>get_prepayment_role_prices</code>, <code>upsert_prepayment_role_prices</code>\n</li>\n<li data-list-item-id=\"e9a94b66fefc20a6de033caa142818680\">\n<strong>Description:</strong> Track advance payments and deposit invoices received from clients prior to project fulfillment.</li>\n</ul><h3 id=\"h_01KY52ME64D9V0QFG7TRNP5AXS\">Retainers</h3><ul>\n<li data-list-item-id=\"eff318a8dd556f8fd9414d19902788c79\">\n<strong>Tools:</strong> <code>get_retainer</code>, <code>update_retainer</code>, <code>get_retainer_periods</code>, <code>create_retainer_period</code>, <code>update_retainer_period</code>\n</li>\n<li data-list-item-id=\"e556c971f43937108130d3851844d40db\">\n<strong>Description:</strong> Track recurring project retainers, period budgets, and actual tracked costs (bills, expenses, labor).</li>\n</ul><h3 id=\"h_01M5VK730RBVT7YB3HQ3ZAQ1BE\">Revenue forecast</h3><ul>\n<li data-list-item-id=\"e52c67a584c5fd5d329a2284fe9eee78f\">\n<code>get_revenue_forecast_periods</code>: Retrieves revenue forecast periods.</li>\n<li data-list-item-id=\"e9472169531791ba06b5df85d8c3f6114\">\n<code>update_revenue_forecast_period</code>: Updates a revenue forecast period.</li>\n</ul><h2 id=\"h_01KY52ME65Y40A0YKGSZ6C5MN8\"><strong>Purchases and expenses</strong></h2><h3 id=\"h_01KY52ME65R5WH446ETFW51BTE\">Bills and bill payments</h3><ul>\n<li data-list-item-id=\"e6f97c6c49644f862d6c578996a089246\">\n<strong>Tools:</strong> <code>get_bills</code>, <code>get_bill_lines</code>, <code>create_bill</code>, <code>update_bill</code>, <code>upsert_bill_lines</code>, <code>delete_bill_line</code>, <code>get_bill_payments</code>, <code>get_bill_payment</code>, <code>create_bill_payment</code>\n</li>\n<li data-list-item-id=\"eaf5881f10668f7421a914d398663f1bf\">\n<strong>Description:</strong> Record supplier bills, manage accounts payable line items, and register outgoing supplier payments.</li>\n</ul><h3 id=\"h_01KY52ME65MV026VRS5ZK71MS1\">Purchase orders</h3><ul>\n<li data-list-item-id=\"ebc337d71580b600ff427010b153ae88a\">\n<strong>Tools:</strong> <code>get_purchase_orders</code>, <code>get_purchase_order_lines</code>, <code>create_purchase_order</code>, <code>update_purchase_order</code>, <code>upsert_purchase_order_lines</code>, <code>delete_purchase_order_line</code>\n</li>\n<li data-list-item-id=\"e647bc758498254b90221cad8fe8a00e8\">\n<strong>Description:</strong> Issue and manage formal purchase orders sent to vendors and suppliers.</li>\n</ul><h3 id=\"h_01KY52ME66EWS9CTCBH4JT1ZVH\">Expenses</h3><ul>\n<li data-list-item-id=\"eb50a90559cc7f0d5bbbda6f8083bddf3\">\n<strong>Tools:</strong> <code>get_expenses</code>, <code>get_expense_lines</code>, <code>create_expense</code>, <code>update_expense</code>, <code>upsert_expense_lines</code>, <code>delete_expense_line</code>, <code>get_expense_reimbursements</code>, <code>create_expense_reimbursement</code>, <code>delete_expense_reimbursement</code>\n</li>\n<li data-list-item-id=\"e5eb8b9e9f0e4bcbe3943c4e1aaf9260d\">\n<strong>Description:</strong> Record operational business expenditures, reimbursable employee costs, and reimbursement logs.</li>\n</ul><h2 id=\"h_01KY52ME67CXY8ZMM08YFF006C\"><strong>Products and pricing</strong></h2><h3 id=\"h_01KY52ME67CX8JGM7TEEH9FRJZ\">Products and product groups</h3><ul>\n<li data-list-item-id=\"eccab62328cc3e5edc066c1532f91d530\">\n<strong>Tools:</strong> <code>get_products</code>, <code>create_product</code>, <code>update_product</code>, <code>get_product_groups</code>, <code>create_product_group</code>, <code>update_product_group</code>\n</li>\n<li data-list-item-id=\"e0d6637f6c0681864e0633b3c37a44aa0\">\n<strong>Description:</strong> Manage products, services, and hierarchical product categories in the product catalogue.</li>\n</ul><h3 id=\"h_01KY52ME689TS38P3EMBA6P8Z5\">Price lists, tax rates, and units</h3><ul>\n<li data-list-item-id=\"e094e21c57552a08ac0476f9c4ea08573\">\n<strong>Tools:</strong> <code>get_price_lists</code>, <code>create_price_list</code>, <code>update_price_list</code>, <code>get_tax_rates</code>, <code>create_tax_rate</code>, <code>update_tax_rate</code>, <code>get_units</code>, <code>create_unit</code>\n</li>\n<li data-list-item-id=\"e818a59544a958d5321987040ab87e5a4\">\n<strong>Description:</strong> Configure currency price lists, document tax rates, and measurement units (hours, pieces, kg).</li>\n</ul><h2 id=\"h_01KY52ME69QJGWDANF18YXDAZP\"><strong>Financial setup and accounting</strong></h2><h3 id=\"h_01KY52ME69FK92948RDCMX77TG\">Finance and payment accounts</h3><ul>\n<li data-list-item-id=\"eb26466070a8889fec030b8649462d54d\">\n<strong>Tools:</strong> <code>get_finance_accounts</code>, <code>create_finance_account</code>, <code>update_finance_account</code>, <code>get_payment_accounts</code>\n</li>\n<li data-list-item-id=\"e9fea2fa10cadf9eee40317775025e517\">\n<strong>Description:</strong> Access and manage the chart of accounts for document bookkeeping, and look up bank/cash payment accounts.</li>\n</ul><h3 id=\"h_01KY52ME69TCEMVVY6BFMP5RMV\">Accounting objects</h3><ul>\n<li data-list-item-id=\"e8c112ae1b156c6e2de9823752f075ebd\">\n<strong>Tools:</strong> <code>get_accounting_objects</code>, <code>create_accounting_object</code>, <code>update_accounting_object</code>\n</li>\n<li data-list-item-id=\"e9745110f44d1cc30e7dfdfd8576f6977\">\n<strong>Description:</strong> Retrieve and configure accounting objects used to classify financial transactions across products and sales documents.</li>\n</ul><h2 id=\"h_01KY52ME6AXS5ZNDC9WENM8KKE\"><strong>Custom fields and custom modules</strong></h2><h3 id=\"h_01KY52ME6AMA8H0AQNA6QAVZEN\">Custom fields</h3><ul>\n<li data-list-item-id=\"e20e787644fac3a66fb0e5fa5cb8ca023\">\n<strong>Tools:</strong> <code>get_custom_fields</code>\n</li>\n<li data-list-item-id=\"e02f6837e5a6ea09b4ac6221be536c6df\">\n<strong>Description:</strong> Inspect active custom field structures across supported Scoro modules (projects, tasks, invoices, contacts, etc.).</li>\n</ul><h3 id=\"h_01KY52ME6ASMY1PB4YXEE50412\">Custom modules</h3><ul>\n<li data-list-item-id=\"ed7b23a7774dc148a3b2364ee65436fe6\">\n<strong>Tools:</strong> <code>get_custom_module_entities</code>, <code>get_custom_module_entity</code>, <code>create_custom_module_entity</code>, <code>update_custom_module_entity</code>, <code>delete_custom_module_entity</code>, <code>get_custom_modules</code>, <code>get_custom_module</code>, <code>get_custom_module_entity_files</code>, <code>create_custom_module_entity_file</code>\n</li>\n<li data-list-item-id=\"e6bec1b290c4fc56c2a9a7ef4e7d4bd3c\">\n<strong>Description:</strong> Access site custom module definitions, manage custom record entities, and upload attachments to custom entities.</li>\n</ul><h2 id=\"h_01KY52ME6B5EFTRVFHYKM7DT7P\"><strong>Files and PDFs</strong></h2><h3 id=\"h_01KY52ME6BA0RSX2X0W6DG4K8V\">Files</h3><ul>\n<li data-list-item-id=\"eabc897e558eaf4e8ab3056448e543c3f\">\n<code>get_files</code>, <code>download_file</code>, <code>upload_file</code>: view file metadata, download raw contents, or attach new files directly to supported Scoro entities.</li>\n<li data-list-item-id=\"e4abae568a2d1053a5f74ccb7c940523b\">\n<code>create_file_upload</code>: start an upload for a larger local file and get a short-lived signed upload URL</li>\n<li data-list-item-id=\"ef14ce8cfe357de4c928f195de4c96a1a\">\n<code>finalize_file_upload</code>: attach the uploaded file to its entity after the HTTP PUT succeeds</li>\n</ul><h3 id=\"h_01KY52ME6C70PPDK1KY0S33QBG\">PDF generation</h3><ul>\n<li data-list-item-id=\"ef072d4651c5c247207db5fa29101cdac\">\n<strong>Tools:</strong> <code>get_pdf</code>, <code>get_pdf_templates</code>\n</li>\n<li data-list-item-id=\"ee12a40a05d789a1763c3e0a399e9a604\">\n<strong>Description:</strong> Generate PDF access links for sales and purchase documents, and manage print layout templates.</li>\n</ul><h2 id=\"h_01KY52ME6CAWA8RY0ABWQVAC6A\"><strong>Universal tools</strong></h2><h3 id=\"h_01KY52ME6C93PZ1WWCNZ83RZFW\">Search and fetch</h3><ul>\n<li data-list-item-id=\"eba8f0548e4ec91ec6636c7627abc2ef8\">\n<strong>Tools:</strong> <code>search</code>, <code>fetch</code>\n</li>\n<li data-list-item-id=\"e1377a3d44cec641bf69581dc282a8f7d\">\n<strong>Description:</strong> Perform universal search across all Scoro entities (bills, companies, expenses, files, invoices, orders, persons, projects, purchase orders, quotes, tasks, users) or fetch raw data directly from Scoro API endpoints.</li>\n<li class=\"wysiwyg-list-bold\" data-list-item-id=\"ea39ee41c961b37ab16fd96c5d659cfcd\">\n<strong>What to keep in mind:</strong><ul><li data-list-item-id=\"e436421950d4f9e3149c34a3dbcf9224e\">The <code>fetch</code> tool <strong>doesn't </strong>support pagination – meaning that this tool completely ignores and discards all query parameters (such as <code>page</code> and <code>perPage</code>), silently returning the default first 20 records. For any operations involving filtering or pagination, please use the module-specific tools, such as <code>get_quotes</code>, <code>get_companies</code>, etc.</li></ul>\n</li>\n</ul><h3 id=\"h_01KY52ME6DT8KFX8Y2X185AQKJ\">Comments</h3><ul>\n<li data-list-item-id=\"eb5162269c4bad1ce9ac84b0021b43299\">\n<strong>Tools:</strong> <code>get_comments</code>, <code>create_comment</code>\n</li>\n<li data-list-item-id=\"ecf9cd37e8658e80ae7b768e66d5f9c7d\">\n<strong>Description:</strong> Add and view comments on tasks, calendar events, projects, and financial records for team collaboration.</li>\n</ul><h3 id=\"h_01KY52ME6DZPZFCPFJCQGTSKMY\">Tags</h3><ul>\n<li data-list-item-id=\"ec06553cb0c96be11837c2576ccb5bc26\">\n<strong>Tools:</strong> <code>get_tags</code>, <code>create_tag</code>, <code>update_tag</code>\n</li>\n<li data-list-item-id=\"e8bddbe33a235f3463e0d02a4b3191cc2\">\n<strong>Description:</strong> Manage tags applied across projects, contacts, products, users, and custom module records.</li>\n</ul><h3 id=\"h_01KY52ME6E2NH6WJF3SEKS1Q45\">Workflow statuses</h3><ul>\n<li data-list-item-id=\"edcd4b5eb33344a007872b8ff60969ebc\">\n<strong>Tools:</strong> <code>create_status</code>, <code>update_status</code>\n</li>\n<li data-list-item-id=\"e8d5e8e6e6f3646d18902565eae9b5b6b\">\n<strong>Description:</strong> Define workflow stages and pipeline statuses for projects, tasks, quotes, purchase orders, and custom modules.</li>\n</ul><h3 id=\"h_01KY52ME6EGZRAX6YD29FKFT7A\">Delete operations</h3><ul><li data-list-item-id=\"e72cdc574faadf9014d3069586c9df5dc\">\n<code>delete_item</code>: safely remove records originally created via MCP across supported Scoro modules. It can only delete records created through MCP and cannot delete records created elsewhere in Scoro.</li></ul><h3 id=\"h_01KY52ME5K05SSA4VX79T8TAZ9\">Notifications and sent emails</h3><ul>\n<li data-list-item-id=\"ec54c26d035747a3a9aa8c104fca4ddfc\">\n<strong>Tools:</strong> <code>get_notifications</code>, <code>create_notification</code>, <code>mark_notification_as_read</code>, <code>mark_notification_as_unread</code>, <code>get_sent_emails</code>\n</li>\n<li data-list-item-id=\"e1ccee85b1610bf925a2c62fdcebd36f7\">\n<strong>Description:</strong> Generate and manage user notifications, and inspect logs of emails sent from Scoro.</li>\n</ul><h2 id=\"h_01M5MC1398GK2NXEB1S7YQMPDF\"><strong>ELI (Scoro's AI assistant) tools</strong></h2><ul>\n<li data-list-item-id=\"ed7da8f548d3f7b72c578f8286c7a7766\">\n<code>ask_agent</code>: ask ELI a question, or continue an earlier conversation.</li>\n<li data-list-item-id=\"ef8e551b1d43a35e3945ffe756b575bb5\">\n<code>get_agent_threads</code>: fetches your previous conversations with ELI, so you can continue one with its history. </li>\n</ul><p><strong>Key things to remember about ELI-related MCP tools</strong>:</p><ul>\n<li data-list-item-id=\"ee996ee2dc00a2b3f7a98e4866d201d40\">Using ELI-related MCP tools isn't always required – here's a good rule of thumb to follow:<ul>\n<li data-list-item-id=\"e8dbfb890a288d99edf2df3fd431aef58\">Use the specific Scoro MCP tools when your AI tool already knows exactly what to read or write. For example, if the task involves updating specific quote data, use the relevant quote-related MCP tools.</li>\n<li data-list-item-id=\"e861a59c282714ae62b231c3b3281eb8f\">Use the <code>ask_agent</code> tool when the task needs Scoro's own reasoning.</li>\n</ul>\n</li>\n<li data-list-item-id=\"e7bf6a5a0f08d76fbccfcaeca4abc3c58\">The ELI-related Scoro MCP tools consume both your AI tool's tokens (for the orchestration and delegation) and your site's ELI credits (for getting the requested job done). See the <strong>example below</strong> for a comparison of using the dedicated MCP tools versus the <code>ask_agent</code> tool.</li>\n</ul><zd-accordion class=\"wysiwyg-disclosure\"><details><summary>Example: Creating a task using the dedicated MCP tools VS the 'ask_agent' tool</summary><div class=\"wysiwyg-disclosure-content\">\n<p>To illustrate the difference in the workflow and the associated costs when using dedicated MCP tools or the <code>ask_agent</code> tool, let's say we are using Claude to create a new task in the \"Business Management Consulting\" project.</p>\n<p>If that task creation workflow uses the <strong>dedicated MCP tools:</strong></p>\n<ul>\n<li data-list-item-id=\"e54ef8706ee2051453cbc8a5596b35dd2\">Claude first uses the <code>get_projects</code> tool and tries to find the corresponding project.</li>\n<li data-list-item-id=\"e85ca1f014cc3462a83a92391c3c64dcf\">Next, it tries to create the task using the <code>create_task</code> tool and sees that the activity type field is mandatory, so it uses the <code>get_site_configuration</code> tool to fetch all available activity types, picking the most relevant one.</li>\n<li data-list-item-id=\"e353daf519cb92ccd0dde83bfc87ad023\">Then, it retries the <code>create_task</code> tool.</li>\n<li data-list-item-id=\"ea3a974d8f6263d57202edf3bc7bd7b41\">\n<strong>The resulting cost:</strong> While the tool calls are free, the orchestration, analysis, and reasoning consume Claude tokens: deciding which tools to use based on their descriptions, reading the data each tool returns, making decisions and, when something is missing, figuring out which other tool can provide it.</li>\n</ul>\n<p>If that task creation workflow uses the <code><strong>ask_agent</strong></code><strong> tool:</strong></p>\n<ul>\n<li data-list-item-id=\"e1e5c601c4105c3e912b7c6d6356fab59\">Claude makes a single tool call to the <code>ask_agent</code> tool and provides all the necessary information as input.</li>\n<li data-list-item-id=\"e8aa3e45cd4cc02e5cfee1d828617e117\">ELI then handles all the required steps in the background (finding the project, finding the activity type, and creating the task).</li>\n<li data-list-item-id=\"ed918a972348410a83027f370d8ba7cc8\">Claude gets one response back from ELI and composes the message to the user.</li>\n<li data-list-item-id=\"eb8f824fde995746114c0b8177974f8ec\">\n<strong>The resulting cost:</strong> Claude tokens are consumed only for putting together the request and reading the answer back. ELI credits are used for everything else – for the analysis, reasoning, etc.</li>\n</ul>\n</div></details></zd-accordion>"}}