Last updated: September 3, 2025
Available with any of the following subscriptions, except where noted:
After connecting your Breeze agents to an MCP Server using HubSpot MCP Client, you must add clear prompt instructions to guide your Breeze agent on which MCP tools to use and when. The prompts should be customized based on your specific use case, setup, and goals.
Add MCP prompts to Breeze agents
- In your HubSpot account, navigate to Breeze > Breeze Studio.
- On the Agents tab, click the name of the agent you want to add MCP prompts to.
- In the top right, click Configure agent.
- In the Guide how this agent behaves section, click Add extra instructions.
- In the Extra instructions text field, enter your MCP prompts.
Best practices for adding MCP prompts to Breeze agents
Use the following examples as a guide for adding MCP prompts to a Breeze agent connected to a Notion MCP Server. While these best practices offer a general framework, you can customize them for your specific use case and for other MCP Servers.
Identify the database
Since Notion pages and databases don't follow a fixed structure, you need to instruct the agent exactly on which database to use. It’s recommended that you mention the name of the database, its purpose, and include the database ID if you have it.
Example prompt:
Use the Notion database titled 'Content Projects Tracker,' which includes the project name, status, owner, and due date.
Describe the property or column structure
Describe your database structure to help the Breeze agent understand the data. It’s also recommended that you list the relevant column names, what they contain, and their property type.
Example prompt:
The database includes these columns: 'Project Name' (title), 'Owner' (person), 'Status' (select), and 'Deadline' (date).
If some fields are optional or not consistently used, it's helpful to mention that as well.
Define the agent’s task
Be clear about the specific information the agent should find or extract.
Example prompts:
-
Find all items where the Status is 'In Progress' and the Deadline is within the next 7 days.
-
Summarize all entries that have 'Product Launch' in the title.
Specify actions and tools
If your agent needs to perform a specific action, such as query_database, list_databases, or retrieve_page, it’s helpful to explicitly state which tools it should use and how. This is especially useful if the agent has to choose between multiple tools.
Provide an example input and output
If your agent needs to add or edit entries, it’s recommended that you include an example of what the data should look like.
Example prompt:
When creating a new entry, fill in 'Status' as 'Not Started' by default and leave 'Deadline' blank.
Example of a full MCP prompt for Breeze agents
You are connected to the Notion MCP server. Use the database titled 'Feature Rollouts Tracker'. It includes the following columns: 'Feature Name' (title), 'Status' (select: Not Started, In Progress, Done), 'PM Owner' (person), and 'Target Release Date' (date). Your job is to find all features that are marked 'In Progress' and return their names along with the PM Owner. Use the query_database tool and only pull results from this database.
