map_business_need

Map any structured B2B business need from Italy or a foreign market for aggregate product research. Italy remains the only commercial sales scope; foreign signals are research-only. The tool accepts only closed semantic fields and never creates a product or order.

Parameters11

country	string	optional	Legacy 1.2.0 compatibility for Italian demand. Omit it when origin_market is supplied.
origin_market	string	optional	Self-declared coarse origin bucket used only for aggregate research; defaults to UNKNOWN_NOT_DECLARED. Foreign buckets never enable sales.
customer_type	string	required	Only business demand is observed; this does not expand commercial eligibility.
need_domain	string	required	Broad business domain of the requested capability; use other only when none applies.
need_action	string	required	Primary action the machine wants the capability to perform.
need_object	string	required	Business object or subject on which the action should operate.
desired_output	string	required	Machine-readable or operational result the buyer wants.
existing_product_fit	string	optional	Whether an existing MachineSignal product appears to fit; defaults to unknown.
urgency	string	optional	How soon the capability would be useful; defaults to exploratory.
recurrence	string	optional	Whether the need is one-off, recurring or continuous; defaults to unknown.
budget_band	string	optional	Optional coarse willingness-to-pay band in EUR; never send payment data.

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "const": "IT",
      "description": "Legacy 1.2.0 compatibility for Italian demand. Omit it when origin_market is supplied."
    },
    "origin_market": {
      "type": "string",
      "enum": [
        "IT",
        "EU_NON_IT",
        "EXTRA_EU",
        "UNKNOWN_NOT_DECLARED"
      ],
      "description": "Self-declared coarse origin bucket used only for aggregate research; defaults to UNKNOWN_NOT_DECLARED. Foreign buckets never enable sales."
    },
    "customer_type": {
      "type": "string",
      "const": "B2B",
      "description": "Only business demand is observed; this does not expand commercial eligibility."
    },
    "need_domain": {
      "type": "string",
      "enum": [
        "sales_marketing",
        "research_intelligence",
        "finance_administration",
        "procurement_supply",
        "operations_logistics",
        "customer_service",
        "data_analytics",
        "software_it",
        "security_risk",
        "legal_compliance",
        "hr_people",
        "product_innovation",
        "industry_specialized",
        "cross_functional",
        "other"
      ],
      "description": "Broad business domain of the requested capability; use other only when none applies."
    },
    "need_action": {
      "type": "string",
      "enum": [
        "discover",
        "collect",
        "extract",
        "classify",
        "score",
        "rank",
        "analyze",
        "compare",
        "predict",
        "monitor",
        "alert",
        "generate",
        "validate",
        "reconcile",
        "automate",
        "integrate",
        "optimize",
        "audit",
        "explain",
        "recommend",
        "decide",
        "other"
      ],
      "description": "Primary action the machine wants the capability to perform."
    },
    "need_object": {
      "type": "string",
      "enum": [
        "companies",
        "markets",
        "competitors",
        "customers",
        "leads",
        "documents",
        "transactions",
        "products",
        "suppliers",
        "workflows",
        "systems",
        "datasets",
        "regulations",
        "communications",
        "workforce",
        "physical_assets",
        "other"
      ],
      "description": "Business object or subject on which the action should operate."
    },
    "desired_output": {
      "type": "string",
      "enum": [
        "api_response",
        "dataset",
        "ranked_list",
        "score",
        "report",
        "alert",
        "recommendation",
        "decision",
        "document",
        "content",
        "workflow",
        "integration",
        "automation",
        "dashboard",
        "other"
      ],
      "description": "Machine-readable or operational result the buyer wants."
    },
    "existing_product_fit": {
      "type": "string",
      "enum": [
        "MS-DEC-250",
        "MS-ACT-25",
        "partial",
        "none",
        "unknown"
      ],
      "description": "Whether an existing MachineSignal product appears to fit; defaults to unknown."
    },
    "urgency": {
      "type": "string",
      "enum": [
        "exploratory",
        "this_quarter",
        "this_month",
        "immediate"
      ],
      "description": "How soon the capability would be useful; defaults to exploratory."
    },
    "recurrence": {
      "type": "string",
      "enum": [
        "one_off",
        "recurring",
        "continuous",
        "unknown"
      ],
      "description": "Whether the need is one-off, recurring or continuous; defaults to unknown."
    },
    "budget_band": {
      "type": "string",
      "enum": [
        "unknown",
        "under_50_eur",
        "50_199_eur",
        "200_499_eur",
        "500_1999_eur",
        "2000_plus_eur"
      ],
      "description": "Optional coarse willingness-to-pay band in EUR; never send payment data."
    }
  },
  "required": [
    "customer_type",
    "need_domain",
    "need_action",
    "need_object",
    "desired_output"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_product_catalog

Find an API product to score, classify, rank and prioritize an existing Italian B2B company or lead list into up to 250 explained JSON decisions. Returns the canonical catalog and permanent safety boundaries; read-only and no buyer data.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

check_buyer_fit

Check whether an Italian B2B buyer with an existing company, domain, CRM or lead list can use MS-DEC-250 to score, rank and prioritize up to 250 records. Coarse non-personal facts only; it creates no order.

Parameters5

country	string	required	Two-letter country code, for example IT.
customer_type	string	required	Buyer type. MachineSignal accepts B2B only.
has_existing_company_list	boolean	required	Whether the buyer already has a company, domain, CRM or lead list to evaluate.
requested_product_code	string	optional	Product being considered. Defaults to the entry product MS-DEC-250.
primary_need	string	optional	Optional non-personal demand category used only in ephemeral aggregate counters; never send free text or buyer data.

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "description": "Two-letter country code, for example IT."
    },
    "customer_type": {
      "type": "string",
      "enum": [
        "B2B",
        "B2C"
      ],
      "description": "Buyer type. MachineSignal accepts B2B only."
    },
    "has_existing_company_list": {
      "type": "boolean",
      "description": "Whether the buyer already has a company, domain, CRM or lead list to evaluate."
    },
    "requested_product_code": {
      "type": "string",
      "enum": [
        "MS-DEC-250",
        "MS-ACT-25"
      ],
      "description": "Product being considered. Defaults to the entry product MS-DEC-250."
    },
    "primary_need": {
      "type": "string",
      "enum": [
        "score_existing_company_list",
        "discover_target_companies",
        "prioritize_leads",
        "market_potential_analysis",
        "deep_company_analysis",
        "build_actionable_campaign",
        "crm_workflow_automation",
        "monitor_market_changes",
        "competitor_analysis",
        "other_structured_b2b_need"
      ],
      "description": "Optional non-personal demand category used only in ephemeral aggregate counters; never send free text or buyer data."
    }
  },
  "required": [
    "country",
    "customer_type",
    "has_existing_company_list"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_synthetic_example

Preview the JSON produced when MachineSignal scores, classifies, ranks and prioritizes an Italian B2B lead list. Uses approved synthetic data only and creates no order.

Parameters1

product_code

string

required

Product whose approved synthetic output preview should be returned.

Raw schema

{
  "type": "object",
  "properties": {
    "product_code": {
      "type": "string",
      "enum": [
        "MS-DEC-250",
        "MS-ACT-25"
      ],
      "description": "Product whose approved synthetic output preview should be returned."
    }
  },
  "required": [
    "product_code"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_purchase_requirements

Explain the machine-origin purchase prerequisites without accepting an order, returning checkout data or calling a provider.

Parameters1

product_code

string

required

Product whose controlled machine-origin purchase requirements should be returned.

Raw schema

{
  "type": "object",
  "properties": {
    "product_code": {
      "type": "string",
      "enum": [
        "MS-DEC-250",
        "MS-ACT-25"
      ],
      "description": "Product whose controlled machine-origin purchase requirements should be returned."
    }
  },
  "required": [
    "product_code"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

prepare_order_intent

Return the canonical endpoint, OpenAPI, 17 required fields and a locally fillable MS-DEC-250 template. It accepts no buyer data and never creates an order.

Parameters1

product_code

string

required

Entry product whose order-intent template should be prepared locally without submitting it.

Raw schema

{
  "type": "object",
  "properties": {
    "product_code": {
      "type": "string",
      "const": "MS-DEC-250",
      "description": "Entry product whose order-intent template should be prepared locally without submitting it."
    }
  },
  "required": [
    "product_code"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Italian B2B Lead Scoring, Ranking & JSON Decisions

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

map_business_need

get_product_catalog

check_buyer_fit

get_synthetic_example

get_purchase_requirements

prepare_order_intent

Install

Remote endpoint