Skip to main content

Manage custom fields using Funnel MCP

Create, update, delete or copy custom fields from an AI client.

Ask your AI client to create a custom dimension, custom metric or formula metric in your Funnel workspace, or to update one you already have. Funnel MCP shows you a preview first and saves only the fields you choose. You can also delete a custom field, or copy custom fields from another workspace. This works in any client connected to Funnel MCP, such as Claude, ChatGPT, Claude Code or Cursor.

​

Supported field changes

Through Funnel MCP, you can:

​

  • Create custom dimensions, custom metrics and formula metrics.

  • Update existing custom fields.

  • Preview fields with sample values before anything is saved.

  • Save all the fields in a preview, or only the ones you choose.

  • Delete a custom field.

  • Copy up to 25 custom fields from another workspace in the same subscription.

​

Through Funnel MCP, you can't:

​

  • Delete more than one field at a time, or delete fields that aren't custom fields.

  • Create and update fields in the same preview. One preview covers 1 to 5 fields, and they're either all new fields or all updates.

​

To learn how custom dimensions work in Funnel, see Introduction to custom dimensions.

​

To create a metric manually in Funnel instead, see Create a custom metric.

​

Before you begin

  • You have an AI client connected to Funnel MCP. To connect one, see Quick start guide: Using Funnel MCP.

  • You have the Edit fields permission in the workspace. You need it even to prepare a preview. To copy fields, you need it in both workspaces. If you don't have it, ask a subscription owner for Editor access. For more about roles, see Workspace: User roles.

​

Create or update custom fields

  1. In your AI client, describe the field you want in plain language. For example: Create a custom dimension called Channel group that puts Facebook and Instagram under Social. or Create a formula metric for cost per conversion.

    ​

    The client looks up the fields in your workspace and reads Funnel's guide to the rules for custom fields. It then prepares a plan for the new or changed fields.

    ​

  2. Review the preview the client shows you. It lists each field Funnel MCP plans to create or update, with sample values. Nothing is saved yet.

    ​

    Note: The preview expires after 1 hour. If it expires, ask the client to prepare it again.

    ​

  3. Tell the client which fields from the preview to save. You can save all of them or only some.

    ​

  4. If your client asks for its own approval to run the tool, approve it.

    ​

    Note: If a field changed in Funnel after the preview, Funnel reports it as out of date and doesn't save it. Ask the client for a new preview of that field.

​

Delete a custom field

  1. In your AI client, ask to delete the field and name it. For example: Delete the Old channel group custom dimension.

    ​

    If the name matches more than one field, the client asks you which one.

    ​

  2. Review the change and the warning the client shows you. Funnel MCP can't check where the field is used. Other fields, dashboards, Data Explorer views, exports, Activate destinations and budgets that use the field stop working when you delete it.

    ​

  3. Approve the deletion in the conversation within 30 minutes. If your client asks for its own approval to run the tool, approve it.

    ​

    Note: If the field changed in Funnel after the client prepared the deletion, nothing is deleted. Ask the client to prepare it again.

​

The field is deleted for everyone in the workspace. Only Funnel support can bring it back.

​

Copy custom fields from another workspace

Copy custom fields from one workspace to another in the same subscription, for example to reuse a channel grouping across markets. You can copy fields only through Funnel MCP, not in Funnel AI.

​

  1. In your AI client, ask to copy the fields. Name the fields, the workspace to copy from and the workspace to copy to. For example: Copy the Channel group and Blended ROAS fields from the Acme EU workspace to the Acme US workspace.

    ​

  2. Review the check the client shows you. The client first runs the copy without saving anything and lists what it found, for example:

    • Fields that use something the workspace you copy to doesn't have, such as a connector. They return no data there.

    • Fields they use that are defined differently in the workspace you copy to.

    • Rules that match a data source the workspace you copy to doesn't have, so they never match.

    ​

  3. Confirm the copy in the conversation. Fields with findings are copied too.

​

The following limits apply:

​

  • You can copy up to 25 fields at a time.

  • By default, the client copies only the fields you name. If they use other custom fields that the workspace you copy to doesn't have, ask the client to include them. Funnel refuses the copy if that brings the total to more than 25 fields.

  • Funnel never overwrites existing fields. If a field you're copying already exists in the workspace you copy to, nothing is copied.

​

Custom field 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

search_fields

Read

Finds dimensions, measures and metrics in the loaded workspace.

list_guides

Read

Returns Funnel's guide to the rules for custom fields.

mutate_fields

Write (preview)

Prepares a plan to create or update custom fields and shows you a preview. It doesn't save anything.

apply_field_mutation

Write

Saves the fields you choose from the preview.

prepare_delete_field

Write (prepare)

Prepares deleting one custom field. It doesn't delete anything.

execute_field_change

Write

Deletes the field you approved.

copy_fields

Write

Checks and copies up to 25 custom fields from another workspace in the same subscription.

What to expect

The fields you chose to save appear with the other custom dimensions and metrics in your workspace, and the client gives you a link to each saved field in Funnel. Fields you didn't choose, and fields that Funnel reported as out of date, aren't saved. A deleted field disappears from the workspace and gets no link. Copied fields appear with the other custom fields in the workspace you copied them to.

Did this answer your question?