{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_u5sm3qhttgrd","handle":"apple-instruments-mcp","url":"https://wellknown.network/agents/apple-instruments-mcp","links":{"self":"https://wellknown.network/agents/apple-instruments-mcp/record.json","html":"https://wellknown.network/agents/apple-instruments-mcp","markdown":"https://wellknown.network/agents/apple-instruments-mcp/record.md","api":"https://wellknown.network/api/v1/agents/apple-instruments-mcp","status":"https://wellknown.network/api/v1/agents/apple-instruments-mcp/status","claim":"https://wellknown.network/agents/apple-instruments-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/apple-instruments-mcp/claim.json","badge":"https://wellknown.network/agents/apple-instruments-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:apple-instruments-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"apple-instruments-mcp","summary":"MCP server for Apple platform profiling via xctrace/Instruments","description":"# apple-instruments-mcp\n\n`apple-instruments-mcp` is a Python MCP server for profiling Apple platform apps and processes with Instruments through `xcrun xctrace`. It lets MCP clients such as Claude Desktop record traces, inspect existing `.trace` bundles, and return concise performance reports with actionable recommendations.\n\nThe server can target iOS, iPadOS, macOS, tvOS, watchOS, visionOS, simulators, physical devices, and host processes when those targets are visible to the installed Xcode/Instruments toolchain. Actual template and device support is determined by `xcrun xctrace list devices` and `xcrun xctrace list templates` on your Mac.\n\n## Features\n\n- Record new traces with `xctrace` from an MCP client.\n- Analyze existing `.trace` bundles without recording again.\n- Report launch time, memory allocations, leaks, CPU hot spots, and network activity.\n- Launch apps by bundle ID or executable path.\n- Attach to running processes by process name or PID.\n- Record all processes when an Instruments template supports it.\n- List available devices, simulators, runtimes, and Instruments templates.\n- Return raw or JSON-structured device/template listings.\n- Preview the generated `xctrace` command with `dry_run`.\n- Keep `.trace` and XML artifacts for later inspection.\n- Return human-readable summaries with top offenders and suggested fixes.\n- Runs as a standard stdio MCP server.\n\n## Requirements\n\n- macOS\n- Xcode with Instruments installed\n- Xcode Command Line Tools: `xcode-select --install`\n- Python 3.11 or newer\n- A supported target visible to `xctrace`: booted simulator, connected device, local macOS app, running process, or all-processes recording.\n\nPhysical devices may require enabling UI automation in `Settings > Developer`.\n\n## Installation\n\nThe package is published on PyPI. The recommended way is to run it through [`uvx`](https://github.com/astral-sh/uv), which downloads and caches the server on demand without polluting your environment:\n\n```bash\nuvx apple-instruments…","publisher":null,"homepage":"https://github.com/dogo/apple-instruments-mcp","repository":"https://github.com/dogo/apple-instruments-mcp/blob/main/CHANGELOG.md","version":"1.2.1","license":"MIT","protocols":["mcp"],"tags":["instruments","ios","macos","mcp","model-context-protocol","performance","profiling","xctrace"],"pricing":null,"endpoints":[{"url":"pypi:apple-instruments-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.825,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"apple-instruments-mcp","registry":"pypi","observedAt":"2026-09-09T09:24:57.778Z","publishedAt":"2026-07-17T15:33:25.981352Z","latestVersion":"1.2.1"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"apple-instruments-mcp","url":"https://pypi.org/project/apple-instruments-mcp/","firstSeenAt":"2026-09-09T09:23:17.478Z","fetchedAt":"2026-09-09T09:23:17.478Z","normalizedAt":"2026-09-09T09:23:17.478Z"}]},"firstSeenAt":"2026-09-09T09:23:17.478Z","updatedAt":"2026-09-09T09:24:57.778Z"}