Ask your AI client about the budgets in your Funnel workspace. You can also create, rename, archive and restore budgets and change a budget's amounts, targets and dates. Each change runs only after you approve it. This works in any client connected to Funnel MCP, such as Claude, ChatGPT, Claude Code or Cursor.
What you can do
Through Funnel MCP, you can:
List active and archived budgets, and read the details of one budget, including its periods, targets and the amount for each period.
Create a budget with a spend target and up to five other targets, such as Clicks or CPC. Its periods can be weekly, monthly or quarterly, or one period can cover the whole date range.
Change a budget's spend, targets and start and end dates.
Rename a budget or change its description.
Archive a budget.
Restore an archived budget.
Through Funnel MCP, you can't:
Create a budget that has a breakdown (such as by country), rollover, pacing or a daily or custom cadence.
Change the amounts, targets or dates of a budget that has a breakdown or rollover.
Change the dates of a budget that has a daily or custom cadence.
Rename a budget that has rollover.
Do these things in Funnel instead. Read how to create a budget.
Funnel MCP never changes a budget without your approval. The client first prepares the change and shows you what will change. The change runs once, and only after you approve it in the conversation. Your client may also ask for its own approval before it runs the change. A prepared change expires after 30 minutes. If it expires, ask the client to prepare it again.
Before you begin
You have an AI client connected to Funnel MCP. To connect one, see Quick start guide: Using Funnel MCP.
To create, change, archive or restore a budget, you have the Edit budgets, Edit fields and Edit data sources permissions in the workspace. If your role doesn't include them, Funnel MCP tells you, and you can ask a subscription owner for access. For more about roles, see Workspace: User roles.
Ask about your budgets
Ask the client which budgets the workspace has, or ask about one budget to see its details. For example:
Which budgets do we have in this workspace?Show me the archived budgets.Show me the details of the Marketing budget 2026 budget.
You can also ask to see a budget's pacing as an interactive view, for example Show me how the Paid Social budget is pacing.
Create a budget
You can give one spend amount for every period, or a separate amount for each period. A budget can have up to 53 periods. Each target must be a metric, not a dimension. The currency must be one of the workspace's currencies.
In your AI client, describe the budget: its name, dates, cadence, spend and any other targets. For example:
Create a monthly budget for Q1 2027 with 10,000 USD spend per month and a Clicks target of 5,000 per month.
Review the budget the client shows you, including each period and its targets. Nothing changes yet.
Approve the change in the conversation. If your client asks for its own approval to run the tool, approve that too.
Change a budget's amounts, targets or dates
If you change the start or end date, Funnel rebuilds the periods. Give amounts for every target in any new period. You can remove any target except the spend target.
In your AI client, ask for the change. For example:
Raise December's spend in the Paid Social budget to 3,000.orAdd a CPC target of 1.50 to the Paid Social budget.
Review the change the client shows you, including each changed period before and after the change.
Approve the change in the conversation. If your client asks for its own approval to run the tool, approve that too.
Rename a budget or change its description
In your AI client, ask for the change in plain language. For example:
Rename the Marketing budget 2026 budget to Paid media 2026.
Review the change the client shows you. Nothing changes yet.
Approve the change in the conversation. If your client asks for its own approval to run the tool, approve that too.
Archive a budget
In your AI client, ask the client to archive the budget. For example:
Archive the Q1 paid social budget.
Review the change the client shows you.
Note: Archiving a budget also deletes the budget's data source until you restore the budget.
Approve the change in the conversation. If your client asks for its own approval to run the tool, approve that too.
Restore an archived budget
In your AI client, ask the client to restore the budget. For example:
Restore the archived Q1 paid social budget.
If you're not sure of the budget's name, ask the client to list your archived budgets first.
Review the change the client shows you.
Approve the change in the conversation. If your client asks for its own approval to run the tool, approve that too.
Budget tools available in Funnel MCP
Your AI client selects these tools for you. You don't need to name them in your request.
Tool | Type | Description |
| Read | List active or archived budgets, or return the details of one budget. |
| Write (prepare) | Prepares a new budget with its periods and targets. |
| Write (prepare) | Prepares a change to a budget's spend, targets or dates. |
| Write (prepare) | Prepares a change to a budget's name or description. |
| Write (prepare) | Prepares archiving a budget. Archiving also deletes the budget's data source until you restore the budget. |
| Write (prepare) | Prepares restoring an archived budget. |
| Write | Makes the budget change you approved. |
What to expect
After you approve a change, Funnel makes it once, and the client gives you a link to the budget in Funnel. An archived budget gets no link. A new or changed budget shows its periods and targets in Funnel. A renamed budget shows its new name and description in Funnel. An archived budget moves to your archived budgets, and its data source stays deleted until you restore the budget. A restored budget moves back to your active budgets.
