Servers Playground How we check Add a server Log in

HODDS

Working · 2.9 s

ai.hodds/hoddsv0.4.0 Domain verified

Find software, SaaS and APIs for a need in a sourced catalogue organised by business process.

Productivity

Website Registry entry

Maintain this server? Claim it

Try it

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

https://hodds.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.

ack_alerts

Acknowledges alerts of one watch (alert_ids, or all: true for every alert of this watch); the only call that empties the pending delivery. Returns the number acknowledged and the number remaining for the organisation; a replay changes nothing. Needs an organisation token (Authorization: Bearer hodds_...); without it the tool returns the error token_required.

watch_idstring, required

Watch id returned by watch_need or list_watches (w_...).

allboolean

true: every alert of this watch.

alert_idsarray

Alert ids (a_...).

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

HODDS MCP server | mcptry

Tools (19)

ack_alerts

Argument	Type	Description
all	boolean	true: every alert of this watch.
watch_id*	string	Watch id returned by watch_need or list_watches (w_...).
alert_ids	array	Alert ids (a_...).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "watch_id"
  ],
  "properties": {
    "all": {
      "type": "boolean",
      "description": "true: every alert of this watch."
    },
    "watch_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Watch id returned by watch_need or list_watches (w_...)."
    },
    "alert_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 64,
        "minLength": 1
      },
      "maxItems": 200,
      "description": "Alert ids (a_...)."
    }
  },
  "additionalProperties": false
}

cancel_creator_plan

Stops the subscription at the end of the paid period. Listings, claims, declarations and ranking are unchanged; the coarse demand table stays free. Contract 0.3.1. Needs an organisation token (Authorization: Bearer hodds_...); without it the tool returns the error token_required.

destructive

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

cancel_plan

Stops the paid plan at the end of the Stripe period. Then the paid watches are CLOSED and stay readable 30 days; the free watch and the agent tokens are unchanged. Without a paid plan the tool answers not_paid. Contract 0.4.0. Needs an organisation token (Authorization: Bearer hodds_...); without it the tool returns the error token_required.

destructive

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

compare_solutions

Compare 2–3 catalogue IDs by required capabilities, offer, context and dated sources. Unknown/stale/conflict stay explicit; unknown price is never zero. Discover IDs at /api/capabilities and details at /api/solutions/{id}/specification. Costs require all assumptions. Large result: repeat arguments with view; restart on 409. Public read, no billing/business writes; one call per POST.

read-only

Argument	Type	Description
view	any
locale	any
context	any
criteria	array
priority	any
requirements	array
solution_ids*	array
cost_scenario	any
priority_required	boolean

Input schema (JSON)

find_comparable_solutions

Find alternatives by required priority, optionally relative to one solution. IDs/context: /api/capabilities. A match satisfies every requirement in one configuration. Evaluates the whole pilot before limit, separating match/unresolved/mismatch and stating catalogue coverage, not market coverage. Large result: repeat arguments with view; restart on 409. Public read, no billing/business writes; one call per POST.

read-only

Argument	Type	Description
view	any
limit	integer
locale	any
context	any
criteria	array
priority*	any
reference_id	any
requirements	array
cost_scenario	any

Input schema (JSON)

get_creator_plan

Returns the demand data subscription of the organisation of the token: plan NONE or SUBSCRIBED, subscribed processes, pending removals, the coming invoice, payment provider and invoices. €10 excl. VAT per process per month, invoiced by VORAN, paid through Stripe; no effect on ranking. Contract 0.3.1. Needs an organisation token (Authorization: Bearer hodds_...); without it the tool returns the error token_required.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

get_plan

Returns the plan of the organisation of the token: FREE, PAID, PAST_DUE, ENDING or ENDED; watched solutions billed in the current Stripe period, the coming invoice, the payment provider and the invoices. 1 watched solution free, then €0.50 per watched solution per month, €2 monthly minimum (excl. VAT), invoiced by VORAN, paid through Stripe. A paid watch is billed for a period when it is active at least one day of it, whatever the number of agents that read it. Contract 0.4.0. Needs an organisation token (Authorization: Bearer hodds_...); without it the tool returns the error token_required.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

get_solution

Returns one HODDS catalogue record by id (an option id returned by search_solutions): name, homepage, summary in English and French, processes (the first is primary), keywords, pricing models without amounts (empty means unknown) with the pricing page, interfaces (public API, MCP server, self-hosting: yes, no or unknown), markets, publisher, dated sources and status. Status non_attested means the publisher has not confirmed the record; unknown values are stated as unknown. Read-only.

read-only

Argument	Type	Description
id*	string	Solution id, e.g. "n8n".

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$",
      "maxLength": 64,
      "minLength": 1,
      "description": "Solution id, e.g. \"n8n\"."
    }
  },
  "additionalProperties": false
}

get_watch

Returns one watch of the organisation: constraints, solution in place, challenger with its switch brief and HODDS status, challenger_reason when there is none, and the 50 most recent alerts, unacknowledged first (all: true for 200). Reading does not acknowledge. Needs an organisation token (Authorization: Bearer hodds_...); without it the tool returns the error token_required.

read-only

Argument	Type	Description
all	boolean	true: the 200 most recent alerts.
watch_id*	string	Watch id returned by watch_need or list_watches (w_...).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "watch_id"
  ],
  "properties": {
    "all": {
      "type": "boolean",
      "description": "true: the 200 most recent alerts."
    },
    "watch_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Watch id returned by watch_need or list_watches (w_...)."
    }
  },
  "additionalProperties": false
}

list_gaps

Returns, for a subscribed process, the gaps formulated by HODDS and the client aggregates above the anonymity threshold (watched needs, organisations watching, NO_MATCH, current choices, constraints, challengers delivered, GAP_RESOLVED). No need text, no organisation, no agent. Contract 0.3.1. Needs an organisation token (Authorization: Bearer hodds_...); without it the tool returns the error token_required.

read-only

Argument	Type	Description
process*	string	Process id of /catalogue/processes.json.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "process"
  ],
  "properties": {
    "process": {
      "enum": [
        "automate-workflows",
        "build-ai-agents",
        "use-ai-models",
        "develop-software",
        "host-and-deploy",
        "store-and-query-data",
        "analyze-data",
        "secure-access",
        "monitor-systems",
        "collect-web-data",
        "do-accounting",
        "invoice-and-get-paid",
        "accept-online-payments",
        "business-banking",
        "manage-expenses",
        "run-payroll",
        "manage-people",
        "recruit-talent",
        "sign-documents",
        "start-a-company",
        "run-a-practice",
        "manage-customer-relationships",
        "find-leads",
        "run-email-marketing",
        "manage-social-media",
        "build-websites",
        "sell-online",
        "support-customers",
        "design-visuals",
        "produce-media",
        "improve-search-visibility",
        "manage-projects",
        "write-and-document",
        "communicate-as-a-team",
        "schedule-appointments",
        "store-and-share-files",
        "process-documents",
        "transcribe-and-translate",
        "collect-forms-and-surveys"
      ],
      "type": "string",
      "description": "Process id of /catalogue/processes.json."
    }
  },
  "additionalProperties": false
}

list_processes

Returns the HODDS process taxonomy: groups (for example "Run the business") and processes (for example "invoice-and-get-paid"), with English and French labels and the number of catalogue records per process. A process id is accepted as the `process` filter of search_solutions. Read-only.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

list_watches

Lists the watches of the organisation with their challenger and number of pending alerts; include_closed adds the watches closed in the last 30 days. Needs an organisation token (Authorization: Bearer hodds_...); without it the tool returns the error token_required.

read-only

Argument	Type	Description
include_closed	boolean	true: include watches closed in the last 30 days.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "include_closed": {
      "type": "boolean",
      "description": "true: include watches closed in the last 30 days."
    }
  },
  "additionalProperties": false
}

rate_alert

Marks one alert relevant or not_relevant, with an optional note of at most 500 characters. It never changes ranking. Needs an organisation token (Authorization: Bearer hodds_...); without it the tool returns the error token_required.

Argument	Type	Description
note	string	Optional note.
rating*	string	relevant or not_relevant.
alert_id*	string	Alert id (a_...).
watch_id*	string	Watch id returned by watch_need or list_watches (w_...).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "watch_id",
    "alert_id",
    "rating"
  ],
  "properties": {
    "note": {
      "type": "string",
      "maxLength": 500,
      "description": "Optional note."
    },
    "rating": {
      "enum": [
        "relevant",
        "not_relevant"
      ],
      "type": "string",
      "description": "relevant or not_relevant."
    },
    "alert_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Alert id (a_...)."
    },
    "watch_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Watch id returned by watch_need or list_watches (w_...)."
    }
  },
  "additionalProperties": false
}

search_solutions

Searches the HODDS catalogue of software, SaaS, APIs and online services, organised by business process, for records that match a need written in English or French (for example "transcribe my meetings" or "automatiser mes workflows"). Returns a request_id, a status and up to `limit` options; each option has an id, a label, a short description and source URLs (provenance). Ranking combines lexical matching on record names, keywords and processes with semantic similarity (multilingual embeddings on Cloudflare Workers AI), or lexical matching alone when the semantic part is unavailable; ownership or sponsorship never changes it. Confidence is always UNKNOWN: records are non-attested facts taken from publishers' public pages. Status NO_MATCH with an empty option list means that no record matches the need closely enough, or that the need belongs to a process with no record yet; results are never padded. Read-only.

read-only

Argument	Type	Description
lang	string	Language of option descriptions: "en" (default) or "fr".
need*	string	The need in natural language, English or French: the task to get done.
limit	integer	Maximum number of options to return (1-50, default 10).
process	string	Optional process id that restricts the search (ids from list_processes, e.g. "automate-workflows").

Input schema (JSON)

{
  "type": "object",
  "required": [
    "need"
  ],
  "properties": {
    "lang": {
      "enum": [
        "en",
        "fr"
      ],
      "type": "string",
      "default": "en",
      "description": "Language of option descriptions: \"en\" (default) or \"fr\"."
    },
    "need": {
      "type": "string",
      "pattern": "\\S",
      "maxLength": 500,
      "minLength": 1,
      "description": "The need in natural language, English or French: the task to get done."
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum number of options to return (1-50, default 10)."
    },
    "process": {
      "enum": [
        "automate-workflows",
        "build-ai-agents",
        "use-ai-models",
        "develop-software",
        "host-and-deploy",
        "store-and-query-data",
        "analyze-data",
        "secure-access",
        "monitor-systems",
        "collect-web-data",
        "do-accounting",
        "invoice-and-get-paid",
        "accept-online-payments",
        "business-banking",
        "manage-expenses",
        "run-payroll",
        "manage-people",
        "recruit-talent",
        "sign-documents",
        "start-a-company",
        "run-a-practice",
        "manage-customer-relationships",
        "find-leads",
        "run-email-marketing",
        "manage-social-media",
        "build-websites",
        "sell-online",
        "support-customers",
        "design-visuals",
        "produce-media",
        "improve-search-visibility",
        "manage-projects",
        "write-and-document",
        "communicate-as-a-team",
        "schedule-appointments",
        "store-and-share-files",
        "process-documents",
        "transcribe-and-translate",
        "collect-forms-and-surveys"
      ],
      "type": "string",
      "description": "Optional process id that restricts the search (ids from list_processes, e.g. \"automate-workflows\")."
    }
  },
  "additionalProperties": false
}

send_feedback

Stores a declarative outcome report for an option returned by search_solutions: outcome YES (the option met the need), PARTLY or NO, with the request_id and the option id exactly as returned. It is the only HODDS tool that writes data without a token; the watch tools (watch_need and the others) write only with an organisation token. The report is stored as an unverified caller statement and never changes ranking by itself; the same report sent twice is stored once. When feedback storage is unavailable on the deployment, the tool returns an error and stores nothing.

Argument	Type	Description
outcome*	string	YES: the option met the need. PARTLY: in part. NO: it did not.
option_id*	string	id of the option being reported.
request_id*	string	request_id returned by search_solutions (req_...).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "request_id",
    "option_id",
    "outcome"
  ],
  "properties": {
    "outcome": {
      "enum": [
        "YES",
        "PARTLY",
        "NO"
      ],
      "type": "string",
      "description": "YES: the option met the need. PARTLY: in part. NO: it did not."
    },
    "option_id": {
      "type": "string",
      "pattern": "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$",
      "maxLength": 64,
      "minLength": 1,
      "description": "id of the option being reported."
    },
    "request_id": {
      "type": "string",
      "pattern": "^req_[A-Za-z0-9_-]{1,64}$",
      "maxLength": 68,
      "minLength": 5,
      "description": "request_id returned by search_solutions (req_...)."
    }
  },
  "additionalProperties": false
}

set_creator_processes

Replaces the list of subscribed processes. Without an active subscription the result has status 402 and a Stripe Checkout destination for a person to open. With one, an addition through this tool also answers status 402 with the Plan page as destination: nothing is charged here, only the page charges, after a person confirms it. Removals apply at once and the removed processes stay readable until the end of the paid period. An empty list is refused (empty_selection): use cancel_creator_plan. Contract 0.3.1. Needs an organisation token (Authorization: Bearer hodds_...); without it the tool returns the error token_required.

Argument	Type	Description
processes*	array

Input schema (JSON)

{
  "type": "object",
  "required": [
    "processes"
  ],
  "properties": {
    "processes": {
      "type": "array",
      "items": {
        "enum": [
          "automate-workflows",
          "build-ai-agents",
          "use-ai-models",
          "develop-software",
          "host-and-deploy",
          "store-and-query-data",
          "analyze-data",
          "secure-access",
          "monitor-systems",
          "collect-web-data",
          "do-accounting",
          "invoice-and-get-paid",
          "accept-online-payments",
          "business-banking",
          "manage-expenses",
          "run-payroll",
          "manage-people",
          "recruit-talent",
          "sign-documents",
          "start-a-company",
          "run-a-practice",
          "manage-customer-relationships",
          "find-leads",
          "run-email-marketing",
          "manage-social-media",
          "build-websites",
          "sell-online",
          "support-customers",
          "design-visuals",
          "produce-media",
          "improve-search-visibility",
          "manage-projects",
          "write-and-document",
          "communicate-as-a-team",
          "schedule-appointments",
          "store-and-share-files",
          "process-documents",
          "transcribe-and-translate",
          "collect-forms-and-surveys"
        ],
        "type": "string",
        "description": "Process id of /catalogue/processes.json."
      },
      "maxItems": 60
    }
  },
  "additionalProperties": false
}

set_current_choice

Sets a solution by id or free name (any process), null clears. Returns the watch; challenger recomputed later. Needs an organisation token (Authorization: Bearer hodds_...); without it the tool returns the error token_required.

Argument	Type	Description
watch_id*	string	Watch id returned by watch_need or list_watches (w_...).
current_choice	string \| null	Catalogue id, or null.
current_choice_name	string \| null	Free name instead of id, or null.

Input schema (JSON)

{
  "type": "object",
  "anyOf": [
    {
      "required": [
        "current_choice"
      ]
    },
    {
      "required": [
        "current_choice_name"
      ]
    }
  ],
  "required": [
    "watch_id"
  ],
  "properties": {
    "watch_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Watch id returned by watch_need or list_watches (w_...)."
    },
    "current_choice": {
      "type": [
        "string",
        "null"
      ],
      "maxLength": 64,
      "description": "Catalogue id, or null."
    },
    "current_choice_name": {
      "type": [
        "string",
        "null"
      ],
      "maxLength": 120,
      "description": "Free name instead of id, or null."
    }
  },
  "additionalProperties": false
}

unwatch_need

Closes a watch; its need, constraints and alerts are erased 30 days after closing. Needs an organisation token (Authorization: Bearer hodds_...); without it the tool returns the error token_required.

destructive

Argument	Type	Description
watch_id*	string	Watch id returned by watch_need or list_watches (w_...).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "watch_id"
  ],
  "properties": {
    "watch_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Watch id returned by watch_need or list_watches (w_...)."
    }
  },
  "additionalProperties": false
}

watch_need

Opens a watch on a need for the organisation of the token: constraints and software by id or name (any process). CATEGORY follows a process. Returns the watch, initially not_computed; public rules produce a challenger and switch brief. Alerts arrive on following calls; unknown constraints stay uninterpreted. The FREE plan follows one active watch per organisation. Error codes beyond the free watch: free_watch_used (no paid plan; destination = Stripe Checkout), plan_ending (the paid plan is stopped: no new paid watch; destination = the Plan page /my/plan), in _meta["ai.hodds/error"]. Price: search is free; 1 watched solution free, then €0.50 per watched solution per month, €2 monthly minimum (excl. VAT); a 409 with destination is resolved by a person who opens that URL. Needs an organisation token (Authorization: Bearer hodds_...); without it the tool returns the error token_required.

Argument	Type	Description
lang	string	Language of the summary: "en" or "fr".
need	string	The need in natural language, English or French (absent for a CATEGORY watch).
level	string	NEED (default when need is given) or CATEGORY (process required, no need).
context	object
process	string	Process id (from list_processes); deduced from the need when absent.
delivery	object
alert_budget	integer

{
  "type": "object",
  "$defs": {
    "Id": {
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9._-]*$",
      "maxLength": 64,
      "minLength": 1
    },
    "Count": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0
    },
    "Context": {
      "type": "object",
      "required": [],
      "properties": {
        "market": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^[A-Z]{2}$"
            },
            {
              "type": "null"
            }
          ]
        },
        "channel": {
          "anyOf": [
            {
              "enum": [
                "ui",
                "api",
                "mcp"
              ]
            },
            {
              "type": "null"
            }
          ]
        },
        "version": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 120
            },
            {
              "type": "null"
            }
          ]
        },
        "activity": {
          "anyOf": [
            {
              "$ref": "#/$defs/Id"
            },
            {
              "type": "null"
            }
          ]
        },
        "audience": {
          "anyOf": [
            {
              "$ref": "#/$defs/Id"
            },
            {
              "type": "null"
            }
          ]
        },
        "deployment": {
          "anyOf": [
            {
              "enum": [
                "cloud",
                "self_hosted",
                "desktop",
                "mobile"
              ]
            },
            {
              "type": "null"
            }
          ]
        },
        "tax_regime": {
          "anyOf": [
            {
              "$ref": "#/$defs/Id"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "additionalProperties": false
    },
    "Scenario": {
      "type": "object",
      "required": [
        "currency",
        "tax_basis",
        "users",
        "start_date",
        "horizon_months",
        "max_commitment_months",
        "billing_periods",
        "allow_current_price_projection",
        "usage"
      ],
      "properties": {
        "usage": {
          "type": "object",
          "maxProperties": 10,
          "propertyNames": {
            "$ref": "#/$defs/Id"
          },
          "additionalProperties": {
            "type": "array",
            "items": {
              "type": "integer",
              "maximum": 1000000000,
              "minimum": 0
            },
            "maxItems": 36,
            "minItems": 1
          }
        },
        "users": {
          "type": "integer",
          "maximum": 10000,
          "minimum": 1
        },
        "currency": {
          "type": "string",
          "pattern": "^[A-Z]{3}$"
        },
        "tax_basis": {
          "enum": [
            "excluding_tax",
            "including_tax"
          ]
        },
        "start_date": {
          "type": "string",
          "format": "date"
        },
        "horizon_months": {
          "type": "integer",
          "maximum": 36,
          "minimum": 1
        },
        "billing_periods": {
          "type": "array",
          "items": {
            "enum": [
              "monthly",
              "yearly"
            ]
          },
          "maxItems": 2,
          "minItems": 1,
          "uniqueItems": true
        },
        "max_commitment_months": {
          "type": "integer",
          "maximum": 36,
          "minimum": 1
        },
        "allow_current_price_projection": {
          "type": "boolean"
        }
      },
      "additionalProperties": false
    },
    "Predicate": {
      "type": "object",
      "required": [
        "capability_id",
        "operator",
        "value"
      ],
      "properties": {
        "value": {
          "anyOf": [
            {
              "type": [
                "boolean",
                "string",
                "integer"
              ]
            },
            {
              "type": "array",
              "items": {
                "$ref": "#/$defs/Id"
              },
              "maxItems": 20,
              "minItems": 1,
              "uniqueItems": true
            },
            {
              "type": "object",
              "required": [
                "minor",
                "currency",
                "tax_basis"
              ],
              "properties": {
                "minor": {
                  "$ref": "#/$defs/Count"
                },
                "currency": {
                  "type": "string",
                  "pattern": "^[A-Z]{3}$"
                },
                "tax_basis": {
                  "enum": [
                    "excluding_tax",
                    "including_tax"
                  ]
                }
              },
              "additionalProperties": false
            }
          ]
        },
        "operator": {
          "enum": [
            "equals",
            "at_least",
            "at_most",
            "contains"
          ]
        },
        "capability_id": {
          "$ref": "#/$defs/Id"
        }
      },
      "additionalProperties": false
    },
    "ComparisonView": {
      "type": "object",
      "required": [
        "result_id",
        "field",
        "offset"
      ],
      "properties": {
        "field": {
          "type": "string",
          "pattern": "^(?:|/(?:[^~]|~[01])*)$",
          "maxLength": 4096
        },
        "offset": {
          "type": "integer",
          "maximum": 999999,
          "minimum": 0
        },
        "result_id": {
          "type": "string",
          "pattern": "^sha256:[a-f0-9]{64}$"
        }
      },
      "additionalProperties": false
    }
  },
  "required": [
    "solution_ids"
  ],
  "properties": {
    "view": {
      "$ref": "#/$defs/ComparisonView"
    },
    "locale": {
      "enum": [
        "en",
        "fr"
      ]
    },
    "context": {
      "$ref": "#/$defs/Context"
    },
    "criteria": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Id"
      },
      "maxItems": 20,
      "minItems": 0,
      "uniqueItems": true
    },
    "priority": {
      "anyOf": [
        {
          "$ref": "#/$defs/Predicate"
        },
        {
          "type": "null"
        }
      ]
    },
    "requirements": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Predicate"
      },
      "maxItems": 20,
      "minItems": 0,
      "uniqueItems": true
    },
    "solution_ids": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Id"
      },
      "maxItems": 3,
      "minItems": 2,
      "uniqueItems": true
    },
    "cost_scenario": {
      "anyOf": [
        {
          "$ref": "#/$defs/Scenario"
        },
        {
          "type": "null"
        }
      ]
    },
    "priority_required": {
      "type": "boolean"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$defs": {
    "Id": {
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9._-]*$",
      "maxLength": 64,
      "minLength": 1
    },
    "Count": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0
    },
    "Context": {
      "type": "object",
      "required": [],
      "properties": {
        "market": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^[A-Z]{2}$"
            },
            {
              "type": "null"
            }
          ]
        },
        "channel": {
          "anyOf": [
            {
              "enum": [
                "ui",
                "api",
                "mcp"
              ]
            },
            {
              "type": "null"
            }
          ]
        },
        "version": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 120
            },
            {
              "type": "null"
            }
          ]
        },
        "activity": {
          "anyOf": [
            {
              "$ref": "#/$defs/Id"
            },
            {
              "type": "null"
            }
          ]
        },
        "audience": {
          "anyOf": [
            {
              "$ref": "#/$defs/Id"
            },
            {
              "type": "null"
            }
          ]
        },
        "deployment": {
          "anyOf": [
            {
              "enum": [
                "cloud",
                "self_hosted",
                "desktop",
                "mobile"
              ]
            },
            {
              "type": "null"
            }
          ]
        },
        "tax_regime": {
          "anyOf": [
            {
              "$ref": "#/$defs/Id"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "additionalProperties": false
    },
    "Scenario": {
      "type": "object",
      "required": [
        "currency",
        "tax_basis",
        "users",
        "start_date",
        "horizon_months",
        "max_commitment_months",
        "billing_periods",
        "allow_current_price_projection",
        "usage"
      ],
      "properties": {
        "usage": {
          "type": "object",
          "maxProperties": 10,
          "propertyNames": {
            "$ref": "#/$defs/Id"
          },
          "additionalProperties": {
            "type": "array",
            "items": {
              "type": "integer",
              "maximum": 1000000000,
              "minimum": 0
            },
            "maxItems": 36,
            "minItems": 1
          }
        },
        "users": {
          "type": "integer",
          "maximum": 10000,
          "minimum": 1
        },
        "currency": {
          "type": "string",
          "pattern": "^[A-Z]{3}$"
        },
        "tax_basis": {
          "enum": [
            "excluding_tax",
            "including_tax"
          ]
        },
        "start_date": {
          "type": "string",
          "format": "date"
        },
        "horizon_months": {
          "type": "integer",
          "maximum": 36,
          "minimum": 1
        },
        "billing_periods": {
          "type": "array",
          "items": {
            "enum": [
              "monthly",
              "yearly"
            ]
          },
          "maxItems": 2,
          "minItems": 1,
          "uniqueItems": true
        },
        "max_commitment_months": {
          "type": "integer",
          "maximum": 36,
          "minimum": 1
        },
        "allow_current_price_projection": {
          "type": "boolean"
        }
      },
      "additionalProperties": false
    },
    "Predicate": {
      "type": "object",
      "required": [
        "capability_id",
        "operator",
        "value"
      ],
      "properties": {
        "value": {
          "anyOf": [
            {
              "type": [
                "boolean",
                "string",
                "integer"
              ]
            },
            {
              "type": "array",
              "items": {
                "$ref": "#/$defs/Id"
              },
              "maxItems": 20,
              "minItems": 1,
              "uniqueItems": true
            },
            {
              "type": "object",
              "required": [
                "minor",
                "currency",
                "tax_basis"
              ],
              "properties": {
                "minor": {
                  "$ref": "#/$defs/Count"
                },
                "currency": {
                  "type": "string",
                  "pattern": "^[A-Z]{3}$"
                },
                "tax_basis": {
                  "enum": [
                    "excluding_tax",
                    "including_tax"
                  ]
                }
              },
              "additionalProperties": false
            }
          ]
        },
        "operator": {
          "enum": [
            "equals",
            "at_least",
            "at_most",
            "contains"
          ]
        },
        "capability_id": {
          "$ref": "#/$defs/Id"
        }
      },
      "additionalProperties": false
    },
    "ComparisonView": {
      "type": "object",
      "required": [
        "result_id",
        "field",
        "offset"
      ],
      "properties": {
        "field": {
          "type": "string",
          "pattern": "^(?:|/(?:[^~]|~[01])*)$",
          "maxLength": 4096
        },
        "offset": {
          "type": "integer",
          "maximum": 999999,
          "minimum": 0
        },
        "result_id": {
          "type": "string",
          "pattern": "^sha256:[a-f0-9]{64}$"
        }
      },
      "additionalProperties": false
    }
  },
  "required": [
    "priority"
  ],
  "properties": {
    "view": {
      "$ref": "#/$defs/ComparisonView"
    },
    "limit": {
      "type": "integer",
      "default": 5,
      "maximum": 20,
      "minimum": 1
    },
    "locale": {
      "enum": [
        "en",
        "fr"
      ]
    },
    "context": {
      "$ref": "#/$defs/Context"
    },
    "criteria": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Id"
      },
      "maxItems": 20,
      "minItems": 0,
      "uniqueItems": true
    },
    "priority": {
      "$ref": "#/$defs/Predicate"
    },
    "reference_id": {
      "anyOf": [
        {
          "$ref": "#/$defs/Id"
        },
        {
          "type": "null"
        }
      ]
    },
    "requirements": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Predicate"
      },
      "maxItems": 20,
      "minItems": 0,
      "uniqueItems": true
    },
    "cost_scenario": {
      "anyOf": [
        {
          "$ref": "#/$defs/Scenario"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "lang": {
      "enum": [
        "en",
        "fr"
      ],
      "type": "string",
      "description": "Language of the summary: \"en\" or \"fr\"."
    },
    "need": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 1,
      "description": "The need in natural language, English or French (absent for a CATEGORY watch)."
    },
    "level": {
      "enum": [
        "NEED",
        "CATEGORY"
      ],
      "type": "string",
      "description": "NEED (default when need is given) or CATEGORY (process required, no need)."
    },
    "context": {
      "type": "object",
      "properties": {
        "constraints": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 200
          },
          "maxItems": 50,
          "description": "Constraints of the need."
        },
        "environment": {
          "type": "string",
          "maxLength": 200,
          "description": "Free description of the environment (not stored)."
        }
      },
      "additionalProperties": false
    },
    "process": {
      "enum": [
        "automate-workflows",
        "build-ai-agents",
        "use-ai-models",
        "develop-software",
        "host-and-deploy",
        "store-and-query-data",
        "analyze-data",
        "secure-access",
        "monitor-systems",
        "collect-web-data",
        "do-accounting",
        "invoice-and-get-paid",
        "accept-online-payments",
        "business-banking",
        "manage-expenses",
        "run-payroll",
        "manage-people",
        "recruit-talent",
        "sign-documents",
        "start-a-company",
        "run-a-practice",
        "manage-customer-relationships",
        "find-leads",
        "run-email-marketing",
        "manage-social-media",
        "build-websites",
        "sell-online",
        "support-customers",
        "design-visuals",
        "produce-media",
        "improve-search-visibility",
        "manage-projects",
        "write-and-document",
        "communicate-as-a-team",
        "schedule-appointments",
        "store-and-share-files",
        "process-documents",
        "transcribe-and-translate",
        "collect-forms-and-surveys"
      ],
      "type": "string",
      "description": "Process id (from list_processes); deduced from the need when absent."
    },
    "delivery": {
      "type": "object",
      "properties": {
        "mode": {
          "type": "string",
          "description": "next_call (the only mode)."
        }
      },
      "additionalProperties": false
    },
    "alert_budget": {
      "type": "integer",
      "default": 5,
      "maximum": 20,
      "minimum": 1,
      "description": "Alerts per calendar month (1-20, default 5); beyond, one DIGEST per day."
    },
    "current_choice": {
      "type": "string",
      "pattern": "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$",
      "maxLength": 64,
      "minLength": 1,
      "description": "Active catalogue id; any process accepted."
    },
    "current_choice_name": {
      "type": [
        "string",
        "null"
      ],
      "maxLength": 120,
      "description": "Free name instead of id; exact unique matches resolve, others stay unlinked."
    }
  },
  "additionalProperties": false
}