Servers Playground How we check Add a server Log in

Axint

Working · 2.4 s

io.github.agenticempire/axintv0.6.0

Proof and repair for Apple coding agents: validate Swift, run Xcode evidence, and repair failures.

Developer Tools

Source Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.axint.ai/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

axint.activate Read-only

Run a source-free compiler smoke test through the real Axint pipeline. Use immediately after installing or connecting Axint so the current agent proves it did more than start the MCP server. Use: call immediately after install or first MCP connection; use validate or run for project checks. Inputs: format changes rendering only; the smoke test has no project inputs. Effects: read-only built-in compiler smoke test; writes no files and uses no network.

formatstring

Output format. markdown is human-readable, json is structured for automation.

Axint MCP server | mcptry

Tools (36)

axint.activate

read-only

Argument	Type	Description
format	string	Output format. markdown is human-readable, json is structured for automation.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "markdown",
        "json"
      ],
      "type": "string",
      "description": "Output format. markdown is human-readable, json is structured for automation."
    }
  }
}

axint.agent.advice

Ask the local Axint project brain what this agent should do next. Reads project context, latest run proof, latest repair plan, and active file claims, then returns host-specific guidance for Xcode, patch-first editors, or another agent lane. Use: use when local proof should choose the next move; use suggest for greenfield ideas and repair for known bugs. Inputs: cwd selects local context; question and modifiedFiles focus the next-move recommendation. Effects: reads local Axint context/proof and may refresh advice artifacts; no network.

Argument	Type	Description
cwd	string	Project directory. Defaults to the MCP process cwd.
agent	string	Active host/tool lane.
issue	string	Optional bug, feature, or repair goal to turn into project-aware next moves.
format	string	Output format. Defaults to markdown.
changedFiles	array	Files in scope. Axint uses these to detect claim conflicts and recommend proof.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "cwd": {
      "type": "string",
      "description": "Project directory. Defaults to the MCP process cwd."
    },
    "agent": {
      "enum": [
        "all",
        "claude",
        "codex",
        "cowork",
        "cursor",
        "xcode"
      ],
      "type": "string",
      "description": "Active host/tool lane."
    },
    "issue": {
      "type": "string",
      "description": "Optional bug, feature, or repair goal to turn into project-aware next moves."
    },
    "format": {
      "enum": [
        "markdown",
        "json",
        "prompt"
      ],
      "type": "string",
      "description": "Output format. Defaults to markdown."
    },
    "changedFiles": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "String value for this Axint parameter."
      },
      "description": "Files in scope. Axint uses these to detect claim conflicts and recommend proof."
    }
  }
}

axint.agent.claim

Claim files before an agent edits them so other agents do not patch the same SwiftUI/App files concurrently. Claims are local, short-lived, and stored in .axint/coordination/claims.json. Use: use before editing shared files in parallel-agent work; release claims when done. Inputs: agentId and files identify the claim; ttlMinutes bounds ownership and force overrides stale claims. Effects: writes local coordination claims under .axint/coordination; no network.

Argument	Type	Description
cwd	string	Project directory. Defaults to the MCP process cwd.
task	string	Task, bug, or repair pass this claim covers.
agent	string	Agent lane creating the claim.
files*	array	Files to claim before editing.
format	string	Output format. Defaults to markdown.
ttlMinutes	number	Claim TTL in minutes. Defaults to 30.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "files"
  ],
  "properties": {
    "cwd": {
      "type": "string",
      "description": "Project directory. Defaults to the MCP process cwd."
    },
    "task": {
      "type": "string",
      "description": "Task, bug, or repair pass this claim covers."
    },
    "agent": {
      "enum": [
        "all",
        "claude",
        "codex",
        "cowork",
        "cursor",
        "xcode"
      ],
      "type": "string",
      "description": "Agent lane creating the claim."
    },
    "files": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "String value for this Axint parameter."
      },
      "description": "Files to claim before editing."
    },
    "format": {
      "enum": [
        "markdown",
        "json",
        "prompt"
      ],
      "type": "string",
      "description": "Output format. Defaults to markdown."
    },
    "ttlMinutes": {
      "type": "number",
      "description": "Claim TTL in minutes. Defaults to 30."
    }
  }
}

axint.agent.install

Install the local Axint multi-agent project brain. Writes .axint/agent.json, .axint/context/latest.*, and .axint/coordination files so AI agents, Xcode, and humans coordinate through the same local truth layer. Use: use once per project to create local multi-agent coordination; not needed for one-off compile. Inputs: cwd scopes local coordination; projectName and hosts shape generated project-brain files. Effects: writes .axint/agent, context, and coordination files; no network.

Argument	Type	Description
cwd	string	Project directory. Defaults to the MCP process cwd.
agent	string	Active host/tool lane. Defaults to all.
force	boolean	Rewrite the existing local agent config if present.
format	string	Output format. Defaults to markdown.
privacyMode	string	Privacy posture for this project.
projectName	string	Optional project name override.
providerMode	string	Optional model-provider posture for future AI-enhanced advice. Defaults to none.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "cwd": {
      "type": "string",
      "description": "Project directory. Defaults to the MCP process cwd."
    },
    "agent": {
      "enum": [
        "all",
        "claude",
        "codex",
        "cowork",
        "cursor",
        "xcode"
      ],
      "type": "string",
      "description": "Active host/tool lane. Defaults to all."
    },
    "force": {
      "type": "boolean",
      "description": "Rewrite the existing local agent config if present."
    },
    "format": {
      "enum": [
        "markdown",
        "json",
        "prompt"
      ],
      "type": "string",
      "description": "Output format. Defaults to markdown."
    },
    "privacyMode": {
      "enum": [
        "local_only",
        "redacted_cloud",
        "source_opt_in"
      ],
      "type": "string",
      "description": "Privacy posture for this project."
    },
    "projectName": {
      "type": "string",
      "description": "Optional project name override."
    },
    "providerMode": {
      "enum": [
        "none",
        "bring_your_own_key",
        "axint_cloud"
      ],
      "type": "string",
      "description": "Optional model-provider posture for future AI-enhanced advice. Defaults to none."
    }
  }
}

axint.agent.release

Release active local Axint file claims for this agent after finishing or abandoning a task. This keeps parallel agents and Xcode from blocking each other on stale claims. Use: use after finishing or abandoning claimed files; use agent.claim before edits and agent.advice for next steps. Inputs: agentId releases only its matching claims unless files narrow the release set. Effects: updates local coordination claims under .axint/coordination; no network.

Argument	Type	Description
all	boolean	Release all matching active claims.
cwd	string	Project directory. Defaults to the MCP process cwd.
agent	string	Agent lane releasing claims.
files	array	Optional files to release. Omit to release this agent's claims.
format	string	Output format. Defaults to markdown.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "all": {
      "type": "boolean",
      "description": "Release all matching active claims."
    },
    "cwd": {
      "type": "string",
      "description": "Project directory. Defaults to the MCP process cwd."
    },
    "agent": {
      "enum": [
        "all",
        "claude",
        "codex",
        "cowork",
        "cursor",
        "xcode"
      ],
      "type": "string",
      "description": "Agent lane releasing claims."
    },
    "files": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "String value for this Axint parameter."
      },
      "description": "Optional files to release. Omit to release this agent's claims."
    },
    "format": {
      "enum": [
        "markdown",
        "json",
        "prompt"
      ],
      "type": "string",
      "description": "Output format. Defaults to markdown."
    }
  }
}

axint.cloud.check

Run an agent-callable Cloud Check against Swift or Axint TypeScript source. Accepts inline source or a sourcePath, then returns a Cloud-style verdict, Apple-specific findings, next steps, an AI repair prompt, and a redacted compiler feedback signal when the check finds a bug. Use: use for Apple-aware source review and repair prompts; provide evidence for UI/runtime claims. Inputs: provide source or sourcePath, not both; evidence fields strengthen UI and runtime claims. Effects: read-only response from provided source/path; may use configured Cloud Check endpoint; no source is sent unless.

read-only

Argument	Type	Description
format	string	Output format. markdown returns the report, json returns structured data.
source	string	Inline Swift or Axint TypeScript source to check.
fileName	string	Optional display name for diagnostics when passing inline source.
language	string	Optional language override.
platform	string	Optional target platform hint.
sourcePath	string	Optional file path to read and check.
testFailure	string	Optional short failing unit/UI-test excerpt.

axint.compile

Compile TypeScript source (defineIntent() call) into native Swift App Intent code. Returns { swift, infoPlist?, entitlements? } as a string — no files written, no network requests. On validation failure, returns diagnostics (severity, AX error code, position, fix suggestion) instead of Swift. Use: use when TypeScript DSL source should become Swift; use validate for cheaper preflight only. Inputs: source is TypeScript DSL text; options add sandbox, format, plist, or entitlement proof without writing files. Effects: read-only generated Swift/diagnostics; writes no files and uses no network.

read-only

Argument	Type	Description
format	boolean	When true (default), pipes generated Swift through swift-format with Axint's.
source*	string	Full TypeScript source code containing a defineIntent() call. Must be a complete file starting with an axint import, not a fragment.
fileName	string	Optional file name used in diagnostic messages, e.g., 'SendMessage.intent.ts'.
emitInfoPlist	boolean	When true, returns an Info.plist XML fragment declaring the intent's.
emitEntitlements	boolean	When true, returns an .entitlements XML fragment for the intent's declared.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "source"
  ],
  "properties": {
    "format": {
      "type": "boolean",
      "description": "When true (default), pipes generated Swift through swift-format with Axint's."
    },
    "source": {
      "type": "string",
      "description": "Full TypeScript source code containing a defineIntent() call. Must be a complete file starting with an axint import, not a fragment."
    },
    "fileName": {
      "type": "string",
      "description": "Optional file name used in diagnostic messages, e.g., 'SendMessage.intent.ts'."
    },
    "emitInfoPlist": {
      "type": "boolean",
      "description": "When true, returns an Info.plist XML fragment declaring the intent's."
    },
    "emitEntitlements": {
      "type": "boolean",
      "description": "When true, returns an .entitlements XML fragment for the intent's declared."
    }
  }
}

axint.context.docs

Return the project-local Axint docs context that agents should reload after new chats or context compaction. This is the durable docs memory that keeps the agent using Axint instead of forgetting the workflow. Use: use after compaction when the agent needs workflow docs without rereading the whole site. Inputs: cwd selects project docs context; include sections only when the longer runbook is needed. Effects: read-only generated docs context; writes no files and uses no network.

read-only

Argument	Type	Description
platform	string	Target Apple platform, such as macOS, iOS, visionOS, or all.
projectName	string	Project name to include in the docs context.
expectedVersion	string	Expected Axint version to compare against axint.status.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "platform": {
      "type": "string",
      "description": "Target Apple platform, such as macOS, iOS, visionOS, or all."
    },
    "projectName": {
      "type": "string",
      "description": "Project name to include in the docs context."
    },
    "expectedVersion": {
      "type": "string",
      "description": "Expected Axint version to compare against axint.status."
    }
  }
}

axint.context.memory

Return the compact Axint operating memory that agents should reload at new chat start, after context compaction, or after long coding drift. Use this to keep Axint top-of-mind without rereading the full docs. Use: use after compaction or session restart for compact operating rules; use context.docs for longer workflow docs. Inputs: cwd selects project memory; format changes rendering without changing content. Effects: read-only generated context; writes no files and uses no network.

read-only

Argument	Type	Description
platform	string	Target Apple platform, such as macOS, iOS, visionOS, or all.
projectName	string	Project name to include in the memory.
expectedVersion	string	Expected Axint version to compare against axint.status.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "platform": {
      "type": "string",
      "description": "Target Apple platform, such as macOS, iOS, visionOS, or all."
    },
    "projectName": {
      "type": "string",
      "description": "Project name to include in the memory."
    },
    "expectedVersion": {
      "type": "string",
      "description": "Expected Axint version to compare against axint.status."
    }
  }
}

axint.doctor

Audit the current Axint runtime and project wiring: running MCP version, expected version, Node/npm/npx paths, project .mcp.json, AGENTS.md, CLAUDE.md, .axint/project.json, and Xcode Claude Agent registration. Use this when an agent might be connected to a stale Axint process or when a new project needs first-try MCP setup proof. Use: call when MCP wiring, package paths, Xcode setup, or project memory may be stale; use run for build proof. Inputs: cwd selects the project; expectedVersion turns a runtime mismatch into a blocker. Effects: read-only inspection; writes no files; no auth or network required.

read-only

Argument	Type	Description
cwd	string	Project directory to inspect. Defaults to the MCP process cwd.
format	string	Output format. Defaults to markdown.
expectedVersion	string	Expected Axint version.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "cwd": {
      "type": "string",
      "description": "Project directory to inspect. Defaults to the MCP process cwd."
    },
    "format": {
      "enum": [
        "markdown",
        "json"
      ],
      "type": "string",
      "description": "Output format. Defaults to markdown."
    },
    "expectedVersion": {
      "type": "string",
      "description": "Expected Axint version."
    }
  }
}

axint.feature

Generate a scaffolded Apple-native feature package from a description. Returns multiple files: compile-aware Swift source, companion widget/view, Info.plist fragments, entitlements, and XCTest scaffolds — all structured file-by-file so an Xcode agent can write each file directly into the project. Use: use for new Apple-native surfaces; not for repairing existing app bugs. Inputs: description is the feature brief; kind and platform constrain the generated package. Effects: read-only generated output; writes no files and uses no network.

read-only

Argument	Type	Description
name	string	PascalCase feature name, e.g., 'LogWaterIntake'.
domain	string	Apple App Intent domain.
format	boolean	When true (default), pipes every generated Swift file through swift-format with.
params	object	Explicit parameter definitions as { fieldName: typeString }.
appName	string	The target app name, used in generated comments and test references.
context	string	Optional nearby SwiftUI/design context.
platform	string	Target Apple platform for generated starter UI.

axint.feedback.create

Create or read a privacy-safe learning packet for Axint repair intelligence. Packets include project shape, diagnostic codes, issue class, redacted evidence, and likely product owner, but never include source code. Users can inspect the JSON before sending it to Axint Cloud. Use: create a privacy-safe issue packet when output was weak, or read the latest packet; never use it to send source. Inputs: latest reads instead of creates; outcome and diagnostic fields stay source-free unless excerpts are explicit. Effects: writes or reads redacted .axint/feedback packets; never includes source by default.

Argument	Type	Description
cwd	string	Project directory. Defaults to the MCP process cwd.
agent	string	Active host/tool lane.
issue	string	Bug, weak Axint output, or failed repair behavior.
format	string	Output format. Defaults to json.
latest	boolean	When true, return the latest local feedback packet instead of creating a new.
source	string	Optional inline Swift source used locally only.
fileName	string	Display file name when passing inline source.
platform	string

axint.fix-packet

Read the latest Fix Packet that Axint emitted locally after a compile or watch run. Returns the exact repair artifact that AI tools or Xcode helpers should consume next: verdict, top findings, full diagnostics, next steps, and an AI-ready fix prompt. Use: use after a local compile/watch/check emitted a packet; not a new analysis pass. Inputs: cwd and path locate an existing packet; latest selects the newest artifact and never reruns analysis. Effects: read-only local artifact read; writes no files and uses no network.

read-only

Argument	Type	Description
cwd	string	Optional working directory to search from.
format	string	Output format. json returns the full packet, markdown returns the.
packetDir	string	Optional explicit packet directory override.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "cwd": {
      "type": "string",
      "description": "Optional working directory to search from."
    },
    "format": {
      "enum": [
        "json",
        "markdown",
        "prompt"
      ],
      "type": "string",
      "description": "Output format. json returns the full packet, markdown returns the."
    },
    "packetDir": {
      "type": "string",
      "description": "Optional explicit packet directory override."
    }
  }
}

axint.project.index

Scan the local Apple project and write a compact .axint/context pack so Axint can reason over changed files, nearby SwiftUI surfaces, and interaction-risk files instead of only one source file at a time. Use: use before project-aware repair, multi-file SwiftUI work, or interaction-risk analysis. Inputs: changedFiles seed related-file discovery; dryRun returns the pack without writing .axint/context. Effects: writes .axint/context unless dryRun=true; reads local project files only.

Argument	Type	Description
dryRun	boolean	When true, returns the index without writing .axint/context files.
format	string	Output format. Defaults to markdown.
targetDir	string	Project directory to index. Defaults to the current working directory.
includeGit	boolean	Whether to include git changed-file discovery. Defaults to true.
projectName	string	Optional project name override for the context pack.
changedFiles	array	Optional changed files to pin into the context pack.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "dryRun": {
      "type": "boolean",
      "description": "When true, returns the index without writing .axint/context files."
    },
    "format": {
      "enum": [
        "markdown",
        "json"
      ],
      "type": "string",
      "description": "Output format. Defaults to markdown."
    },
    "targetDir": {
      "type": "string",
      "description": "Project directory to index. Defaults to the current working directory."
    },
    "includeGit": {
      "type": "boolean",
      "description": "Whether to include git changed-file discovery. Defaults to true."
    },
    "projectName": {
      "type": "string",
      "description": "Optional project name override for the context pack."
    },
    "changedFiles": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "String value for this Axint parameter."
      },
      "description": "Optional changed files to pin into the context pack."
    }
  }
}

axint.project.pack

Generate the Axint project-start pack for a new Apple app without writing files. Use: use to bootstrap a new Apple project with Axint instructions; use project.index to inspect an existing project. Inputs: cwd and projectName identify the project; host choices control generated integration files. Effects: read-only generated file pack; writes no files and uses no network.

read-only

Argument	Type	Description
mode	string	MCP mode. local uses npx stdio; remote uses mcp.axint.ai.
agent	string	Agent target. Defaults to all.
format	string	Output format. Defaults to markdown.
targetDir	string	Project directory label to embed in the report.
projectName	string	Project name to embed in the generated instructions.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "mode": {
      "enum": [
        "local",
        "remote"
      ],
      "type": "string",
      "description": "MCP mode. local uses npx stdio; remote uses mcp.axint.ai."
    },
    "agent": {
      "enum": [
        "all",
        "claude",
        "codex",
        "cowork",
        "cursor",
        "xcode"
      ],
      "type": "string",
      "description": "Agent target. Defaults to all."
    },
    "format": {
      "enum": [
        "markdown",
        "json"
      ],
      "type": "string",
      "description": "Output format. Defaults to markdown."
    },
    "targetDir": {
      "type": "string",
      "description": "Project directory label to embed in the report."
    },
    "projectName": {
      "type": "string",
      "description": "Project name to embed in the generated instructions."
    }
  }
}

axint.project.syncVersion

Update Axint-owned project-pack version hints after an upgrade. Use this after axint.upgrade or npm/pip upgrades so .axint/project.json, AGENTS.md, CLAUDE.md, and Axint rehydration docs stop pointing agents at an older package version. Use: use after package upgrades so local project-pack hints stop naming old Axint versions. Inputs: cwd scopes Axint-owned files; targetVersion overrides running version; dryRun prevents writes. Effects: updates Axint-owned project instruction files unless dryRun=true; no network.

Argument	Type	Description
dryRun	boolean	When true, reports the files that would change without writing them.
format	string	Output format. Defaults to markdown.
version	string	Axint version to write. Defaults to the running MCP server version.
targetDir	string	Project directory to update. Defaults to the current working directory.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "dryRun": {
      "type": "boolean",
      "description": "When true, reports the files that would change without writing them."
    },
    "format": {
      "enum": [
        "markdown",
        "json"
      ],
      "type": "string",
      "description": "Output format. Defaults to markdown."
    },
    "version": {
      "type": "string",
      "description": "Axint version to write. Defaults to the running MCP server version."
    },
    "targetDir": {
      "type": "string",
      "description": "Project directory to update. Defaults to the current working directory."
    }
  }
}

axint.registry.search

Search the Axint Registry for already-published packages that match a natural-language query. Use this BEFORE calling axint.feature or axint.compile so the agent can install an existing package instead of regenerating Swift the community has already shipped. Use: use before generating code to find reusable packages; not for validating local Swift. Inputs: query drives ranking; kind and platform narrow results without changing the registry source. Effects: read-only local registry search using AXINT_REGISTRY_PATH or sibling checkout; no network by default.

read-only

Argument	Type	Description
kind	string	Optional surface filter.
limit	number	Hard cap on returned hits. Defaults to 10.
query*	string	Free-form description of what the agent is about to build. E.g., 'log a workout', 'capture a voice note', 'show timer'.
minScore	number	Minimum normalized match score (0..1) below which results are dropped.
platform	string	Optional platform filter. One of: iOS, macOS, watchOS, tvOS, visionOS.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "kind": {
      "type": "string",
      "description": "Optional surface filter."
    },
    "limit": {
      "type": "number",
      "description": "Hard cap on returned hits. Defaults to 10."
    },
    "query": {
      "type": "string",
      "description": "Free-form description of what the agent is about to build. E.g., 'log a workout', 'capture a voice note', 'show timer'."
    },
    "minScore": {
      "type": "number",
      "description": "Minimum normalized match score (0..1) below which results are dropped."
    },
    "platform": {
      "type": "string",
      "description": "Optional platform filter. One of: iOS, macOS, watchOS, tvOS, visionOS."
    }
  }
}

axint.repair

Plan a project-aware Apple repair for existing apps. Indexes the local project, classifies build/UI/runtime evidence, runs Cloud Check when source is provided, ranks likely SwiftUI/App files, returns a host-aware patch/proof plan, and writes .axint/repair plus a privacy-safe .axint/feedback packet. Use: use for existing app bugs with logs, UI symptoms, or runtime evidence; not for greenfield generation. Inputs: describe the observed bug and attach logs or evidence; modifiedFiles and project index narrow the plan. Effects: writes .axint/repair and privacy-safe .axint/feedback artifacts; reads local project files.

Argument	Type	Description
cwd	string	Project directory. Defaults to the MCP process cwd.
agent	string	Active host/tool lane.
issue*	string	The broken behavior or repair goal, e.g. 'comment box is visible but cannot be tapped'.
format	string	Output format. markdown returns the report, json returns structured data, and.
source	string	Optional inline Swift source for the suspected file.
fileName	string	Display file name when passing inline source.
platform	string	Target Apple platform hint.
sourcePath

axint.run

Run the enforced Axint Apple build loop outside the Xcode UI. Use: use for the complete proof loop; use swift.validate, cloud.check, or fix-packet when only one stage is needed. Inputs: integration=minimal enforces local advisory no-fix behavior; background returns a job id; outputDir controls artifacts. Effects: starts child processes, writes .axint/run artifacts, may run xcodebuild/tests, and may call Cloud Check.

Argument	Type	Description
cwd	string	Project directory to run. Defaults to the MCP process cwd.
fix	boolean	Allow automatic fix behavior. Forced false by minimal mode.
agent	string	Current agent host lane.
dryRun	boolean	Plan xcodebuild commands without executing them.
format	string	Output format. markdown returns the run report, json returns structured data.
scheme	string	Xcode scheme. If omitted, Axint tries to infer one.
project	string	Path to .xcodeproj, relative to cwd or absolute.
runtime	boolean	After build, launch the built macOS .app and capture runtime/timeout evidence.
advisory

axint.run.cancel

Cancel the latest or selected Axint run by killing active child process groups. Use this when xcodebuild or a UI-test runner survived an MCP timeout or transport close. Use: use only to stop an active run or stuck child process group; use run.status for read-only inspection. Inputs: jobId is required; signal and grace period control escalation before killing the process group. Effects: destructive: kills active Axint child process groups; no network.

destructive

Argument	Type	Description
id	string	Optional Axint run id. Defaults to latest active run.
cwd	string	Project directory. Defaults to the MCP process cwd.
format	string	Output format. Defaults to markdown.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Optional Axint run id. Defaults to latest active run."
    },
    "cwd": {
      "type": "string",
      "description": "Project directory. Defaults to the MCP process cwd."
    },
    "format": {
      "enum": [
        "markdown",
        "json"
      ],
      "type": "string",
      "description": "Output format. Defaults to markdown."
    }
  }
}

axint.run.status

Read the latest or selected Axint run job record, including active child process IDs. Use this when a long xcodebuild run may still be active after an MCP timeout or client disconnect. Use: use after MCP timeouts or long builds to inspect or rejoin; it does not start, rerun, or cancel work. Inputs: jobId selects a background run; includeLogs changes returned detail without changing the job. Effects: read-only local run/job inspection; writes no files and uses no network.

read-only

Argument	Type	Description
id	string	Optional Axint run id. Defaults to latest active run.
cwd	string	Project directory. Defaults to the MCP process cwd.
format	string	Output format. Defaults to markdown.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Optional Axint run id. Defaults to latest active run."
    },
    "cwd": {
      "type": "string",
      "description": "Project directory. Defaults to the MCP process cwd."
    },
    "format": {
      "enum": [
        "markdown",
        "json"
      ],
      "type": "string",
      "description": "Output format. Defaults to markdown."
    }
  }
}

axint.scaffold

Generate a starter TypeScript intent file from a name and description. Returns a complete defineIntent() source string ready to save as a .ts file — no files are written, no network requests made. On invalid domain values, returns an error string. The output compiles directly with axint.compile. Use: use to create a small TypeScript intent starter; use templates.get for richer examples and compile for Swift output. Inputs: name must be PascalCase; params define the starter contract; domain defaults to general. Effects: read-only generated TypeScript; writes no files and uses no network.

read-only

Argument	Type	Description
name*	string	PascalCase intent name, e.g., 'SendMessage' or 'CreateEvent'. Must start with an uppercase letter and contain no spaces.
domain	string	Apple App Intent domain.
params	array	Initial parameters for the intent.
description*	string	Human-readable description of what the intent does, shown to users in Shortcuts and Spotlight, e.g., 'Send a message to a contact'.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "name",
    "description"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "PascalCase intent name, e.g., 'SendMessage' or 'CreateEvent'. Must start with an uppercase letter and contain no spaces."
    },
    "domain": {
      "type": "string",
      "description": "Apple App Intent domain."
    },
    "params": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "type",
          "description"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "camelCase parameter name, e.g., 'recipient' or 'messageBody'."
          },
          "type": {
            "type": "string",
            "description": "Parameter type."
          },
          "description": {
            "type": "string",
            "description": "Human-readable description shown in Shortcuts and Spotlight when users."
          }
        },
        "description": "Parameter definition with name, type, and description."
      },
      "description": "Initial parameters for the intent."
    },
    "description": {
      "type": "string",
      "description": "Human-readable description of what the intent does, shown to users in Shortcuts and Spotlight, e.g., 'Send a message to a contact'."
    }
  }
}

axint.schema.compile

Compile a minimal JSON schema directly to Swift, bypassing the TypeScript DSL entirely. Supports intents, views, components, widgets, and full apps via the 'type' parameter. Uses ~20 input tokens vs hundreds for TypeScript — ideal for LLM agents optimizing token budgets. Use: use for token-light JSON-to-Swift generation; use compile for full TypeScript DSL control and scaffold for TS starters. Inputs: schema kind selects intent, view, widget, or app output; options add companion metadata. Effects: read-only Swift generation; writes no files and uses no network.

read-only

Argument	Type	Description
body	string	View/widget only.
name*	string	PascalCase name, e.g., 'CreateEvent' for intents, 'EventListView' for views, 'StepsWidget' for widgets. Used as the Swift struct name.
type*	string	What to compile.
entry	object	Widget only. Timeline entry fields as { fieldName: typeString }.
props	object	View only. Prop definitions as { fieldName: typeString }.
state	object	View only.
title	string	Human-readable title shown in Shortcuts/Spotlight. Intent only.

axint.session.start

Start an enforced Axint agent session. Writes .axint/session/current.json plus token-scoped session history, refreshes .axint/AXINT_REHYDRATE.md, returns compact operating memory, docs context, a session token, and the exact axint.workflow.check args. Use: call at the start of a tool-enabled agent session or after context compaction. Inputs: cwd scopes session files; prior token and context inputs preserve continuity after compaction. Effects: writes .axint/session and rehydration artifacts; no auth or network required.

Argument	Type	Description
agent	string	Agent target for the session. Defaults to all.
format	string	Output format. Defaults to markdown.
platform	string	Target Apple platform, such as macOS, iOS, visionOS, or all.
targetDir	string	Project directory where .axint/session/current.json and token-scoped session.
ttlMinutes	number	How long the session token remains valid. Defaults to 720 minutes.
projectName	string	Project name to embed in the session and returned context.
expectedVersion	string	Expected Axint package version. Defaults to the running MCP version.

Input schema (JSON)

axint.status

Report the exact running Axint MCP server version, package path, uptime, registered tool count, and same-thread MCP reload/update instructions. Use this as the first tool in a new AI-agent or Xcode chat to prove which Axint process the agent is actually connected to. This answers the running MCP server, not a guessed npm, PyPI, or docs version. Use: call first or after an MCP reload to prove the connected server version; do not use as an npm/PyPI lookup. Inputs: format changes rendering only; no project path is required. Effects: read-only; writes no files; no auth or network required.

read-only

Argument	Type	Description
format	string	Output format. markdown is human-readable, json is structured, and prompt is a.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "markdown",
        "json",
        "prompt"
      ],
      "type": "string",
      "description": "Output format. markdown is human-readable, json is structured, and prompt is a."
    }
  }
}

axint.suggest

Suggest Apple-native features for an app based on its description. The domain is only a weak hint; the app description wins. Returns a ranked list of features with recommended surfaces (intent, widget, view, component, store, app), estimated complexity, and a one-line description for each. Use: use before generation to choose Apple surfaces; not a substitute for registry search or validation. Inputs: prompt is the product brief; dir adds project context; Pro mode is used only when configured. Effects: local mode is read-only; Pro mode may call Axint endpoint when credentials are configured.

read-only

Argument	Type	Description
mode	string	Suggestion strategy. local is deterministic and offline. pro/ai uses the.
goals	array	Optional product goals for Pro mode, such as activation, retention, conversion.
limit	number	Maximum number of suggestions to return. Defaults to 5.
stage	string	Optional product stage used by Pro mode to tune suggestions without embedding.
domain	string	Primary app domain.
exclude	array	Optional concepts to avoid, for example ['dating', 'fitness'].
audience	string	Optional audience context, such as consumers, teams, operators, developers.

axint.swift.fix

Auto-fix mechanical Swift errors detected by axint.swift.validate. Use: use after swift.validate when errors are mechanical; inspect remaining diagnostics manually. Inputs: source is required; codes limits mechanical rewrites; maxPasses bounds convergence attempts. Effects: read-only fixed-source output; writes no files and uses no network.

read-only

Argument	Type	Description
file	string	Optional file name to attach to diagnostics.
format	boolean	When true (default), pipes the repaired Swift through swift-format with Axint's.
source*	string	Full Swift source code to fix.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "source"
  ],
  "properties": {
    "file": {
      "type": "string",
      "description": "Optional file name to attach to diagnostics."
    },
    "format": {
      "type": "boolean",
      "description": "When true (default), pipes the repaired Swift through swift-format with Axint's."
    },
    "source": {
      "type": "string",
      "description": "Full Swift source code to fix."
    }
  }
}

axint.swift.validate

Validate existing Swift source against Axint's Apple-specific build-time rules (AX700–AX749) including Swift 6 concurrency and Live Activities. Use: use on generated or edited Swift before build; pair with swift.fix for mechanical repairs. Inputs: source or sources provide Swift text; projectIndex enables cross-file checks; platform filters rules. Effects: read-only Swift diagnostics; writes no files and uses no network.

read-only

Argument	Type	Description
file	string	Optional file name to attach to diagnostics for editor integration.
source*	string	Full Swift source code to validate.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "source"
  ],
  "properties": {
    "file": {
      "type": "string",
      "description": "Optional file name to attach to diagnostics for editor integration."
    },
    "source": {
      "type": "string",
      "description": "Full Swift source code to validate."
    }
  }
}

axint.templates.get

Retrieve the full TypeScript source code of a specific bundled template by id. Returns a complete, compilable defineIntent() file as a string — ready to save as .ts and compile with axint.compile. Includes perform() logic, parameter definitions, and domain-specific patterns. Use: use after templates.list to fetch a complete reference template; edit it before calling compile. Inputs: id must come from templates.list; format changes source versus metadata rendering. Effects: read-only template source; writes no files and uses no network.

read-only

Argument	Type	Description
id*	string	Template id from axint.templates.list, e.g., 'send-message' or 'create-event'. Case-sensitive, kebab-case format.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Template id from axint.templates.list, e.g., 'send-message' or 'create-event'. Case-sensitive, kebab-case format."
    }
  }
}

axint.templates.list

List all bundled reference templates in the Axint SDK. Returns a JSON array of { id, name, description } objects — one per template. Templates cover messaging, productivity, health, finance, commerce, media, navigation, smart-home, and entity/query patterns. No input parameters required, no files written, no network requests, no side effects. Use: use to discover valid template ids before templates.get. Inputs: category and query filter metadata; call without filters to discover every valid id. Effects: read-only template metadata; writes no files and uses no network.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object"
}

axint.tokens.ingest

Ingest design tokens from JSON, JS/TS object exports, or CSS variables and return a SwiftUI token enum. Use this before generating Swarm-style views/components so agents can preserve exact brand colors, dimensions, radii, spacing, and typography. No files are written. Use: use before view/component generation when a design system should be preserved. Inputs: tokens accepts structured design values; enumName and accessLevel shape generated Swift names. Effects: read-only Swift token output; writes no files and uses no network.

read-only

Argument	Type	Description
format	string	Output format. swift returns the SwiftUI token enum, json returns normalized.
source	string	Inline token source.
namespace	string	Swift enum namespace to generate. Example: SwarmTokens.
sourcePath	string	Path to a token file such as swarm-tokens.js, tokens.json, or tokens.css.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "swift",
        "json",
        "markdown"
      ],
      "type": "string",
      "description": "Output format. swift returns the SwiftUI token enum, json returns normalized."
    },
    "source": {
      "type": "string",
      "description": "Inline token source."
    },
    "namespace": {
      "type": "string",
      "description": "Swift enum namespace to generate. Example: SwarmTokens."
    },
    "sourcePath": {
      "type": "string",
      "description": "Path to a token file such as swarm-tokens.js, tokens.json, or tokens.css."
    }
  }
}

axint.upgrade

Check the latest Axint package and optionally apply the upgrade while preserving the current agent thread. Use: call when axint.status shows a stale server; not for app dependency upgrades. Inputs: apply defaults false; targetVersion selects the install, while reinstallXcode and writeReport matter only when applying. Effects: destructive when apply=true: can run package installs, refresh Xcode wiring, and write .axint/upgrade; may use npm.

destructive

Argument	Type	Description
cwd	string	Project directory where .axint/upgrade/latest.* should be written.
apply	boolean	Whether to install the target package.
format	string	Output format. markdown is human-readable, json is structured, and prompt is.
writeReport	boolean	Whether to write .axint/upgrade/latest.json and latest.md.
latestVersion	string	Known latest version to compare against.
targetVersion	string	Specific Axint version to install. Defaults to the latest published npm version.
reinstallXcode	boolean	Whether apply mode should also refresh optional Xcode MCP wiring.

axint.validate

Validate a TypeScript intent definition without generating Swift. Runs the full Axint validation pipeline (134 diagnostic rules) and returns a JSON array of diagnostics: { severity: 'error'|'warning', code: 'AXnnn', line: number, column: number, message: string, suggestion?: string }. Returns an empty array [] when validation passes. Use: use for TypeScript DSL diagnostics before Swift output; use swift.validate for existing Swift. Inputs: source is TypeScript DSL text; strictness options affect diagnostics only and never emit Swift. Effects: read-only diagnostics; writes no files and uses no network.

read-only

Argument	Type	Description
source*	string	Full TypeScript source code containing a defineIntent() call. Must be a complete file starting with an axint import, not a code fragment.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "source"
  ],
  "properties": {
    "source": {
      "type": "string",
      "description": "Full TypeScript source code containing a defineIntent() call. Must be a complete file starting with an axint import, not a code fragment."
    }
  }
}

axint.workflow.check

Agent workflow gate that records a local freshness stamp. Requires the current Axint session token from axint.session.start unless requireSession=false is explicitly set. Use: use at stage gates to prove workflow coverage; use status for version checks and run for build/test proof. Inputs: stage selects the gate; sessionToken proves continuity; allowNoSession is an explicit escape hatch. Effects: writes a local .axint/session workflow freshness stamp; edits no app source and uses no network.

Argument	Type	Description
cwd	string	Project directory containing .axint/session/current.json.
agent	string	Agent host/tool lane for this gate.
notes	string	Optional human/agent context for why a step was skipped.
stage	string	Workflow stage being checked. Defaults to pre-build.
format	string	Output format. Defaults to markdown.
surfaces	array	Apple surfaces touched by this task. If omitted, inferred from modifiedFiles.
ranRepair	boolean	Whether axint.repair was used for an existing-code repair plan.
ranStatus	boolean	Whether axint.status was called to confirm the running MCP version.

axint.xcode.guard

Guard an Xcode agent session against context compaction and Axint drift. Checks project memory files, active Axint session, latest Axint Run or guard proof, and long-task freshness. Use: call around long Xcode tasks, context recovery, broad Swift edits, or before claiming runtime proof; use workflow.check. Inputs: stage selects the gate; modifiedFiles and notes narrow drift checks; autoStartSession defaults true. Effects: writes .axint/guard proof and may start a session; does not edit app source or use network.

Argument	Type	Description
cwd	string	Project directory to guard. Defaults to the MCP process cwd.
notes	string	Agent/user notes to scan for compaction, drift, forgotten Axint usage, or.
stage	string	Current Xcode workflow stage. Defaults to context-recovery.
format	string	Output format. Defaults to markdown.
platform	string	Target Apple platform, such as macOS, iOS, visionOS, or all.
projectName	string	Project name for the guard report.
writeReport	boolean	Whether to write .axint/guard/latest.json and latest.md. Defaults to true.
sessionToken	string

axint.xcode.write

Write a file inside the Xcode project through the Axint guard path. For Swift files, runs axint.swift.validate and axint.cloud.check immediately, then records .axint/guard/latest.* proof. Use this instead of raw XcodeWrite when an agent is editing Apple-native files during a long task. Use: use only for guarded Xcode-project file writes; outside Xcode, patch normally and validate after. Inputs: path must remain inside cwd; createDirs, validateSwift, and cloudCheck default true. Effects: writes the requested file inside cwd, may create dirs, validates Swift, and may write guard/check artifacts.

Argument	Type	Description
cwd	string	Project root. Defaults to the MCP process cwd.
path*	string	File path to write. Relative paths are resolved inside cwd; absolute paths must still be inside cwd.
notes	string	Agent notes or user feedback to scan for drift while writing.
format	string	Output format. Defaults to markdown.
content*	string	Full file contents to write.
platform	string	Target Apple platform for Cloud Check.
cloudCheck	boolean	Whether to run Cloud Check for .swift files. Defaults to true.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "markdown",
        "json",
        "prompt",
        "feedback"
      ],
      "type": "string",
      "description": "Output format. markdown returns the report, json returns structured data."
    },
    "source": {
      "type": "string",
      "description": "Inline Swift or Axint TypeScript source to check."
    },
    "fileName": {
      "type": "string",
      "description": "Optional display name for diagnostics when passing inline source."
    },
    "language": {
      "enum": [
        "swift",
        "typescript",
        "unknown"
      ],
      "type": "string",
      "description": "Optional language override."
    },
    "platform": {
      "enum": [
        "iOS",
        "macOS",
        "watchOS",
        "visionOS",
        "all"
      ],
      "type": "string",
      "description": "Optional target platform hint."
    },
    "sourcePath": {
      "type": "string",
      "description": "Optional file path to read and check."
    },
    "testFailure": {
      "type": "string",
      "description": "Optional short failing unit/UI-test excerpt."
    },
    "xcodeBuildLog": {
      "type": "string",
      "description": "Optional short Xcode build excerpt."
    },
    "actualBehavior": {
      "type": "string",
      "description": "Optional observed behavior for behavior-gap checks."
    },
    "runtimeFailure": {
      "type": "string",
      "description": "Optional crash, freeze, hang, launch timeout, console, preview, or runtime."
    },
    "expectedVersion": {
      "type": "string",
      "description": "Optional expected Axint version for this project/session."
    },
    "expectedBehavior": {
      "type": "string",
      "description": "Optional expected behavior for behavior-gap checks."
    },
    "projectContextPath": {
      "type": "string",
      "description": "Optional path to a local .axint/context/latest.json pack written by."
    },
    "cloudRulesetVersion": {
      "type": "string",
      "description": "Optional hosted/cloud ruleset version when different from the local compiler."
    },
    "localPackageVersion": {
      "type": "string",
      "description": "Optional local CLI/package version when the caller knows it."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "required": [
    "description"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "PascalCase feature name, e.g., 'LogWaterIntake'."
    },
    "domain": {
      "type": "string",
      "description": "Apple App Intent domain."
    },
    "format": {
      "type": "boolean",
      "description": "When true (default), pipes every generated Swift file through swift-format with."
    },
    "params": {
      "type": "object",
      "description": "Explicit parameter definitions as { fieldName: typeString }.",
      "additionalProperties": {
        "type": "string",
        "description": "Swift type for this parameter."
      }
    },
    "appName": {
      "type": "string",
      "description": "The target app name, used in generated comments and test references."
    },
    "context": {
      "type": "string",
      "description": "Optional nearby SwiftUI/design context."
    },
    "platform": {
      "enum": [
        "iOS",
        "macOS",
        "visionOS",
        "all"
      ],
      "type": "string",
      "description": "Target Apple platform for generated starter UI."
    },
    "surfaces": {
      "type": "array",
      "items": {
        "enum": [
          "intent",
          "view",
          "widget",
          "component",
          "app",
          "store",
          "model",
          "models",
          "state",
          "data"
        ],
        "type": "string",
        "description": "Allowed string value for this Axint parameter."
      },
      "description": "Which Apple surfaces to generate. 'intent' produces an App Intent struct for."
    },
    "description": {
      "type": "string",
      "description": "What the feature does, in natural language. E.g., 'Let users log water intake via Siri' or 'Add a Spotlight-searchable recipe entity'."
    },
    "componentKind": {
      "type": "string",
      "description": "Optional component blueprint for the component surface, such as feedCard."
    },
    "tokenNamespace": {
      "type": "string",
      "description": "Optional Swift token enum generated by axint.tokens.ingest, e.g., 'SwarmTokens'."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "cwd": {
      "type": "string",
      "description": "Project directory. Defaults to the MCP process cwd."
    },
    "agent": {
      "enum": [
        "all",
        "claude",
        "codex",
        "cowork",
        "cursor",
        "xcode"
      ],
      "type": "string",
      "description": "Active host/tool lane."
    },
    "issue": {
      "type": "string",
      "description": "Bug, weak Axint output, or failed repair behavior."
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "description": "Output format. Defaults to json."
    },
    "latest": {
      "type": "boolean",
      "description": "When true, return the latest local feedback packet instead of creating a new."
    },
    "source": {
      "type": "string",
      "description": "Optional inline Swift source used locally only."
    },
    "fileName": {
      "type": "string",
      "description": "Display file name when passing inline source."
    },
    "platform": {
      "enum": [
        "iOS",
        "macOS",
        "watchOS",
        "visionOS",
        "all"
      ],
      "type": "string",
      "description": "Target Apple platform hint."
    },
    "sourcePath": {
      "type": "string",
      "description": "Optional suspected Swift file path used locally only."
    },
    "testFailure": {
      "type": "string",
      "description": "Optional focused unit/UI-test failure text."
    },
    "changedFiles": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "String value for this Axint parameter."
      },
      "description": "Changed files to pin into the context pack."
    },
    "xcodeBuildLog": {
      "type": "string",
      "description": "Optional Xcode build/test log evidence."
    },
    "actualBehavior": {
      "type": "string",
      "description": "Optional actual behavior."
    },
    "runtimeFailure": {
      "type": "string",
      "description": "Optional crash, freeze, hang, or runtime failure text."
    },
    "expectedBehavior": {
      "type": "string",
      "description": "Optional expected behavior."
    },
    "projectContextPath": {
      "type": "string",
      "description": "Optional .axint/context/latest.json path."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "required": [
    "issue"
  ],
  "properties": {
    "cwd": {
      "type": "string",
      "description": "Project directory. Defaults to the MCP process cwd."
    },
    "agent": {
      "enum": [
        "all",
        "claude",
        "codex",
        "cowork",
        "cursor",
        "xcode"
      ],
      "type": "string",
      "description": "Active host/tool lane."
    },
    "issue": {
      "type": "string",
      "description": "The broken behavior or repair goal, e.g. 'comment box is visible but cannot be tapped'."
    },
    "format": {
      "enum": [
        "markdown",
        "json",
        "prompt"
      ],
      "type": "string",
      "description": "Output format. markdown returns the report, json returns structured data, and."
    },
    "source": {
      "type": "string",
      "description": "Optional inline Swift source for the suspected file."
    },
    "fileName": {
      "type": "string",
      "description": "Display file name when passing inline source."
    },
    "platform": {
      "enum": [
        "iOS",
        "macOS",
        "watchOS",
        "visionOS",
        "all"
      ],
      "type": "string",
      "description": "Target Apple platform hint."
    },
    "sourcePath": {
      "type": "string",
      "description": "Optional suspected Swift file path."
    },
    "testFailure": {
      "type": "string",
      "description": "Optional focused unit/UI-test failure text."
    },
    "writeReport": {
      "type": "boolean",
      "description": "Whether to write .axint/repair/latest.json and latest.md. Defaults to true."
    },
    "changedFiles": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "String value for this Axint parameter."
      },
      "description": "Changed files to pin into the project context pack."
    },
    "writeFeedback": {
      "type": "boolean",
      "description": "Whether to write a privacy-safe .axint/feedback packet. Defaults to true."
    },
    "xcodeBuildLog": {
      "type": "string",
      "description": "Optional Xcode build/test log evidence."
    },
    "actualBehavior": {
      "type": "string",
      "description": "Optional observed behavior from the failing run."
    },
    "runtimeFailure": {
      "type": "string",
      "description": "Optional crash, freeze, hang, or runtime failure text."
    },
    "expectedBehavior": {
      "type": "string",
      "description": "Optional expected behavior for the failing feature."
    },
    "projectContextPath": {
      "type": "string",
      "description": "Optional .axint/context/latest.json path."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "cwd": {
      "type": "string",
      "description": "Project directory to run. Defaults to the MCP process cwd."
    },
    "fix": {
      "type": "boolean",
      "description": "Allow automatic fix behavior. Forced false by minimal mode."
    },
    "agent": {
      "enum": [
        "all",
        "claude",
        "codex",
        "cowork",
        "cursor",
        "xcode"
      ],
      "type": "string",
      "description": "Current agent host lane."
    },
    "dryRun": {
      "type": "boolean",
      "description": "Plan xcodebuild commands without executing them."
    },
    "format": {
      "enum": [
        "markdown",
        "json",
        "prompt"
      ],
      "type": "string",
      "description": "Output format. markdown returns the run report, json returns structured data."
    },
    "scheme": {
      "type": "string",
      "description": "Xcode scheme. If omitted, Axint tries to infer one."
    },
    "project": {
      "type": "string",
      "description": "Path to .xcodeproj, relative to cwd or absolute."
    },
    "runtime": {
      "type": "boolean",
      "description": "After build, launch the built macOS .app and capture runtime/timeout evidence."
    },
    "advisory": {
      "type": "boolean",
      "description": "Keep unconfirmed static findings non-blocking while preserving them in the."
    },
    "platform": {
      "enum": [
        "macOS",
        "iOS",
        "watchOS",
        "visionOS",
        "all"
      ],
      "type": "string",
      "description": "Target Apple platform. Defaults to macOS unless inferred from destination."
    },
    "testPlan": {
      "type": "string",
      "description": "Optional xcodebuild -testPlan for test runs."
    },
    "localOnly": {
      "type": "boolean",
      "description": "Deny hosted/network checks for this run."
    },
    "outputDir": {
      "type": "string",
      "description": "Explicit artifact directory."
    },
    "skipBuild": {
      "type": "boolean",
      "description": "Skip xcodebuild build and only run Axint static gates."
    },
    "skipTests": {
      "type": "boolean",
      "description": "Skip xcodebuild test."
    },
    "workspace": {
      "type": "string",
      "description": "Path to .xcworkspace, relative to cwd or absolute."
    },
    "background": {
      "type": "boolean",
      "description": "Start the run and immediately return a resumable job id instead of waiting for."
    },
    "destination": {
      "type": "string",
      "description": "xcodebuild destination, e.g. platform=macOS or platform=iOS."
    },
    "integration": {
      "enum": [
        "full",
        "minimal"
      ],
      "type": "string",
      "description": "Execution profile. minimal denies network/project mutation, disables automatic."
    },
    "onlyTesting": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "String value for this Axint parameter."
      },
      "description": "Optional focused xcodebuild -only-testing selectors, e.g."
    },
    "projectName": {
      "type": "string",
      "description": "Project name for Axint session and report labels."
    },
    "writeReport": {
      "type": "boolean",
      "description": "Whether to write .axint/run/latest.json and latest.md. Defaults to true."
    },
    "configuration": {
      "type": "string",
      "description": "Xcode build configuration, e.g. Debug or Release."
    },
    "includeSource": {
      "type": "boolean",
      "description": "Include full Swift source and full command output in json output."
    },
    "modifiedFiles": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "String value for this Axint parameter."
      },
      "description": "Changed Swift files to validate and Cloud Check."
    },
    "actualBehavior": {
      "type": "string",
      "description": "Actual runtime behavior for semantic bug checks."
    },
    "runtimeFailure": {
      "type": "string",
      "description": "Crash, freeze, hang, launch timeout, or UI failure evidence."
    },
    "timeoutSeconds": {
      "type": "number",
      "description": "Build/test timeout in seconds."
    },
    "derivedDataPath": {
      "type": "string",
      "description": "Optional xcodebuild -derivedDataPath."
    },
    "expectedVersion": {
      "type": "string",
      "description": "Expected Axint package version for the run session."
    },
    "expectedBehavior": {
      "type": "string",
      "description": "Expected runtime behavior for semantic bug checks."
    },
    "runtimeTimeoutSeconds": {
      "type": "number",
      "description": "Runtime launch timeout in seconds."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "required": [
    "type",
    "name"
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "View/widget only."
    },
    "name": {
      "type": "string",
      "description": "PascalCase name, e.g., 'CreateEvent' for intents, 'EventListView' for views, 'StepsWidget' for widgets. Used as the Swift struct name."
    },
    "type": {
      "enum": [
        "intent",
        "view",
        "component",
        "widget",
        "app"
      ],
      "type": "string",
      "description": "What to compile."
    },
    "entry": {
      "type": "object",
      "description": "Widget only. Timeline entry fields as { fieldName: typeString }.",
      "additionalProperties": {
        "type": "string",
        "description": "Swift type for this entry field: string, int, double, float, boolean, date."
      }
    },
    "props": {
      "type": "object",
      "description": "View only. Prop definitions as { fieldName: typeString }.",
      "additionalProperties": {
        "type": "string",
        "description": "Swift type for this prop: string, int, double, float, boolean, date, duration."
      }
    },
    "state": {
      "type": "object",
      "description": "View only.",
      "additionalProperties": {
        "type": "object",
        "required": [
          "type"
        ],
        "properties": {
          "type": {
            "type": "string",
            "description": "Swift type: string, int, double, float, boolean, date, duration, or url."
          },
          "default": {
            "type": "string",
            "description": "Optional default value for the @State property."
          }
        },
        "description": "State variable config with type and optional default value."
      }
    },
    "title": {
      "type": "string",
      "description": "Human-readable title shown in Shortcuts/Spotlight. Intent only."
    },
    "domain": {
      "type": "string",
      "description": "Apple App Intent domain. Intent only."
    },
    "format": {
      "type": "boolean",
      "description": "When true (default), pipes generated Swift through swift-format with Axint's."
    },
    "params": {
      "type": "object",
      "description": "Intent only. Parameter definitions as { fieldName: typeString }.",
      "additionalProperties": {
        "type": "string",
        "description": "Swift type for this parameter: string, int, double, float, boolean, date."
      }
    },
    "scenes": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "kind",
          "view"
        ],
        "properties": {
          "kind": {
            "enum": [
              "windowGroup",
              "window",
              "documentGroup",
              "settings"
            ],
            "type": "string",
            "description": "Scene type. windowGroup is most common for single-window apps."
          },
          "name": {
            "type": "string",
            "description": "Unique scene identifier for programmatic access."
          },
          "view": {
            "type": "string",
            "description": "Root SwiftUI view name, e.g., 'ContentView'. Must be defined elsewhere."
          },
          "title": {
            "type": "string",
            "description": "Window title shown in the title bar."
          },
          "platform": {
            "enum": [
              "macOS",
              "iOS",
              "visionOS"
            ],
            "type": "string",
            "description": "Platform guard — wraps scene in #if os(...). Omit for cross-platform."
          }
        },
        "description": "Scene definition with kind, view, and optional title/platform."
      },
      "description": "App only. Scene definitions for the @main App struct."
    },
    "families": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Widget family: systemSmall, systemMedium, systemLarge, systemExtraLarge."
      },
      "description": "Widget only."
    },
    "platform": {
      "enum": [
        "iOS",
        "macOS",
        "visionOS",
        "all"
      ],
      "type": "string",
      "description": "Optional target Apple platform hint for view/widget generation."
    },
    "description": {
      "type": "string",
      "description": "Description of what this intent/view/widget does."
    },
    "displayName": {
      "type": "string",
      "description": "Widget only. Human-readable name shown in the widget gallery."
    },
    "componentKind": {
      "enum": [
        "feedCard",
        "mediaCard",
        "utilityRow",
        "cardArchetypes",
        "avatar",
        "statusRing",
        "missionCard",
        "contextPanel",
        "contextUpdateCard",
        "decisionLog",
        "approvalCard",
        "agentRow",
        "roleCard",
        "signalCard",
        "channelRow",
        "sidebarRail",
        "profileCard",
        "settingsView",
        "semanticCard",
        "semanticRow",
        "semanticPill",
        "semanticPanel",
        "semanticBar",
        "semanticList",
        "custom"
      ],
      "type": "string",
      "description": "Component only. Optional known component shape."
    },
    "tokenNamespace": {
      "type": "string",
      "description": "Optional Swift token enum generated by axint.tokens.ingest, e.g., 'SwarmTokens'."
    },
    "refreshInterval": {
      "type": "number",
      "description": "Widget only. Timeline refresh interval in minutes."
    }
  }
}

{
  "type": "object",
  "properties": {
    "agent": {
      "enum": [
        "all",
        "claude",
        "codex",
        "cowork",
        "cursor",
        "xcode"
      ],
      "type": "string",
      "description": "Agent target for the session. Defaults to all."
    },
    "format": {
      "enum": [
        "markdown",
        "json"
      ],
      "type": "string",
      "description": "Output format. Defaults to markdown."
    },
    "platform": {
      "type": "string",
      "description": "Target Apple platform, such as macOS, iOS, visionOS, or all."
    },
    "targetDir": {
      "type": "string",
      "description": "Project directory where .axint/session/current.json and token-scoped session."
    },
    "ttlMinutes": {
      "type": "number",
      "description": "How long the session token remains valid. Defaults to 720 minutes."
    },
    "projectName": {
      "type": "string",
      "description": "Project name to embed in the session and returned context."
    },
    "expectedVersion": {
      "type": "string",
      "description": "Expected Axint package version. Defaults to the running MCP version."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "required": [
    "appDescription"
  ],
  "properties": {
    "mode": {
      "enum": [
        "local",
        "auto",
        "ai",
        "pro"
      ],
      "type": "string",
      "description": "Suggestion strategy. local is deterministic and offline. pro/ai uses the."
    },
    "goals": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "String value for this Axint parameter."
      },
      "description": "Optional product goals for Pro mode, such as activation, retention, conversion."
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of suggestions to return. Defaults to 5."
    },
    "stage": {
      "enum": [
        "idea",
        "prototype",
        "mvp",
        "growth",
        "enterprise",
        "unknown"
      ],
      "type": "string",
      "description": "Optional product stage used by Pro mode to tune suggestions without embedding."
    },
    "domain": {
      "type": "string",
      "description": "Primary app domain."
    },
    "exclude": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "String value for this Axint parameter."
      },
      "description": "Optional concepts to avoid, for example ['dating', 'fitness']."
    },
    "audience": {
      "type": "string",
      "description": "Optional audience context, such as consumers, teams, operators, developers."
    },
    "platform": {
      "enum": [
        "iOS",
        "macOS",
        "watchOS",
        "visionOS",
        "multi"
      ],
      "type": "string",
      "description": "Optional Apple platform target used by AI mode to tailor suggestions."
    },
    "constraints": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "String value for this Axint parameter."
      },
      "description": "Optional constraints for Pro mode, such as must be macOS-native, no server, no."
    },
    "appDescription": {
      "type": "string",
      "description": "What the app does, in natural language. E.g., 'A fitness tracking app that logs workouts and counts steps' or 'A recipe app for discovering and saving meals'."
    }
  }
}

{
  "type": "object",
  "properties": {
    "cwd": {
      "type": "string",
      "description": "Project directory where .axint/upgrade/latest.* should be written."
    },
    "apply": {
      "type": "boolean",
      "description": "Whether to install the target package."
    },
    "format": {
      "enum": [
        "markdown",
        "json",
        "prompt"
      ],
      "type": "string",
      "description": "Output format. markdown is human-readable, json is structured, and prompt is."
    },
    "writeReport": {
      "type": "boolean",
      "description": "Whether to write .axint/upgrade/latest.json and latest.md."
    },
    "latestVersion": {
      "type": "string",
      "description": "Known latest version to compare against."
    },
    "targetVersion": {
      "type": "string",
      "description": "Specific Axint version to install. Defaults to the latest published npm version."
    },
    "reinstallXcode": {
      "type": "boolean",
      "description": "Whether apply mode should also refresh optional Xcode MCP wiring."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "cwd": {
      "type": "string",
      "description": "Project directory containing .axint/session/current.json."
    },
    "agent": {
      "enum": [
        "all",
        "claude",
        "codex",
        "cowork",
        "cursor",
        "xcode"
      ],
      "type": "string",
      "description": "Agent host/tool lane for this gate."
    },
    "notes": {
      "type": "string",
      "description": "Optional human/agent context for why a step was skipped."
    },
    "stage": {
      "enum": [
        "session-start",
        "context-recovery",
        "planning",
        "before-write",
        "pre-build",
        "pre-commit"
      ],
      "type": "string",
      "description": "Workflow stage being checked. Defaults to pre-build."
    },
    "format": {
      "enum": [
        "markdown",
        "json"
      ],
      "type": "string",
      "description": "Output format. Defaults to markdown."
    },
    "surfaces": {
      "type": "array",
      "items": {
        "enum": [
          "intent",
          "view",
          "widget",
          "component",
          "app",
          "store"
        ],
        "type": "string",
        "description": "Allowed string value for this Axint parameter."
      },
      "description": "Apple surfaces touched by this task. If omitted, inferred from modifiedFiles."
    },
    "ranRepair": {
      "type": "boolean",
      "description": "Whether axint.repair was used for an existing-code repair plan."
    },
    "ranStatus": {
      "type": "boolean",
      "description": "Whether axint.status was called to confirm the running MCP version."
    },
    "ranFeature": {
      "type": "boolean",
      "description": "Whether axint.feature was used for a new surface scaffold."
    },
    "ranSuggest": {
      "type": "boolean",
      "description": "Whether axint.suggest was used during planning."
    },
    "sessionToken": {
      "type": "string",
      "description": "Token returned by axint.session.start."
    },
    "modifiedFiles": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "String value for this Axint parameter."
      },
      "description": "Files changed in this agent pass, used to infer whether Swift validation is."
    },
    "ranCloudCheck": {
      "type": "boolean",
      "description": "Whether axint.cloud.check was run with source/evidence."
    },
    "availableTools": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "String value for this Axint parameter."
      },
      "description": "Optional list of Axint MCP tools visible in this host session."
    },
    "requireSession": {
      "type": "boolean",
      "description": "Set false only for legacy/manual checks. Defaults to true."
    },
    "sessionStarted": {
      "type": "boolean",
      "description": "Whether axint.session.start was called in this chat/recovery pass."
    },
    "readDocsContext": {
      "type": "boolean",
      "description": "Whether .axint/AXINT_DOCS_CONTEXT.md was read or axint.context.docs was called."
    },
    "ranSwiftValidate": {
      "type": "boolean",
      "description": "Whether axint.swift.validate was run on modified Swift."
    },
    "xcodeBuildPassed": {
      "type": "boolean",
      "description": "Whether Xcode build evidence passed."
    },
    "xcodeTestsPassed": {
      "type": "boolean",
      "description": "Whether focused unit/UI tests passed."
    },
    "featureBypassReason": {
      "type": "string",
      "description": "Concrete reason axint.feature was intentionally bypassed."
    },
    "readAgentInstructions": {
      "type": "boolean",
      "description": "Whether AGENTS.md, CLAUDE.md, or .axint/project.json was read after a new chat."
    },
    "readRehydrationContext": {
      "type": "boolean",
      "description": "Whether .axint/AXINT_REHYDRATE.md was read after a new chat, context."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "cwd": {
      "type": "string",
      "description": "Project directory to guard. Defaults to the MCP process cwd."
    },
    "notes": {
      "type": "string",
      "description": "Agent/user notes to scan for compaction, drift, forgotten Axint usage, or."
    },
    "stage": {
      "enum": [
        "context-recovery",
        "planning",
        "before-write",
        "after-write",
        "pre-build",
        "runtime",
        "finish"
      ],
      "type": "string",
      "description": "Current Xcode workflow stage. Defaults to context-recovery."
    },
    "format": {
      "enum": [
        "markdown",
        "json"
      ],
      "type": "string",
      "description": "Output format. Defaults to markdown."
    },
    "platform": {
      "type": "string",
      "description": "Target Apple platform, such as macOS, iOS, visionOS, or all."
    },
    "projectName": {
      "type": "string",
      "description": "Project name for the guard report."
    },
    "writeReport": {
      "type": "boolean",
      "description": "Whether to write .axint/guard/latest.json and latest.md. Defaults to true."
    },
    "sessionToken": {
      "type": "string",
      "description": "Current axint.session.start token, if already known."
    },
    "lastAxintTool": {
      "type": "string",
      "description": "Last Axint tool the agent used, e.g. axint.suggest or axint.feature."
    },
    "modifiedFiles": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "String value for this Axint parameter."
      },
      "description": "Files in scope for this task."
    },
    "expectedVersion": {
      "type": "string",
      "description": "Expected Axint version for the active project."
    },
    "lastAxintResult": {
      "type": "string",
      "description": "Short result from the last Axint tool call."
    },
    "autoStartSession": {
      "type": "boolean",
      "description": "Whether to start axint.session.start automatically if no active session exists."
    },
    "maxMinutesSinceAxint": {
      "type": "number",
      "description": "Maximum allowed minutes since latest Axint evidence. Defaults to 10."
    }
  }
}