{
 "kind": "api",
 "slug": "prefect",
 "path": "apis/prefect/",
 "name": "Prefect Cloud",
 "maker": "Prefect",
 "density": "full",
 "crumbs": [
  [
   "APIs",
   "apis/"
  ],
  [
   "Integrations and automation",
   "apis/automation/"
  ]
 ],
 "lead": "Run and watch scheduled Python jobs.",
 "chips": [
  {
   "label": "Integrations and automation",
   "path": "apis/automation/"
  }
 ],
 "primary": {
  "label": "Copy prompt for your agent",
  "copy": "Turn my Python data script into a Prefect flow with prefect pinned to 3.9.2: @task on each step with retries for outside calls, @flow on the entry point, test it locally with prefect server start, then deploy it with a cron schedule; read PREFECT_API_URL and PREFECT_API_KEY from the environment."
 },
 "links": [
  {
   "label": "Website",
   "href": "https://www.prefect.io"
  },
  {
   "label": "Pricing",
   "href": "https://www.prefect.io/pricing"
  },
  {
   "label": "GitHub",
   "href": "https://github.com/PrefectHQ/prefect"
  }
 ],
 "track": "Outages, price changes and new versions on your dashboard",
 "verdicts": [
  {
   "key": "price",
   "label": "Price",
   "value": "Free credits",
   "status": "cond",
   "sub": "One-time or needs a card",
   "quote": null,
   "note": "Free tier: Hobby plan: 2 users, 5 deployments, 500 min serverless, 7 days retention. As reported on the official pricing page, checked Oct 13, 2026.",
   "src": "https://www.prefect.io/pricing"
  },
  {
   "key": "commercial",
   "label": "Commercial use",
   "value": "Allowed",
   "status": "yes",
   "sub": null,
   "quote": "Apache License Version 2.0, January 2004",
   "note": "The library and server are Apache 2.0; Prefect Cloud is used under its terms on your own account.",
   "src": "https://github.com/PrefectHQ/prefect/blob/main/LICENSE"
  },
  {
   "key": "key",
   "label": "Key & sign-up",
   "value": "API key, server only",
   "status": "info",
   "sub": "Env var PREFECT_API_KEY (with PREFECT_API_URL)",
   "quote": "API keys enable you to authenticate a local environment to work with Prefect Cloud.",
   "note": "API key per user (or service account on higher plans), saved to the local Prefect profile by prefect cloud login, or set as an environment variable with the workspace API URL",
   "src": "https://www.prefect.io/docs/v3/how-to-guides/cloud/manage-users/api-keys.md"
  },
  {
   "key": "agent",
   "label": "Agent access",
   "value": "Docs for agents",
   "status": "info",
   "sub": "llms.txt · OpenAPI · SDK",
   "quote": "The Prefect MCP server provides read-only access to your Prefect instance.",
   "note": " Our agent check: 4 of 6 (Nov 13, 2026).",
   "src": "https://www.prefect.io/docs/v3/how-to-guides/ai/use-prefect-mcp-server.md"
  }
 ],
 "vfoot": "Checked against the maker's official pages, pricing on Oct 13, 2026.",
 "blocks": [
  {
   "id": "overview",
   "nav": "Overview",
   "h2": "What Prefect Cloud does",
   "parts": [
    {
     "t": "prose",
     "text": "Prefect is a free, open-source Python library that turns ordinary Python functions into jobs that run on a schedule, retry when they fail and keep a history of every run. Prefect Cloud is the hosted dashboard that schedules and watches those jobs; you can also run Prefect's own server yourself. It suits data jobs, such as copying and cleaning data every night."
    },
    {
     "t": "list",
     "items": [
      "Prefect Cloud is one of 17 APIs in the Integrations and automation category on AgentGid.",
      "Its cheapest paid plan ($100 a month) is the 13th cheapest of the 15 here with a monthly plan.",
      "It is one of 16 that can be started for free.",
      "6 of them ship an official MCP server; Prefect Cloud does not.",
      "Its official SDK is the 3rd most downloaded in the category (2.4M a week)."
     ],
     "muted": true
    },
    {
     "t": "h3",
     "text": "What people build with it"
    },
    {
     "t": "uses",
     "items": [
      {
       "title": "Nightly data copy and cleanup",
       "text": "Pull data from an outside service every night, clean it and load it into your database, with each run logged and visible.",
       "idea": false
      },
      {
       "title": "Process many records at once",
       "text": "Run the same step for each customer, file or order in parallel, and see which ones succeeded.",
       "idea": false
      },
      {
       "title": "Retry calls to a flaky service",
       "text": "When an outside service fails now and then, retry only that step a few times with a pause, instead of rerunning the whole job.",
       "idea": false
      },
      {
       "title": "Slow work behind a web form",
       "text": "Hand long jobs from your web app, such as processing an upload or sending emails, to background workers and show their status.",
       "idea": false
      },
      {
       "title": "Wait for a person's approval",
       "text": "Stop a job until someone checks the result and approves it, then carry on.",
       "idea": false
      },
      {
       "title": "Weekly report to your team",
       "text": "Build a summary of last week's sign-ups or sales every Monday and post it to your team chat.",
       "idea": true
      }
     ]
    }
   ]
  },
  {
   "id": "popularity",
   "nav": "Popularity",
   "h2": "Prefect Cloud popularity",
   "parts": [
    {
     "t": "stats",
     "items": [
      {
       "n": "2.3M",
       "l": "SDK downloads a week",
       "d": "+10.5% on the 4-week average",
       "up": true
      },
      {
       "n": "18",
       "l": "public agent repos use its SDK"
      },
      {
       "n": "24.2K",
       "l": "GitHub stars, PrefectHQ/prefect"
      }
     ]
    },
    {
     "t": "small",
     "text": "SDK downloads from npm and PyPI, weekly. Numbers as of Nov 17, 2026."
    }
   ]
  },
  {
   "id": "pricing",
   "nav": "Pricing and limits",
   "h2": "Pricing",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Free tier",
       "v": "Hobby plan: 2 users, 5 deployments, 500 min serverless, 7 days retention"
      },
      {
       "l": "Cheapest plan",
       "v": "$100 a month"
      },
      {
       "l": "Usage price",
       "v": "—"
      },
      {
       "l": "Plans",
       "v": "Added automatically: its SDK was in 8 of the public agent repos we sampled when it was added. Prices read from the official pricing page."
      }
     ]
    },
    {
     "t": "h3",
     "text": "What one action costs"
    },
    {
     "t": "table",
     "head": [
      "Action",
      "Price"
     ],
     "num": true,
     "rows": [
      [
       "Starter plan, per month (3 users, 20 deployments, 75 hours of managed compute)",
       "$100"
      ],
      [
       "Team plan, per user per month (4 to 8 users)",
       "$100"
      ]
     ]
    },
    {
     "t": "more",
     "items": [
      {
       "title": "Price history",
       "items": [
        "A year of the pricing page in the Internet Archive (1 months): the lowest monthly figure went from $100 (2025-11) to $100 (2025-11).",
        "2025-12: free plan shown"
       ]
      }
     ]
    },
    {
     "t": "small",
     "text": "As reported on the official pricing page, checked Oct 13, 2026. Prices change: confirm before you buy.",
     "link": "prefect.io/pricing",
     "href": "https://www.prefect.io/pricing"
    }
   ]
  },
  {
   "id": "limits",
   "nav": null,
   "spy_as": "pricing",
   "h2": "Limits",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Hobby (free)",
       "v": "2 users, 5 deployments, 500 minutes of Prefect Serverless a month, 7-day run history",
       "src": "https://www.prefect.io/pricing"
      },
      {
       "l": "Hobby / Starter / Team",
       "v": "625 / 1,250 / 2,500 API requests and 2,000 / 2,800 / 8,000 logs and events per minute",
       "src": "https://www.prefect.io/docs/v3/concepts/rate-limits.md"
      },
      {
       "l": "All Prefect Cloud plans",
       "v": "5 MiB per request body",
       "src": "https://www.prefect.io/docs/v3/concepts/rate-limits.md"
      },
      {
       "l": "Prefect Managed runs",
       "v": "4 vCPUs, 16 GB RAM, 128 GB disk, 24 hours per run, monthly compute limit per workspace",
       "src": "https://www.prefect.io/docs/v3/how-to-guides/deployment_infra/managed.md"
      }
     ]
    },
    {
     "t": "small",
     "text": "From the official docs.",
     "link": "prefect.io/pricing",
     "href": "https://www.prefect.io/pricing"
    }
   ]
  },
  {
   "id": "access",
   "nav": "Access and terms",
   "h2": "Key and access",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "How it signs in",
       "v": "API key per user (or service account on higher plans), saved to the local Prefect profile by prefect cloud login, or set as an environment variable with the workspace API URL"
      },
      {
       "l": "Environment variable",
       "v": "PREFECT_API_KEY (with PREFECT_API_URL)",
       "code": true
      },
      {
       "l": "Safe in browser code",
       "v": "No, keep it on your server",
       "status": "no"
      },
      {
       "l": "Card at sign-up",
       "v": "Not stated on the pages we read"
      }
     ]
    },
    {
     "t": "h3",
     "text": "Steps only a person can do"
    },
    {
     "t": "list",
     "items": [
      "Create a Prefect Cloud account (free Hobby plan) and a workspace. Ask the person to run prefect cloud login themselves, or to create an API key for CI.",
      "Create an API key with an expiry date and copy it once. Read PREFECT_API_KEY and PREFECT_API_URL from the environment or CI secrets; never commit them.",
      "Approve the Prefect connector or plugin if the person wants an AI assistant to read runs. Use its read-only tools; ask before running prefect commands that delete or change deployments."
     ]
    }
   ]
  },
  {
   "id": "terms",
   "nav": null,
   "spy_as": "access",
   "h2": "Commercial use and your data",
   "parts": [
    {
     "t": "prose",
     "text": "The Prefect library and server are open source under Apache 2.0, free for paid products. Prefect Cloud is a hosted service under Prefect's terms, and you keep the rights to your data."
    },
    {
     "t": "rows",
     "rows": [
      {
       "l": "In a paid app",
       "v": "Yes",
       "status": "yes",
       "sub": "The library and server are Apache 2.0; Prefect Cloud is used under its terms on your own account.",
       "quote": "Apache License Version 2.0, January 2004",
       "src": "https://github.com/PrefectHQ/prefect/blob/main/LICENSE"
      },
      {
       "l": "redistribute-files",
       "v": "With conditions",
       "status": "cond",
       "sub": "You may ship Prefect's code under Apache 2.0, keeping the license and notices.",
       "quote": "You must give any other recipients of the Work or Derivative Works a copy of this License",
       "src": "https://github.com/PrefectHQ/prefect/blob/main/LICENSE"
      },
      {
       "l": "Trains on what you send",
       "v": "“Prefect will not, except with Client's prior written consent: (i) train any AI model using Client Data”",
       "quote": null,
       "src": "https://www.prefect.io/legal/terms"
      },
      {
       "l": "Keeps your data",
       "v": "“Prefect Cloud retains flow run, task run, and artifact metadata for a limited time based on your plan.”",
       "quote": null,
       "src": "https://www.prefect.io/docs/v3/concepts/rate-limits.md"
      }
     ]
    }
   ]
  },
  {
   "id": "errors",
   "nav": null,
   "spy_as": "access",
   "h2": "Errors to handle",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "429",
       "v": "Your account sent more requests, logs or events per minute than its plan allows.",
       "sub": "The Python package retries up to 5 times using Retry-After; log less, batch work into fewer runs, or upgrade."
      },
      {
       "l": "413 Content Too Large",
       "v": "One request was bigger than 5 MiB, for example a large artifact or a big batch of logs.",
       "sub": "Store large data elsewhere and pass a link, split artifacts, or lower PREFECT_LOGGING_TO_API_BATCH_SIZE."
      },
      {
       "l": "422",
       "v": "Your prefect package is newer than the self-hosted Prefect server it talks to.",
       "sub": "Use the same prefect version on the client and the server."
      },
      {
       "l": "Crashed",
       "v": "The run stopped because of the machine it ran on, such as running out of memory, a timeout or a killed process.",
       "sub": "Check the worker and infrastructure logs, give the run more memory or time, then rerun it."
      },
      {
       "l": "TimedOut",
       "v": "The run took longer than its time limit.",
       "sub": "Raise the timeout, split the work into smaller tasks, or make the slow step faster."
      }
     ]
    }
   ]
  },
  {
   "id": "agent",
   "nav": "For agents",
   "h2": "Use it from an agent",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Our agent check",
       "v": "4 of 6: llms.txt yes, OpenAPI yes, SDK yes, MCP no, status page no, AI assistants allowed yes",
       "sub": "Checked Nov 13, 2026."
      },
      {
       "l": "MCP server",
       "v": "Prefect MCP server (beta, read-only; also a hosted Claude connector)",
       "sub": "claude mcp add prefect -- uvx --from prefect-mcp prefect-mcp-server"
      },
      {
       "l": "PyPI",
       "v": "pip install prefect",
       "code": true
      }
     ]
    },
    {
     "t": "h3",
     "text": "Instructions in its docs to check first"
    },
    {
     "t": "rows",
     "rows": [
      {
       "l": "The docs say",
       "v": "“curl -LsSf https://astral.sh/uv/install.sh | sh”",
       "sub": "Ask the person first. It downloads and runs an installer script for uv on their machine."
      },
      {
       "l": "The docs say",
       "v": "“Run the following commands in your terminal, after which you'll be prompted in your browser to create or login to your free Prefect Cloud account.”",
       "sub": "Account creation and sign-in are the person's steps; do not run uvx prefect-cloud login for them without asking."
      },
      {
       "l": "The docs say",
       "v": "“/plugin marketplace add prefecthq/prefect-mcp-server”",
       "sub": "Ask the person first. It adds a plugin and a connection to their Prefect Cloud workspaces."
      }
     ]
    }
   ]
  },
  {
   "id": "alternatives",
   "nav": "Alternatives",
   "h2": "Alternatives",
   "parts": [
    {
     "t": "alts",
     "items": [
      {
       "name": "Prefect Cloud",
       "me": true,
       "facts": [
        "Free plan",
        "Free tier"
       ]
      },
      {
       "name": "Temporal Cloud",
       "why": "Pick Temporal Cloud for long business processes, such as orders, that must resume exactly where they stopped, in several languages; listed at $0.05 per 1,000 in our catalog on 2026-11-10.",
       "path": "apis/temporal/",
       "facts": [
        "$0.05 / 1k requests",
        "Free tier"
       ]
      },
      {
       "name": "Inngest",
       "why": "Pick Inngest for background jobs triggered by events in a JavaScript or Python web app, with a free plan of 50,000 executions a month.",
       "path": "apis/inngest/",
       "facts": [
        "$0.05 / 1k requests",
        "Free tier"
       ]
      },
      {
       "name": "Trigger.dev",
       "why": "Pick Trigger.dev when you write TypeScript and want the platform to run long tasks for you, listed at $0.025 per 1,000 in our catalog on 2026-11-10.",
       "path": "apis/trigger-dev/",
       "facts": [
        "$0.025 / 1k requests",
        "Free tier"
       ]
      }
     ],
     "more": "All integrations and automation APIs",
     "more_path": "apis/automation/"
    }
   ]
  },
  {
   "id": "start",
   "nav": "Get started",
   "h2": "Get started",
   "parts": [
    {
     "t": "prompt",
     "text": "Turn my Python data script into a Prefect flow with prefect pinned to 3.9.2: @task on each step with retries for outside calls, @flow on the entry point, test it locally with prefect server start, then deploy it with a cron schedule; read PREFECT_API_URL and PREFECT_API_KEY from the environment."
    },
    {
     "t": "steps",
     "items": [
      {
       "text": "Install Prefect in a virtual environment (Python 3.11 or newer).",
       "code": "pip install -U prefect",
       "src": "https://github.com/PrefectHQ/prefect/blob/main/README.md"
      },
      {
       "text": "Log in to Prefect Cloud from the terminal through the browser, or paste an API key.",
       "code": "prefect cloud login",
       "src": "https://www.prefect.io/docs/v3/how-to-guides/cloud/connect-to-cloud.md"
      },
      {
       "text": "Or skip the account and start a local Prefect server with its dashboard at localhost:4200.",
       "code": "prefect server start",
       "src": "https://www.prefect.io/docs/v3/get-started/quickstart.md"
      }
     ]
    },
    {
     "t": "h3",
     "text": "First request"
    },
    {
     "t": "tabs",
     "label": "First request",
     "items": [
      {
       "tab": "Request",
       "code": "from prefect import flow, task\nimport random\n@task\ndef get_customer_ids() -> list[str]:\n    return [f\"customer{n}\" for n in random.choices(range(100), k=10)]\n@task\ndef process_customer(customer_id: str) -> str:\n    return f\"Processed {customer_id}\"\n@flow\ndef main() -> list[str]:\n    customer_ids = get_customer_ids()\n    results = process_customer.map(customer_ids)\n    return results\nif __name__ == \"__main__\":\n    main()",
       "intro": "01_getting_started.py from the quickstart (comments and blank lines removed), run after uvx prefect-cloud login, so runs show in Prefect Cloud. Prefect is a Python library; Prefect Cloud's REST API is called by the library, not by hand."
      },
      {
       "tab": "Response",
       "code": "00:30:53.633 | INFO    | Flow run 'airborne-ringtail' - Beginning flow run 'airborne-ringtail' for flow 'main'\n00:30:53.638 | INFO    | Flow run 'airborne-ringtail' - View at https://app.prefect.cloud/account/...\n00:30:53.685 | INFO    | Task run 'get_customer_ids-136' - Finished in state Completed()\n00:30:54.512 | INFO    | Task run 'process_customer-d9b' - Finished in state Completed()\n...\n00:30:54.527 | INFO    | Flow run 'airborne-ringtail' - Finished in state Completed('All states completed.')"
      }
     ]
    },
    {
     "t": "h3",
     "text": "Mistakes to avoid"
    },
    {
     "t": "mistakes",
     "items": [
      {
       "dont": "Running flows with no server set up and relying on the temporary server Prefect starts on its own.",
       "fix": "Run prefect server start (or log in to Prefect Cloud) and keep it running while you work.",
       "why": "In our run with prefect 3.9.2 the temporary server stopped when the script ended and printed database errors on the way out, and its history was gone."
      },
      {
       "dont": "Running prefect cloud login in CI or a container without flags.",
       "fix": "Pass both --key and --workspace, or set PREFECT_API_KEY and PREFECT_API_URL.",
       "why": "The interactive prompts are not available there and the command fails."
      },
      {
       "dont": "Logging every row or item of a big job.",
       "fix": "Log summaries, lower the log level, or batch work into fewer runs.",
       "why": "Each log line counts against the per-minute limit and can trigger 429 answers."
      },
      {
       "dont": "Upgrading prefect in the app but not on the self-hosted server.",
       "fix": "Keep the same prefect version on both.",
       "why": "New clients can send fields old servers do not know, which ends in 422 errors."
      },
      {
       "dont": "Leaving usage telemetry on for a client project by default.",
       "fix": "Set PREFECT_SERVER_ANALYTICS_ENABLED=false or DO_NOT_TRACK=1 when the person wants nothing sent.",
       "why": "Prefect sends anonymous milestone events and server heartbeats unless turned off."
      }
     ]
    }
   ]
  },
  {
   "id": "faq",
   "nav": "Questions",
   "h2": "Questions",
   "parts": [
    {
     "t": "faq",
     "items": [
      {
       "q": "Is Prefect free?",
       "a": "The library and the self-hosted server are free and open source. Prefect Cloud has a free Hobby plan; Starter costs $100 a month.",
       "evidence": {
        "url": "https://www.prefect.io/pricing",
        "quote": "Starter $100 /mo Bring your own compute."
       }
      },
      {
       "q": "Do I need my own server?",
       "a": "Not to start. Prefect Managed work pools run flows on Prefect's machines with no worker or cloud account; the free plan includes 500 minutes a month.",
       "evidence": {
        "url": "https://www.prefect.io/docs/v3/how-to-guides/deployment_infra/managed.md",
        "quote": "Flows that run with this work pool do not require a worker or cloud provider account—Prefect handles the infrastructure and code execution for you."
       }
      },
      {
       "q": "How long is run history kept?",
       "a": "7 days on Hobby and Starter, 14 days on Team, 30 days on Pro, custom on Enterprise.",
       "evidence": {
        "url": "https://www.prefect.io/docs/v3/concepts/rate-limits.md",
        "quote": "Team: 14 days"
       }
      },
      {
       "q": "Does Prefect train AI models on my data?",
       "a": "No, not without your written consent, according to its terms.",
       "evidence": {
        "url": "https://www.prefect.io/legal/terms",
        "quote": "Prefect will not, except with Client's prior written consent"
       }
      },
      {
       "q": "Can my AI assistant look at my runs?",
       "a": "Yes, through the Prefect MCP server, which is read-only and still in beta.",
       "evidence": {
        "url": "https://www.prefect.io/docs/v3/how-to-guides/ai/use-prefect-mcp-server.md",
        "quote": "The Prefect MCP server is currently in beta."
       }
      }
     ]
    }
   ]
  }
 ],
 "glance": [
  [
   "Maker",
   "Prefect"
  ],
  [
   "Category",
   "Integrations and automation"
  ],
  [
   "Price",
   "Free plan"
  ],
  [
   "Plans from",
   "$100/mo"
  ],
  [
   "Official SDK",
   "PyPI prefect"
  ],
  [
   "Latest SDK",
   "3.9.2 on npm"
  ],
  [
   "Agent check",
   "4 of 6"
  ],
  [
   "Pricing checked",
   "Oct 13, 2026"
  ]
 ],
 "good": [
  "Prefect Cloud mostly does not run your code. Your own machine, server or worker runs it, unless you use Prefect's paid-for managed compute.",
  "The free Hobby plan keeps run history for 7 days and allows 5 deployments and 2 users.",
  "Every log line counts toward a per-minute limit on Prefect Cloud, so very chatty jobs can be slowed down."
 ],
 "checked_line": "Read by AgentGid from 24 official pages, card checked Nov 10, 2026; usage numbers update daily."
}