Skip to main content
Glama

axint.suggest

Read-onlyIdempotent

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.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
modeNoSuggestion strategy. local is deterministic and offline. pro/ai uses the.
goalsNoOptional product goals for Pro mode, such as activation, retention, conversion.
limitNoMaximum number of suggestions to return. Defaults to 5.
stageNoOptional product stage used by Pro mode to tune suggestions without embedding.
domainNoPrimary app domain.
excludeNoOptional concepts to avoid, for example ['dating', 'fitness'].
audienceNoOptional audience context, such as consumers, teams, operators, developers.
platformNoOptional Apple platform target used by AI mode to tailor suggestions.
constraintsNoOptional constraints for Pro mode, such as must be macOS-native, no server, no.
appDescriptionYesWhat 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'.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
textYes
isErrorNo

Schema Changelog

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

  1. Changed10 schema fields changed
    • changedInput schema / properties / appDescription / description
      Previous value: -"What the app does, in natural language. E.g., 'A fitness tracking app that logs workouts and counts steps'..."New value: +"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'."
    • changedInput schema / properties / audience / description
      Previous value: -"Optional audience context, such as consumers, teams, operators, developers, clinicians, creators, or..."New value: +"Optional audience context, such as consumers, teams, operators, developers."
    • changedInput schema / properties / constraints / description
      Previous value: -"Optional constraints for Pro mode, such as must be macOS-native, no server, no payments, or build in one..."New value: +"Optional constraints for Pro mode, such as must be macOS-native, no server, no."
    • changedInput schema / properties / domain / description
      Previous value: -"Primary app domain. One of: messaging, productivity, health, social, community, collaboration,..."New value: +"Primary app domain."
    • changedInput schema / properties / goals / description
      Previous value: -"Optional product goals for Pro mode, such as activation, retention, conversion, speed, accessibility, or..."New value: +"Optional product goals for Pro mode, such as activation, retention, conversion."
    • changedInput schema / properties / limit / description
      Previous value: -"Maximum number of suggestions to return. Defaults to 5. Suggestions are ordered by estimated user impact."New value: +"Maximum number of suggestions to return. Defaults to 5."
    • changedInput schema / properties / mode / description
      Previous value: -"Suggestion strategy. local is deterministic and offline. pro/ai uses the authenticated Axint Pro..."New value: +"Suggestion strategy. local is deterministic and offline. pro/ai uses the."
    • changedInput schema / properties / stage / description
      Previous value: -"Optional product stage used by Pro mode to tune suggestions without embedding private strategy logic in the..."New value: +"Optional product stage used by Pro mode to tune suggestions without embedding."
    • 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. Changed10 schema fields changed
    • changedInput schema / properties / appDescription / description
      Previous value: -"What the app does, in natural language...."New value: +"What the app does, in natural language. E.g., 'A fitness tracking app that logs workouts and counts steps'..."
    • changedInput schema / properties / audience / description
      Previous value: -"Optional audience context, such as..."New value: +"Optional audience context, such as consumers, teams, operators, developers, clinicians, creators, or..."
    • changedInput schema / properties / constraints / description
      Previous value: -"Optional constraints for Pro mode, such as..."New value: +"Optional constraints for Pro mode, such as must be macOS-native, no server, no payments, or build in one..."
    • changedInput schema / properties / domain / description
      Previous value: -"Primary app domain. One of: messaging,..."New value: +"Primary app domain. One of: messaging, productivity, health, social, community, collaboration,..."
    • changedInput schema / properties / exclude / description
      Previous value: -"Optional concepts to avoid, for example..."New value: +"Optional concepts to avoid, for example ['dating', 'fitness']."
    • changedInput schema / properties / goals / description
      Previous value: -"Optional product goals for Pro mode, such as..."New value: +"Optional product goals for Pro mode, such as activation, retention, conversion, speed, accessibility, or..."
    • changedInput schema / properties / limit / description
      Previous value: -"Maximum number of suggestions to return...."New value: +"Maximum number of suggestions to return. Defaults to 5. Suggestions are ordered by estimated user impact."
    • changedInput schema / properties / mode / description
      Previous value: -"Suggestion strategy. local is deterministic..."New value: +"Suggestion strategy. local is deterministic and offline. pro/ai uses the authenticated Axint Pro..."
    • changedInput schema / properties / platform / description
      Previous value: -"Optional Apple platform target used by AI..."New value: +"Optional Apple platform target used by AI mode to tailor suggestions."
    • changedInput schema / properties / stage / description
      Previous value: -"Optional product stage used by Pro mode to..."New value: +"Optional product stage used by Pro mode to tune suggestions without embedding private strategy logic in the..."
  3. Changed14 schema fields changed
    • addedInput schema / properties / appDescription / description
      Added value: +"What the app does, in natural language...."
    • addedInput schema / properties / audience / description
      Added value: +"Optional audience context, such as..."
    • addedInput schema / properties / constraints / description
      Added value: +"Optional constraints for Pro mode, such as..."
    • addedInput schema / properties / constraints / items / description
      Added value: +"String value for this Axint parameter."
    • addedInput schema / properties / domain / description
      Added value: +"Primary app domain. One of: messaging,..."
    • addedInput schema / properties / exclude / description
      Added value: +"Optional concepts to avoid, for example..."
    • addedInput schema / properties / exclude / items / description
      Added value: +"String value for this Axint parameter."
    • addedInput schema / properties / goals / description
      Added value: +"Optional product goals for Pro mode, such as..."
    • addedInput schema / properties / goals / items / description
      Added value: +"String value for this Axint parameter."
    • addedInput schema / properties / limit / description
      Added value: +"Maximum number of suggestions to return...."
    • addedInput schema / properties / mode / description
      Added value: +"Suggestion strategy. local is deterministic..."
    • addedInput schema / properties / platform / description
      Added value: +"Optional Apple platform target used by AI..."
    • addedInput schema / properties / stage / description
      Added value: +"Optional product stage used by Pro mode to..."
    • 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. Changed10 schema fields changed
    • removedInput schema / properties / appDescription / description
      Removed value: -"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'. Used to suggest relevant Apple-native features."
    • removedInput schema / properties / audience / description
      Removed value: -"Optional audience context, such as consumers, teams, operators, developers, clinicians, creators, or enterprise buyers."
    • removedInput schema / properties / constraints / description
      Removed value: -"Optional constraints for Pro mode, such as must be macOS-native, no server, no payments, or build in one session."
    • removedInput schema / properties / domain / description
      Removed value: -"Primary app domain. One of: messaging, productivity, health, social, community, collaboration, developer-tools, food, education, creative, finance, commerce, media, navigation, smart-home. Treated as a weak hint, not an override."
    • removedInput schema / properties / exclude / description
      Removed value: -"Optional concepts to avoid, for example ['dating', 'fitness']."
    • removedInput schema / properties / goals / description
      Removed value: -"Optional product goals for Pro mode, such as activation, retention, conversion, speed, accessibility, or investor readiness."
    • removedInput schema / properties / limit / description
      Removed value: -"Maximum number of suggestions to return. Defaults to 5. Suggestions are ordered by estimated user impact."
    • removedInput schema / properties / mode / description
      Removed value: -"Suggestion strategy. local is deterministic and offline. pro/ai uses the authenticated Axint Pro intelligence endpoint. auto uses Pro only when AXINT_PRO_INSIGHTS=1."
    • removedInput schema / properties / platform / description
      Removed value: -"Optional Apple platform target used by AI mode to tailor suggestions."
    • removedInput schema / properties / stage / description
      Removed value: -"Optional product stage used by Pro mode to tune suggestions without embedding private strategy logic in the compiler."
  5. Changed8 schema fields changed
    • addedInput schema / properties / audience
      Added value: +{
      +  "description": "Optional audience context, such as consumers, teams, operators, developers, clinicians, creators, or enterprise buyers.",
      +  "type": "string"
      +}
    • addedInput schema / properties / constraints
      Added value: +{
      +  "description": "Optional constraints for Pro mode, such as must be macOS-native, no server, no payments, or build in one session.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • changedInput schema / properties / domain / description
      Previous value: -"Primary app domain. One of: messaging, productivity, health, finance, commerce, media, navigation, smart-home. If provided, suggestions are tailored to this domain."New value: +"Primary app domain. One of: messaging, productivity, health, social, community, collaboration, developer-tools, food, education, creative, finance, commerce, media, navigation, smart-home. Treated as a weak hint, not an override."
    • addedInput schema / properties / exclude
      Added value: +{
      +  "description": "Optional concepts to avoid, for example ['dating', 'fitness'].",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / goals
      Added value: +{
      +  "description": "Optional product goals for Pro mode, such as activation, retention, conversion, speed, accessibility, or investor readiness.",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / mode
      Added value: +{
      +  "description": "Suggestion strategy. local is deterministic and offline. pro/ai uses the authenticated Axint Pro intelligence endpoint. auto uses Pro only when AXINT_PRO_INSIGHTS=1.",
      +  "enum": [
      +    "local",
      +    "auto",
      +    "ai",
      +    "pro"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / platform
      Added value: +{
      +  "description": "Optional Apple platform target used by AI mode to tailor suggestions.",
      +  "enum": [
      +    "iOS",
      +    "macOS",
      +    "watchOS",
      +    "visionOS",
      +    "multi"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / stage
      Added value: +{
      +  "description": "Optional product stage used by Pro mode to tune suggestions without embedding private strategy logic in the compiler.",
      +  "enum": [
      +    "idea",
      +    "prototype",
      +    "mvp",
      +    "growth",
      +    "enterprise",
      +    "unknown"
      +  ],
      +  "type": "string"
      +}
  6. Changed3 schema fields changed
    • changedInput schema / properties / appDescription / description
      Previous value: -"What the app does, in natural language. E.g., 'A fitness tracking app that logs workouts and counts steps'. Used to suggest relevant Apple-native features."New value: +"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'. Used to suggest relevant Apple-native features."
    • changedInput schema / properties / domain / description
      Previous value: -"Primary app domain. One of: messaging, productivity, health, finance, commerce, media, navigation, smart-home."New value: +"Primary app domain. One of: messaging, productivity, health, finance, commerce, media, navigation, smart-home. If provided, suggestions are tailored to this domain."
    • changedInput schema / properties / limit / description
      Previous value: -"Maximum number of suggestions to return. Defaults to 5."New value: +"Maximum number of suggestions to return. Defaults to 5. Suggestions are ordered by estimated user impact."
  7. Added

TDQS

A4.5/5.0
Behavior5/5

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

The description discloses behavior beyond the annotations: 'local mode is read-only; Pro mode may call Axint endpoint when credentials are configured.' This nuances the readOnlyHint, clarifying that Pro mode may have external side effects. It also explains input weighting ('domain is only a weak hint; the app description wins'). 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.

Conciseness4/5

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

The description is well-structured with 'Use:', 'Inputs:', 'Effects:' sections and front-loaded with the core function. It is somewhat verbose but each section has a purpose. The stray 'prompt/dir' input reference could have been omitted, but overall it remains readable and useful.

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?

Given the tool has 10 parameters and an output schema, the description covers the essentials: return format, mode behavior, and usage context. It does not need to explain return values due to the output schema. The minor parameter mismatch prevents a perfect score, but the description is largely complete for an agent to decide and invoke the 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?

The schema has 100% description coverage, so the baseline is 3. The description does add useful context, e.g., appDescription takes precedence over domain. However, it mentions 'prompt is the product brief; dir adds project context', which are not actual parameters in the schema, potentially misleading the agent. This inconsistency prevents a higher score.

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 clearly states the tool's purpose: 'Suggest Apple-native features for an app based on its description.' It uses a specific verb ('suggest') and resource ('Apple-native features'), and specifies the input basis ('app description'). It also distinguishes from siblings by noting it is 'not a substitute for registry search or validation.'

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?

Provides explicit usage guidance: 'Use: use before generation to choose Apple surfaces; not a substitute for registry search or validation.' This tells the agent when to use it and what it is not for. Also clarifies Pro mode is used only when configured, setting expectations.

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

Try in Browser

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.