agentery

{'type': 'object', 'required': ['provider_ids'], 'properties': {'task': {'type': 'string', 'description': "Optional. The buyer's job in plain words; used as the service_view heading."}, 'service': {'enum': ['supplier-verification', 'contract-review', 'developer-capabilities', 'cheaper-alternatives'], 'type': 'string', 'description': 'Optional. A service recipe whose fixed requirements and evidence fields are applied (see service_view.requirements).'}, 'optional': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Optional preferences: reported in service_view but never gating.'}, 'provider_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': '2-6 provider handles from search_providers/market_gaps, e.g. ["openhands","lexaclaw"]'}, 'requirements': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Optional. Mandatory requirements as plain phrases (e.g. "sanctions screening", "documented MCP interface"). Adds an ADDITIVE service_view: per-provider evidence matrix from stored first-party page text — supported / not_supported / unknown with the excerpt and observation date; unknown never means unsupported.'}}}

{'type': 'object', 'properties': {'add': {'type': 'array', 'items': {'type': 'string'}, 'description': 'members to add'}, 'name': {'type': 'string', 'description': 'Optional private label'}, 'remove': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Mode B: members to drop from the forked market'}, 'members': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Mode A: exact handles (preferred), product names or domains'}, 'base_niche': {'type': 'string', 'description': 'Mode B: slug of the canonical market to fork'}, 'allow_partial': {'type': 'boolean', 'description': "Create with only the resolved members when some inputs don't resolve (default false)"}}}

{'type': 'object', 'required': ['benchmark_id'], 'properties': {'benchmark_id': {'type': 'string', 'description': 'Your cb_ token'}}}

{'type': 'object', 'properties': {'limit': {'type': 'number', 'description': 'Max signals (1-50, default 20)'}}}

{'type': 'object', 'required': ['task'], 'properties': {'task': {'type': 'string', 'description': 'REQUIRED. A natural-language task, capability or service in plain words, e.g. \'reconcile supplier invoices\'. Call as {"task": "…"}; an empty call returns status needs_input with an example and searches nothing.'}, 'query': {'type': 'string', 'description': 'Alias for task (back-compat only) — prefer task'}}}

{'type': 'object', 'required': ['benchmark_id'], 'properties': {'as_of': {'type': 'string', 'description': "Optional YYYY-MM-DD — reproduce the exact stats + index as they were on that date, using this version's fixed membership"}, 'version': {'type': 'number', 'description': 'Optional benchmark version (default latest)'}, 'benchmark_id': {'type': 'string', 'description': 'Your cb_ token (bearer secret; passed as an argument, never a URL)'}, 'response_mode': {'enum': ['summary', 'full'], 'type': 'string', 'description': 'full includes the index series'}}}

{'type': 'object', 'properties': {'tier': {'enum': ['all', 'individual', 'pro', 'team', 'enterprise'], 'type': 'string', 'description': "Filter to one buyer tier ('team' = Team/SME). Default 'all'."}, 'benchmark_id': {'type': 'string', 'description': "Optional: a private custom benchmark token (cb_…) from create_custom_benchmark — returns that cohort's current index instead of the economy index. Cannot be combined with niche."}, 'provider_type': {'enum': ['all', 'agent', 'mcp', 'subscription', 'hybrid', 'one_off', 'payg'], 'type': 'string', 'description': "'all' (default) = the combined whole-economy index; 'agent' or 'mcp' = the standalone index over just that delivery type (own base 100); 'payg' = the standalone pay-as-you-go sub-index (usage rates purchasable without a subscription, engine v2). Agents and MCPs price and move differently, so an MCP buyer should read the 'mcp' index and an agent buyer the 'agent' index."}, 'response_mode': {'enum': ['summary', 'full'], 'type': 'string', 'description': "'summary' (default) or 'full' (adds exact sub-0.01% moves and repricing counts)."}}}

{'type': 'object', 'properties': {'tier': {'enum': ['all', 'individual', 'pro', 'team', 'enterprise'], 'type': 'string', 'description': "Return one buyer tier's series ('team' = Team/SME). Default 'all' = the headline series."}, 'period': {'enum': ['30d', '90d', 'all'], 'type': 'string', 'description': "History window. Default '30d'."}, 'benchmark_id': {'type': 'string', 'description': "Optional: a private custom benchmark token (cb_…) — returns that cohort's dated series instead of the economy series. Cannot be combined with niche."}, 'provider_type': {'enum': ['all', 'agent', 'mcp', 'subscription', 'hybrid', 'one_off', 'payg'], 'type': 'string', 'description': "'all' (default) = the combined whole-economy series, or the standalone 'agent' / 'mcp' / 'subscription' / 'hybrid' / 'one_off' / 'payg' = the billing-LENS series (they cut across provider/mcp; a rate sits in one delivery type AND one lens; own base 100) — 'payg' (pay-as-you-go, engine v2) series (own base 100)."}, 'response_mode': {'enum': ['summary', 'full'], 'type': 'string', 'description': "'summary' (default, compact) or 'full'."}}}

{'type': 'object', 'properties': {'handle': {'type': 'string', 'description': "Provider handle, e.g. 'openhands'"}, 'regNum': {'type': 'number', 'description': 'Registration number, e.g. 2432'}}}

{'type': 'object', 'required': ['provider_id'], 'properties': {'provider_id': {'type': 'string', 'description': 'The provider_id/handle returned by search_providers or compare_providers'}}}

{'type': 'object', 'properties': {'rank': {'enum': ['gaps', 'hot'], 'type': 'string', 'description': 'gaps (default): whitespace with money, crowded excluded. hot: most active by market pulse, crowding ignored.'}, 'limit': {'type': 'number', 'description': 'Max gaps (1-50, default 15)'}, 'sector': {'type': 'string', 'description': "Optional sector filter, e.g. 'legal', 'healthcare'"}}}

{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': "Natural-language capability or market, e.g. 'customer support chatbot' or 'ai phishing detection'."}, 'response_mode': {'enum': ['summary', 'full'], 'type': 'string', 'description': "'summary' (DEFAULT) returns a compact block: neighbourhood counts, per-type/per-tier price cohorts and top providers. 'full' returns everything incl. the full member list."}}}

{'type': 'object', 'properties': {'task': {'type': 'string', 'description': 'Alias of `query` (same text).'}, 'niche': {'type': 'string', 'description': 'Legacy alias of `query`, kept for older clients — prefer `query`.'}, 'query': {'type': 'string', 'description': "The capability to benchmark, in natural language, e.g. 'AI code review' or 'supplier invoice reconciliation'. Preferred input."}, 'sector': {'type': 'string', 'description': "Sector name, e.g. 'legal' (ignored if a query is given)"}, 'buyer_tier': {'enum': ['individual', 'pro', 'team_sme', 'enterprise', 'all'], 'type': 'string', 'description': 'Buyer tier being priced. Set when the user describes who is buying (an individual, a professional, a team/SME, or an enterprise). An individual licence must never be represented by the SME or enterprise price.'}, 'pricing_unit': {'type': 'string', 'description': "Optional pricing unit to hold constant (e.g. 'flat', 'per_seat', 'per_agent'). Incompatible units are never combined."}, 'provider_type': {'enum': ['agent', 'mcp', 'api', 'all'], 'type': 'string', 'description': "Delivery type being priced. Set when the user says provider, MCP or API. Omit (or 'all') to get the per-type matrix instead of a blended figure. 'api' is recognised but not yet a separate commercial cohort (folded into provider)."}, 'response_mode': {'enum': ['summary', 'full'], 'type': 'string', 'description': "'summary' (default): compact per-type/per-tier benchmark matrix. 'full': also returns the deprecated blended legacy block + AEPI index."}}}

{'type': 'object', 'required': ['workflow_steps'], 'properties': {'limit_per_step': {'type': 'number', 'description': 'Max candidates per step (1-25, default 8)'}, 'workflow_steps': {'type': 'array', 'description': 'Each: step_id, step_name, step_description, inputs[], desired_outputs[], required_integrations[], human_approval_preference (always|sometimes|not_needed|unknown)'}, 'business_context': {'type': 'object', 'description': 'company_description, industry, region, existing_tools[], automation_posture (cautious|balanced|agent_native), regulated_data (none|personal|health|financial|legal|children|unknown)'}}}

{'type': 'object', 'required': ['agent_id', 'outcome'], 'properties': {'note': {'type': 'string', 'description': 'Optional free-text detail (capped at 300 chars)'}, 'outcome': {'enum': ['worked', 'failed', 'partial'], 'type': 'string', 'description': 'Did the provider accomplish the task you hired it for?'}, 'agent_id': {'type': 'string', 'description': 'Handle of the provider you used, as returned by search_providers/get_provider_profile/compare_providers'}, 'task_type': {'type': 'string', 'description': "Optional short task label, e.g. 'code-review', 'lead-enrichment'"}, 'latency_ms': {'type': 'number', 'description': 'Optional end-to-end latency of the provider in milliseconds'}, 'error_class': {'type': 'string', 'description': "Optional failure class, e.g. 'timeout', 'auth', 'wrong-output', 'endpoint-down'"}}}

{'type': 'object', 'required': ['task'], 'properties': {'sort': {'enum': ['match', 'price_asc'], 'type': 'string', 'description': "Shortlist ordering. Default 'match'."}, 'task': {'type': 'string', 'description': "Required — the natural-language capability/task, e.g. 'reconcile supplier invoices' or 'litigation-analysis provider'. Aliases: query, q."}, 'limit': {'type': 'number', 'description': 'Shortlist size (1-12, default 5).'}, 'buyer_tier': {'enum': ['individual', 'pro', 'team', 'enterprise'], 'type': 'string', 'description': "Optional buyer tier to price against ('team' = Team/SME)."}, 'integrations': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Optional required integrations, e.g. ["zendesk","slack"] — soft preference; integration status is reported per provider.'}, 'provider_type': {'enum': ['auto', 'agent', 'mcp', 'api', 'any'], 'type': 'string', 'description': "Preferred delivery type. 'auto' (default) infers from the task; note 'AI agent' phrasing is treated as generic (neutral), not an agent-only filter. When a type is explicit (mcp/api/agent) matching providers are SOFT-RANKED to the top and the rest are kept as clearly-labelled cross_type_alternative entries — never hard-filtered (no zero-result cliff), and the functional match is never changed. Every provider is labelled with provider_type (public values: agent | mcp | api | unknown) + type_match_score; provider_type{type_rank_boost_applied, boosted_provider_type, result_counts_by_type} is returned."}, 'response_mode': {'enum': ['summary', 'full'], 'type': 'string', 'description': "'summary' (default) or 'full' (adds tier cohorts, coverage and raw results)."}, 'max_monthly_usd': {'type': 'number', 'description': 'Optional budget ceiling in USD/month — filters the shortlist and drives suggested_alternatives.'}}}

{'type': 'object', 'required': ['query'], 'properties': {'sort': {'enum': ['match', 'price_asc'], 'type': 'string', 'description': 'match (default) or price_asc (cheapest observed price first; unpriced providers last)'}, 'limit': {'type': 'number', 'description': 'Max results (1-50, default 20)'}, 'query': {'type': 'string', 'description': "REQUIRED. Free-text description of the product job you are buying, e.g. 'customer support provider with Zendesk integration' or 'supplier invoice reconciliation'. Not for questions about Agentery itself (upvotes, endpoints): those return status unsupported_request."}, 'billing': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Only providers with one of these observed billing models, e.g. ["free","freemium","subscription","usage"]'}, 'filters': {'type': 'object', 'description': 'Optional: industry_fit[], integrations_available[], entity_type[] (agent|tool|infrastructure|service|marketplace|content-community), autonomy_level[] (assistant|workflow automation|agentic|infrastructure), minimum_evidence_quality (low|medium|high)'}, 'provider_type': {'enum': ['agent', 'mcp', 'api', 'platform', 'infrastructure'], 'type': 'string', 'description': 'Filter to one provider type — the audited classification dimension (same as the website type chips and AEPI facets); result labels always match this filter. Omit for all types.'}, 'max_monthly_usd': {'type': 'number', 'description': 'Drop providers whose observed lowest paid tier exceeds this (USD/month). Providers with no observed public price still pass unless require_public_price is true.'}, 'require_public_price': {'type': 'boolean', 'description': 'Only return providers with an observed public price (default false)'}}}

{'type': 'object', 'required': ['agent_id'], 'properties': {'limit': {'type': 'number', 'description': 'Max alternatives (1-10, default 5)'}, 'agent_id': {'type': 'string', 'description': "Handle of the provider to find substitutes for, e.g. 'openhands'"}, 'cheaper_only': {'type': 'boolean', 'description': "Only keep alternatives priced below the subject's lowest monthly price. Free/freemium providers always qualify; providers with no observed price are excluded. Default false."}}}

{'type': 'object', 'required': ['benchmark_id'], 'properties': {'add': {'type': 'array', 'items': {'type': 'string'}}, 'remove': {'type': 'array', 'items': {'type': 'string'}}, 'rename': {'type': 'string'}, 'benchmark_id': {'type': 'string', 'description': 'Your cb_ token'}}}