The Atlan MCP Cookbook

Profile a field's shape before you build on it

Get a quick profile of a field, its type, null rate, distinct count, and range, so you know what you're working with before you aggregate or join on it.

All recipes

On the menu

Use case
Find & understand data
Action
Look up
Persona
Data/BI Analyst, AI Builder, Data Engineer
Effort
Quick
Runs in
any AI tool

The task

Scenario. An analyst is about to aggregate on a field they've never used, an `amount` or `status` column, and needs a quick profile first: what type it really is, how many nulls, how many distinct values, and its range. Building on a field that's secretly 40% null, stored as text, or dominated by one value is how a report goes wrong before it starts.

The ask

  • The field's data type, null rate, distinct count, and range
  • Whether its real shape matches what you were about to assume
  • Anything about it that makes it risky to build on

Hero prompt

Hero prompt

Give me a quick profile of the `amount` field on `<table>`: its data type, null rate, how many distinct values, and its range, before I build on it.

Step by step

  1. Find the field.

    Step 1

    Find the <amount> field on <table> and confirm it's the one I mean.

  2. Quick-profile its shape.

    Step 2

    Profile it: data type, null count and rate, number of distinct values, and its min/max range.

  3. Flag anything that makes it risky to build on.

    Step 3

    Tell me if anything here would break a report: a high null rate, a text type where I expected a number, or one value dominating the field.

What you'll give it

Required context

  • The table and field
  • Read access to the connected source through Atlan, with query permission

Optional context

  • What you're about to build (a sum, an average, a join), so the profile can call out what specifically would break it
  • The type or range you expect, so it can flag the gap

What Atlan creates

Outputs

  • The field's real data type, null count and rate, distinct-value count, and min/max range
  • A plain read on whether it's safe to build on, with the specific risk called out

Summary. You know the shape of the field, not just its name, before you aggregate or join on it, so you don't discover a 40%-null column after the numbers look wrong.

Read-only

Read-only. This profiles the field; nothing in Atlan or the source is written.

Follow-up prompts

Keep going once the first answer lands.

Widen the check

Widen the check

Profile every field this report aggregates on, not just this one.

Compare over time

Compare over time

Compare this field's null rate to the last time I profiled it.

Find a better field

Find a better field

If the type isn't what I need, show me the closest field that is.

Tips & troubleshooting

Cook's note

A field's name tells you what it's called, not what it holds. A quick profile is five minutes; a wrong aggregate is a rebuilt report.

  • Match the client to the work.** Any client works; this is a fast lookup, not a multi-step reasoning job.
  • Automate or chain it.** Chain a profile across every field feeding a new dashboard before it ships, instead of profiling only the one that seems risky.
  • Recheck on recurring reports.** If a report runs on a schedule, the field underneath it can drift. Re-profile periodically instead of trusting the check from when you first built it.
THE ATLAN MCP COOKBOOK

Point your AI at the Atlan MCP.
Run your first recipe.

[Website env: production]