For AI assistants

Use this data with your AI assistant

Designing or troubleshooting an Apple device policy with an AI model? Point it at this site and it can look up the real payload types, keys, and per-OS version support instead of guessing — so the profiles it generates actually work.

174 Apple MDM & DDM payloads, mirrored hourly from Apple’s official device-management repository · iOS · macOS · tvOS · watchOS · visionOS

Install a ready-made agent

Want the best results with no prompt engineering? We publish a pre-built agent that already knows the API, the data model, and how to author and validate profiles. Download it for your tool:

Claude Code

apple-device-policy.md
Download into place
mkdir -p .claude/agents
curl -o .claude/agents/apple-device-policy.md \
  https://appledevicepolicy.tools/agents/apple-device-policy.md
Then just describe your task — Claude Code auto-selects it from its description. Manage with /agents. Use ~/.claude/agents/ to enable it in every project.

GitHub Copilot CLI

apple-device-policy.agent.md
Download into place
mkdir -p ~/.copilot/agents
curl -o ~/.copilot/agents/apple-device-policy.agent.md \
  https://appledevicepolicy.tools/agents/apple-device-policy.agent.md
Run copilot --agent apple-device-policy --prompt "…", or type /agent in interactive mode to pick it. Drop it in a repo’s .github/agents/ to share with your team.

Copilot in VS Code

apple-device-policy.agent.md
Download into place
mkdir -p .github/agents
curl -o .github/agents/apple-device-policy.agent.md \
  https://appledevicepolicy.tools/agents/apple-device-policy.agent.md
Reload the window, open Copilot Chat, and pick Apple Device Policy from the agent picker (or @-mention it). Needs a recent VS Code + Copilot with custom-agent support.

Same agent, two formats: .md for Claude Code, .agent.md for GitHub Copilot. Both just call the public API below — nothing to install server-side.

or use it with any assistant
1

Give your assistant this link

This single file tells the model what data exists and how to query it. Most models with web access will take it from here.

Paste this URL
https://appledevicepolicy.tools/llms.txt
Your model needs the ability to browse / fetch URLs (e.g. Claude with web, ChatGPT with browsing, Cursor, GitHub Copilot). A fully offline chat can’t reach it.
2

Or paste this prompt to be explicit

Copy this, replace the last line with what you’re trying to do, and send it.

Prompt
Fetch https://appledevicepolicy.tools/llms.txt and follow it. It documents a read-only API over Apple's MDM and Declarative Device Management (DDM) policy definitions. Use GET /api/search to find relevant payloads, then GET /api/policy/{payloadType} for the full key list and per-OS version support. Only use payloads and keys that appear in that data — do not guess. Then help me with:

<describe your task here>
3

Try it with a real task

Swap any of these in for the last line of the prompt:

Find the right key

I want to stop macOS devices joining Wi-Fi networks that weren’t installed by a profile. Which payload and key controls that, and from which OS version?

See what’s new

What new Declarative Device Management settings shipped in the latest OS release? Draft a starter declaration for one of them.

Design a profile

Build a passcode policy profile for supervised iPads, using the real keys and their default values.

Check availability

Is the "block screenshots" restriction available on visionOS, and if so since which version?

How it works

  1. 1.The model reads /llms.txt to learn the dataset, how fresh it is, and the available endpoints.
  2. 2.It searches with /api/search to find relevant payloads (filter by platform, category, or what’s new/deprecated).
  3. 3.It drills down with /api/policy/{payloadType} to get every key, its type, default, and exactly which OS versions support it.

Building a tool or custom agent?

The API is documented for programmatic use. Load the OpenAPI spec into your agent framework and it gets searchPolicies and getPolicy tools directly.

Search (compact, filtered)
curl "https://appledevicepolicy.tools/api/search?q=wifi&os=macOS&category=mdm&limit=5"
Full detail for one payload
curl "https://appledevicepolicy.tools/api/policy/com.apple.mobiledevice.passwordpolicy?branch=release"

Search parameters: q, os (iOS/macOS/tvOS/watchOS/visionOS), category (mdm/ddm), status (new/deprecated), branch, limit, offset.

Prefer to browse it yourself?
Explore the same data in the human UI.
Open Policy Explorer