• VALID
  • ERROR
  • MISMATCH
  • HUMAN

How to audit infrastructure and blocks with your AI

Connect Prefect once. After that, your AI handles the heavy lifting of scanning your environment for configuration drift.

Ask AI about this page

Short answer

Can my AI audit my Prefect setup?

Yes. Your AI uses the Prefect MCP to pull lists of your blocks and work pools. It then checks these for credential errors or routing mismatches. You get a clear view of your infrastructure health.

Audit outcomes

Where your findings land.

The AI organizes its findings into these specific categories.

VALID

Healthy configurations

The AI confirms that your blocks and work pools are correctly set up. You get a clean report of everything working as intended.

ERROR

Credential failures

The AI flags blocks with invalid or expired cloud credentials. This helps you catch auth issues before a job fails.

MISMATCH

Routing issues

The AI identifies work pools that aren't routing jobs to the right places. It spots discrepancies in your job routing logic.

HUMAN

Manual fixes needed

The AI highlights specific blocks that require your direct intervention. It points you to exactly what needs a manual update.

The workflow

What your AI does when the audit starts.

The AI moves through your Prefect environment to gather the data it needs to analyze.

  1. Gather block data

    The AI pulls a full list of all your existing Prefect blocks to prepare for inspection.

    list_blocks

  2. Scan work pools

    The AI retrieves your work pool configurations to check how jobs are being distributed.

    list_work_pools

  3. Cross-reference settings

    The AI compares block credentials against work pool requirements to find mismatches.

    list_blockslist_work_pools

  4. Report findings

    The AI summarizes which configurations are safe and which ones will cause job failures.

    list_blocks

Try it

Copy these to start.

Use these prompts to trigger an audit immediately.

Starting points

These are basic prompts. You can add specific block names or pool IDs to make them more precise.

Prefect Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_a5qLESf6WFH2IZLBM0AJkFtNNbD6lsAcNp4Q1Iqv/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Prefect capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "prefect-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_a5qLESf6WFH2IZLBM0AJkFtNNbD6lsAcNp4Q1Iqv/mcp"
    }
  }
}
Copy into chat04

  • List all my Prefect blocks and tell me if any look misconfigured.

  • Check my work pools to see if the job routing is set up correctly.

  • Audit my blocks for any expired or invalid cloud credentials.

  • Compare my work pools against my blocks to find routing mismatches.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Prefect once, then ask.

Just link your account once. Your credentials stay encrypted, and you can start auditing through your preferred AI client immediately.

Connect Prefect to your AI

FAQ

How the audit behaves

  • 01

    Can the AI change my block settings?

    No. The AI can only read your blocks and work pools. You must make any configuration changes manually in Prefect.

  • 02

    Can the AI delete a work pool?

    No. This MCP only provides read access to list and inspect your infrastructure.

  • 03

    How does the AI know if a credential is bad?

    The AI inspects the configuration data within the blocks to identify obvious errors or missing fields.

  • 04

    Does this work with any AI client?

    Yes, it works with any MCP-compatible client like Claude, Cursor, or Windsurf.

  • 05

    Can I audit specific blocks only?

    Yes. You can ask the AI to look at a specific block name instead of the whole list.

  • More questions about Prefect? The Connector page answers them. See everything the Prefect Connector can do

Connect Prefect to Claude, Cursor, ChatGPT & more