Skip to main content
Glama

Axint

by io.github.agenticempire

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.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
cwdNoProject directory containing .axint/session/current.json.
agentNoAgent host/tool lane for this gate.
notesNoOptional human/agent context for why a step was skipped.
stageNoWorkflow stage being checked. Defaults to pre-build.
formatNoOutput format. Defaults to markdown.
surfacesNoApple surfaces touched by this task. If omitted, inferred from modifiedFiles.
ranRepairNoWhether axint.repair was used for an existing-code repair plan.
ranStatusNoWhether axint.status was called to confirm the running MCP version.
ranFeatureNoWhether axint.feature was used for a new surface scaffold.
ranSuggestNoWhether axint.suggest was used during planning.
sessionTokenNoToken returned by axint.session.start.
modifiedFilesNoFiles changed in this agent pass, used to infer whether Swift validation is.
ranCloudCheckNoWhether axint.cloud.check was run with source/evidence.
availableToolsNoOptional list of Axint MCP tools visible in this host session.
requireSessionNoSet false only for legacy/manual checks. Defaults to true.
sessionStartedNoWhether axint.session.start was called in this chat/recovery pass.
readDocsContextNoWhether .axint/AXINT_DOCS_CONTEXT.md was read or axint.context.docs was called.
ranSwiftValidateNoWhether axint.swift.validate was run on modified Swift.
xcodeBuildPassedNoWhether Xcode build evidence passed.
xcodeTestsPassedNoWhether focused unit/UI tests passed.
featureBypassReasonNoConcrete reason axint.feature was intentionally bypassed.
readAgentInstructionsNoWhether AGENTS.md, CLAUDE.md, or .axint/project.json was read after a new chat.
readRehydrationContextNoWhether .axint/AXINT_REHYDRATE.md was read after a new chat, context.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
textYes
isErrorNo

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. Changed12 schema fields changed
    • changedInput schema / properties / agent / description
      Previous value: -"Agent host/tool lane for this gate. Codex/Claude/Cowork/Cursor use patch-first lanes; Xcode may use Xcode..."New value: +"Agent host/tool lane for this gate."
    • changedInput schema / properties / availableTools / description
      Previous value: -"Optional list of Axint MCP tools visible in this host session. When supplied, workflow.check will not..."New value: +"Optional list of Axint MCP tools visible in this host session."
    • changedInput schema / properties / cwd / description
      Previous value: -"Project directory containing .axint/session/current.json. Defaults to the MCP process cwd."New value: +"Project directory containing .axint/session/current.json."
    • changedInput schema / properties / featureBypassReason / description
      Previous value: -"Concrete reason axint.feature was intentionally bypassed. Use for existing-code edits, patch-first repairs,..."New value: +"Concrete reason axint.feature was intentionally bypassed."
    • changedInput schema / properties / modifiedFiles / description
      Previous value: -"Files changed in this agent pass, used to infer whether Swift validation is required."New value: +"Files changed in this agent pass, used to infer whether Swift validation is."
    • changedInput schema / properties / ranRepair / description
      Previous value: -"Whether axint.repair was used for an existing-code repair plan. This satisfies planning for patch-first..."New value: +"Whether axint.repair was used for an existing-code repair plan."
    • changedInput schema / properties / readAgentInstructions / description
      Previous value: -"Whether AGENTS.md, CLAUDE.md, or .axint/project.json was read after a new chat or context compaction."New value: +"Whether AGENTS.md, CLAUDE.md, or .axint/project.json was read after a new chat."
    • changedInput schema / properties / readDocsContext / description
      Previous value: -"Whether .axint/AXINT_DOCS_CONTEXT.md was read or axint.context.docs was called after a new chat or context..."New value: +"Whether .axint/AXINT_DOCS_CONTEXT.md was read or axint.context.docs was called."
    • changedInput schema / properties / readRehydrationContext / description
      Previous value: -"Whether .axint/AXINT_REHYDRATE.md was read after a new chat, context compaction, MCP restart, or drift."New value: +"Whether .axint/AXINT_REHYDRATE.md was read after a new chat, context."
    • changedInput schema / properties / sessionToken / description
      Previous value: -"Token returned by axint.session.start. Required by default so compaction cannot erase the Axint workflow..."New value: +"Token returned by axint.session.start."
    • removedOutput schema / properties / isError / description
      Removed value: -"Whether Axint marked the tool response as an error."
    • removedOutput schema / properties / text / description
      Removed value: -"Primary Axint tool response text, matching the first text content block."
  2. Changed19 schema fields changed
    • changedInput schema / properties / agent / description
      Previous value: -"Agent host/tool lane for this gate...."New value: +"Agent host/tool lane for this gate. Codex/Claude/Cowork/Cursor use patch-first lanes; Xcode may use Xcode..."
    • changedInput schema / properties / availableTools / description
      Previous value: -"Optional list of Axint MCP tools visible in..."New value: +"Optional list of Axint MCP tools visible in this host session. When supplied, workflow.check will not..."
    • changedInput schema / properties / cwd / description
      Previous value: -"Project directory containing .axint/session/c..."New value: +"Project directory containing .axint/session/current.json. Defaults to the MCP process cwd."
    • changedInput schema / properties / featureBypassReason / description
      Previous value: -"Concrete reason axint.feature was..."New value: +"Concrete reason axint.feature was intentionally bypassed. Use for existing-code edits, patch-first repairs,..."
    • changedInput schema / properties / modifiedFiles / description
      Previous value: -"Files changed in this agent pass, used to..."New value: +"Files changed in this agent pass, used to infer whether Swift validation is required."
    • changedInput schema / properties / notes / description
      Previous value: -"Optional human/agent context for why a step..."New value: +"Optional human/agent context for why a step was skipped."
    • changedInput schema / properties / ranCloudCheck / description
      Previous value: -"Whether axint.cloud.check was run with..."New value: +"Whether axint.cloud.check was run with source/evidence."
    • changedInput schema / properties / ranFeature / description
      Previous value: -"Whether axint.feature was used for a new..."New value: +"Whether axint.feature was used for a new surface scaffold."
    • changedInput schema / properties / ranRepair / description
      Previous value: -"Whether axint.repair was used for an..."New value: +"Whether axint.repair was used for an existing-code repair plan. This satisfies planning for patch-first..."
    • changedInput schema / properties / ranStatus / description
      Previous value: -"Whether axint.status was called to confirm..."New value: +"Whether axint.status was called to confirm the running MCP version."
    • changedInput schema / properties / ranSwiftValidate / description
      Previous value: -"Whether axint.swift.validate was run on..."New value: +"Whether axint.swift.validate was run on modified Swift."
    • changedInput schema / properties / readAgentInstructions / description
      Previous value: -"Whether AGENTS.md, CLAUDE.md, or .axint/proje..."New value: +"Whether AGENTS.md, CLAUDE.md, or .axint/project.json was read after a new chat or context compaction."
    • changedInput schema / properties / readDocsContext / description
      Previous value: -"Whether .axint/AXINT_DOCS_CONTEXT.md was..."New value: +"Whether .axint/AXINT_DOCS_CONTEXT.md was read or axint.context.docs was called after a new chat or context..."
    • changedInput schema / properties / readRehydrationContext / description
      Previous value: -"Whether .axint/AXINT_REHYDRATE.md was read..."New value: +"Whether .axint/AXINT_REHYDRATE.md was read after a new chat, context compaction, MCP restart, or drift."
    • changedInput schema / properties / requireSession / description
      Previous value: -"Set false only for legacy/manual checks...."New value: +"Set false only for legacy/manual checks. Defaults to true."
    • changedInput schema / properties / sessionStarted / description
      Previous value: -"Whether axint.session.start was called in..."New value: +"Whether axint.session.start was called in this chat/recovery pass."
    • changedInput schema / properties / sessionToken / description
      Previous value: -"Token returned by axint.session.start...."New value: +"Token returned by axint.session.start. Required by default so compaction cannot erase the Axint workflow..."
    • changedInput schema / properties / stage / description
      Previous value: -"Workflow stage being checked. Defaults to..."New value: +"Workflow stage being checked. Defaults to pre-build."
    • changedInput schema / properties / surfaces / description
      Previous value: -"Apple surfaces touched by this task. If..."New value: +"Apple surfaces touched by this task. If omitted, inferred from modifiedFiles."
  3. Changed27 schema fields changed
    • addedInput schema / properties / agent / description
      Added value: +"Agent host/tool lane for this gate...."
    • addedInput schema / properties / availableTools / description
      Added value: +"Optional list of Axint MCP tools visible in..."
    • addedInput schema / properties / availableTools / items / description
      Added value: +"String value for this Axint parameter."
    • addedInput schema / properties / cwd / description
      Added value: +"Project directory containing .axint/session/c..."
    • addedInput schema / properties / featureBypassReason / description
      Added value: +"Concrete reason axint.feature was..."
    • addedInput schema / properties / format / description
      Added value: +"Output format. Defaults to markdown."
    • addedInput schema / properties / modifiedFiles / description
      Added value: +"Files changed in this agent pass, used to..."
    • addedInput schema / properties / modifiedFiles / items / description
      Added value: +"String value for this Axint parameter."
    • addedInput schema / properties / notes / description
      Added value: +"Optional human/agent context for why a step..."
    • addedInput schema / properties / ranCloudCheck / description
      Added value: +"Whether axint.cloud.check was run with..."
    • addedInput schema / properties / ranFeature / description
      Added value: +"Whether axint.feature was used for a new..."
    • addedInput schema / properties / ranRepair / description
      Added value: +"Whether axint.repair was used for an..."
    • addedInput schema / properties / ranStatus / description
      Added value: +"Whether axint.status was called to confirm..."
    • addedInput schema / properties / ranSuggest / description
      Added value: +"Whether axint.suggest was used during planning."
    • addedInput schema / properties / ranSwiftValidate / description
      Added value: +"Whether axint.swift.validate was run on..."
    • addedInput schema / properties / readAgentInstructions / description
      Added value: +"Whether AGENTS.md, CLAUDE.md, or .axint/proje..."
    • addedInput schema / properties / readDocsContext / description
      Added value: +"Whether .axint/AXINT_DOCS_CONTEXT.md was..."
    • addedInput schema / properties / readRehydrationContext / description
      Added value: +"Whether .axint/AXINT_REHYDRATE.md was read..."
    • addedInput schema / properties / requireSession / description
      Added value: +"Set false only for legacy/manual checks...."
    • addedInput schema / properties / sessionStarted / description
      Added value: +"Whether axint.session.start was called in..."
    • addedInput schema / properties / sessionToken / description
      Added value: +"Token returned by axint.session.start...."
    • addedInput schema / properties / stage / description
      Added value: +"Workflow stage being checked. Defaults to..."
    • addedInput schema / properties / surfaces / description
      Added value: +"Apple surfaces touched by this task. If..."
    • addedInput schema / properties / surfaces / items / description
      Added value: +"Allowed string value for this Axint parameter."
    • addedInput schema / properties / xcodeBuildPassed / description
      Added value: +"Whether Xcode build evidence passed."
    • addedInput schema / properties / xcodeTestsPassed / description
      Added value: +"Whether focused unit/UI tests passed."
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
+  "additionalProperties": false,
+  "properties": {
+    "isError": {
+      "description": "Whether Axint marked the tool response as an error.",
+      "type": "boolean"
+    },
+    "text": {
+      "description": "Primary Axint tool response text, matching the first text content block.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "text"
+  ],
+  "type": "object"
+}
  4. Changed23 schema fields changed
    • addedInput schema / properties / agent
      Added value: +{
+  "enum": [
+    "all",
+    "claude",
+    "codex",
+    "cowork",
+    "cursor",
+    "xcode"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / availableTools
      Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}
    • removedInput schema / properties / cwd / description
      Removed value: -"Project directory containing .axint/session/current.json. Defaults to the MCP process cwd."
    • removedInput schema / properties / featureBypassReason / description
      Removed value: -"Concrete reason axint.feature was intentionally bypassed for a new surface. Use only for existing-code edits or when generation is not useful."
    • removedInput schema / properties / format / description
      Removed value: -"Output format. Defaults to markdown."
    • removedInput schema / properties / modifiedFiles / description
      Removed value: -"Files changed in this agent pass, used to infer whether Swift validation is required."
    • removedInput schema / properties / notes / description
      Removed value: -"Optional human/agent context for why a step was skipped."
    • removedInput schema / properties / ranCloudCheck / description
      Removed value: -"Whether axint.cloud.check was run with source/evidence."
    • removedInput schema / properties / ranFeature / description
      Removed value: -"Whether axint.feature was used for a new surface scaffold."
    • addedInput schema / properties / ranRepair
      Added value: +{
+  "type": "boolean"
+}
    • removedInput schema / properties / ranStatus / description
      Removed value: -"Whether axint.status was called to confirm the running MCP version."
    • removedInput schema / properties / ranSuggest / description
      Removed value: -"Whether axint.suggest was used during planning."
    • removedInput schema / properties / ranSwiftValidate / description
      Removed value: -"Whether axint.swift.validate was run on modified Swift."
    • removedInput schema / properties / readAgentInstructions / description
      Removed value: -"Whether AGENTS.md, CLAUDE.md, or .axint/project.json was read after a new chat or context compaction."
    • removedInput schema / properties / readDocsContext / description
      Removed value: -"Whether .axint/AXINT_DOCS_CONTEXT.md was read or axint.context.docs was called after a new chat or context compaction."
    • removedInput schema / properties / readRehydrationContext / description
      Removed value: -"Whether .axint/AXINT_REHYDRATE.md was read after a new chat, context compaction, MCP restart, or drift."
    • removedInput schema / properties / requireSession / description
      Removed value: -"Set false only for legacy/manual checks. Defaults to true."
    • removedInput schema / properties / sessionStarted / description
      Removed value: -"Whether axint.session.start was called in this chat/recovery pass."
    • removedInput schema / properties / sessionToken / description
      Removed value: -"Token returned by axint.session.start. Required by default so compaction cannot erase the Axint workflow silently."
    • removedInput schema / properties / stage / description
      Removed value: -"Workflow stage being checked. Defaults to pre-build."
    • removedInput schema / properties / surfaces / description
      Removed value: -"Apple surfaces touched by this task. If omitted, inferred from modifiedFiles."
    • removedInput schema / properties / xcodeBuildPassed / description
      Removed value: -"Whether Xcode build evidence passed."
    • removedInput schema / properties / xcodeTestsPassed / description
      Removed value: -"Whether focused unit/UI tests passed."
  5. Changed2 schema fields changed
    • addedInput schema / properties / featureBypassReason
      Added value: +{
+  "description": "Concrete reason axint.feature was intentionally bypassed for a new surface. Use only for existing-code edits or when generation is not useful.",
+  "type": "string"
+}
    • addedInput schema / properties / readRehydrationContext
      Added value: +{
+  "description": "Whether .axint/AXINT_REHYDRATE.md was read after a new chat, context compaction, MCP restart, or drift.",
+  "type": "boolean"
+}
  6. Added

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations are all false, providing no inherent behavioral hints. The description adds useful context: 'writes a local .axint/session workflow freshness stamp; edits no app source and uses no network.' This discloses side effects and safety boundaries. It could go further on failure modes or exact file format, but given the absence of annotation guidance, this is strong. No contradiction with annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences: purpose, usage, and inputs/effects. Front-loaded with the primary action, each sentence carries distinct value. No filler or redundancy. The structure makes it easy to scan.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description covers purpose, usage, preconditions, side effects, and safety boundaries (no source edits, no network). An output schema exists, so return format is covered elsewhere. The only gap is the parameter name inconsistency ('allowNoSession' vs 'requireSession'), which causes minor ambiguity. Overall, it is near-complete for a complex 23-parameter tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3. The description adds high-level semantics for a few key params ('stage selects the gate; sessionToken proves continuity; allowNoSession is an explicit escape hatch'), but it misnames the parameter: schema has 'requireSession', not 'allowNoSession'. This mismatch could mislead an agent. It also doesn't map the full set of 23 params, though that is unnecessary given schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb+resource: 'Agent workflow gate that records a local freshness stamp.' It clearly states the tool's role as a workflow gate, and explicitly distinguishes it from siblings: 'use status for version checks and run for build/test proof.' This differentiates it from tools like axint.status and axint.run.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage guidance is explicit: 'Use: use at stage gates to prove workflow coverage; use status for version checks and run for build/test proof.' This states when to use this tool and when to prefer alternates. It also specifies the session token requirement and the escape hatch via requireSession=false, setting clear preconditions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Axint toolsInspect
Try in Browser
RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

A4.1/5.0
Disambiguation4/5

Most tools have clearly distinct purposes, with descriptions specifying exact use cases (e.g., axint.activate for smoke test, axint.status for version). There is minor potential overlap between axint.suggest and axint.feature, but descriptions clarify suggestion vs generation.

Naming Consistency5/5

All tools follow a consistent hierarchical pattern: 'axint.<category>.<action>' (e.g., axint.agent.advice, axint.swift.validate). Even standalone tools like axint.compile fit the pattern. No mixing of conventions.

Tool Count2/5

36 tools is well above the typical 3-15 range for a well-scoped set. While the server covers a broad domain, the sheer number may overwhelm agents and reduce efficiency. A reduction or grouping would improve coherence.

Completeness4/5

The tool set covers the full Axint development lifecycle: installation, compilation, validation, repair, upgrade, session management, and coordination. Minor gaps exist (e.g., no dedicated tool for deleting project artifacts), but core workflows are well-supported.

Resources