{
  "serverInfo": {
    "name": "Italian B2B Lead List Scoring, Ranking & JSON Decisions",
    "version": "1.3.4"
  },
  "authentication": {
    "required": false,
    "schemes": []
  },
  "tools": [
    {
      "name": "get_product_catalog",
      "description": "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.",
      "inputSchema": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "service": { "type": "string", "const": "MachineSignal" },
          "version": { "type": "string" },
          "products": { "type": "array", "minItems": 2, "maxItems": 2 },
          "resources": { "type": "object" },
          "boundaries": { "type": "object" }
        },
        "required": ["service", "version", "products", "resources", "boundaries"],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "map_business_need",
      "description": "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. It accepts only closed semantic fields and never creates a product or order.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "country": { "type": "string", "const": "IT", "description": "Optional legacy 1.2.0 compatibility for Italian demand." },
          "origin_market": { "type": "string", "enum": ["IT", "EU_NON_IT", "EXTRA_EU", "UNKNOWN_NOT_DECLARED"], "description": "Optional self-declared coarse origin bucket used only for aggregate research; 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."
          },
          "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 a current product appears to fit." },
          "urgency": { "type": "string", "enum": ["exploratory", "this_quarter", "this_month", "immediate"], "description": "How soon the capability would be useful." },
          "recurrence": { "type": "string", "enum": ["one_off", "recurring", "continuous", "unknown"], "description": "Whether the need is one-off, recurring or continuous." },
          "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; never payment data." }
        },
        "required": ["customer_type", "need_domain", "need_action", "need_object", "desired_output"],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "mapping_status": { "type": "string", "const": "structured_need_mapped_no_product_created" },
          "scope": { "type": "string", "enum": ["B2B_Italy_general_business_need", "B2B_global_demand_research_sales_italy_only"] },
          "origin_market": { "type": "string", "enum": ["IT", "EU_NON_IT", "EXTRA_EU", "UNKNOWN_NOT_DECLARED"] },
          "market_verification": { "type": "string", "const": "structured_self_declared_bucket_not_identity_verified" },
          "commercial_eligibility": { "type": "string", "enum": ["b2b_italy_sales_scope", "research_only_not_commercially_eligible"] },
          "need_signature": { "type": "object" },
          "existing_product_fit": { "type": "string" },
          "potential_product_gap": { "type": "boolean" },
          "signal_type": { "type": "string", "const": "ephemeral_aggregate_only" },
          "free_text_accepted": { "type": "boolean", "const": false },
          "buyer_data_accepted": { "type": "boolean", "const": false },
          "persists_data": { "type": "boolean", "const": false },
          "product_created": { "type": "boolean", "const": false },
          "order_created": { "type": "boolean", "const": false },
          "checkout_url_returned": { "type": "boolean", "const": false },
          "provider_call_enabled": { "type": "boolean", "const": false },
          "boundaries": { "type": "object" }
        },
        "required": ["mapping_status", "scope", "origin_market", "market_verification", "commercial_eligibility", "need_signature", "existing_product_fit", "potential_product_gap", "signal_type", "free_text_accepted", "buyer_data_accepted", "persists_data", "product_created", "order_created", "checkout_url_returned", "provider_call_enabled", "boundaries"],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "check_buyer_fit",
      "description": "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.",
      "inputSchema": {
        "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
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "fit_status": { "type": "string" },
          "eligible": { "type": "boolean" },
          "requested_product_code": { "type": "string", "enum": ["MS-DEC-250", "MS-ACT-25"] },
          "reason_code": { "type": "string" },
          "reason": { "type": "string" },
          "next_resource": { "type": "string", "format": "uri" },
          "ready_to_prepare": { "type": "boolean" },
          "recommended_next_tool": { "type": "string", "const": "prepare_order_intent" },
          "recommended_next_arguments": { "type": "object", "properties": { "product_code": { "type": "string", "const": "MS-DEC-250" } }, "required": ["product_code"], "additionalProperties": false },
          "buyer_data_must_remain_local": { "type": "boolean", "const": true },
          "next_step_after_preparation": { "type": "string" },
          "checkout_url_returned": { "type": "boolean", "const": false },
          "boundaries": { "type": "object" }
        },
        "required": ["fit_status", "eligible", "requested_product_code", "reason_code", "reason", "ready_to_prepare", "buyer_data_must_remain_local", "boundaries"],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "get_synthetic_example",
      "description": "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.",
      "inputSchema": {
        "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
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "example": { "type": "object" },
          "canonical_example_url": { "type": "string", "format": "uri" },
          "boundaries": { "type": "object" }
        },
        "required": ["example", "canonical_example_url", "boundaries"],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "get_purchase_requirements",
      "description": "Explain the machine-origin purchase prerequisites without accepting an order, returning checkout data or calling a provider.",
      "inputSchema": {
        "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
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "product_code": { "type": "string", "enum": ["MS-DEC-250", "MS-ACT-25"] },
          "customer_scope": { "type": "string" },
          "input_requirement": { "type": "string" },
          "order_policy": { "type": "string" },
          "authoritative_order_protocol": { "type": "string", "format": "uri" },
          "machine_onboarding": { "type": "string", "format": "uri" },
          "legal_resources": { "type": "object" },
          "ready_to_prepare": { "type": "boolean" },
          "recommended_next_tool": { "type": "string", "const": "prepare_order_intent" },
          "recommended_next_arguments": { "type": "object", "properties": { "product_code": { "type": "string", "const": "MS-DEC-250" } }, "required": ["product_code"], "additionalProperties": false },
          "buyer_data_must_remain_local": { "type": "boolean", "const": true },
          "next_step_after_preparation": { "type": "string" },
          "mcp_order_tool_exposed": { "type": "boolean", "const": false },
          "checkout_url_returned": { "type": "boolean", "const": false },
          "boundaries": { "type": "object" }
        },
        "required": ["product_code", "customer_scope", "input_requirement", "order_policy", "authoritative_order_protocol", "machine_onboarding", "legal_resources", "ready_to_prepare", "buyer_data_must_remain_local", "mcp_order_tool_exposed", "checkout_url_returned", "boundaries"],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "prepare_order_intent",
      "description": "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.",
      "inputSchema": {
        "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
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "preparation_status": { "type": "string", "const": "template_ready_no_order_created" },
          "product_code": { "type": "string", "const": "MS-DEC-250" },
          "submit_method": { "type": "string", "const": "POST" },
          "order_endpoint": { "type": "string", "format": "uri" },
          "order_openapi": { "type": "string", "format": "uri" },
          "static_order_openapi": { "type": "string", "format": "uri" },
          "request_schema_ref": { "type": "string", "format": "uri" },
          "validation_profile_url": { "type": "string", "format": "uri" },
          "idempotency_header": { "type": "string", "const": "Idempotency-Key" },
          "required_fields": { "type": "array", "items": { "type": "string" }, "minItems": 17, "maxItems": 17 },
          "local_fill_template": { "type": "object" },
          "instructions": { "type": "array", "items": { "type": "string" }, "minItems": 5 },
          "accepts_buyer_data": { "type": "boolean", "const": false },
          "persists_data": { "type": "boolean", "const": false },
          "order_created": { "type": "boolean", "const": false },
          "checkout_url_returned": { "type": "boolean", "const": false },
          "provider_call_enabled": { "type": "boolean", "const": false },
          "boundaries": { "type": "object" }
        },
        "required": ["preparation_status", "product_code", "submit_method", "order_endpoint", "order_openapi", "static_order_openapi", "request_schema_ref", "validation_profile_url", "idempotency_header", "required_fields", "local_fill_template", "instructions", "accepts_buyer_data", "persists_data", "order_created", "checkout_url_returned", "provider_call_enabled", "boundaries"],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    }
  ],
  "resources": [
    {
      "uri": "machinesignal://catalog/products",
      "name": "machinesignal-product-catalog",
      "title": "MachineSignal B2B Italy product catalog",
      "description": "Read-only catalog for MS-DEC-250 and the entitlement-gated MS-ACT-25 continuation.",
      "mimeType": "application/json"
    },
    {
      "uri": "machinesignal://examples/ms-dec-250",
      "name": "ms-dec-250-synthetic-example",
      "title": "MS-DEC-250 synthetic output example",
      "description": "One synthetic lead decision illustrating the JSON output delivered by the entry product.",
      "mimeType": "application/json"
    },
    {
      "uri": "machinesignal://examples/ms-act-25",
      "name": "ms-act-25-synthetic-example",
      "title": "MS-ACT-25 synthetic continuation example",
      "description": "One synthetic action pack illustrating the post-DEC continuation output; no entitlement is granted.",
      "mimeType": "application/json"
    },
    {
      "uri": "machinesignal://orders/ms-dec-250/preparation",
      "name": "ms-dec-250-order-preparation",
      "title": "MS-DEC-250 local order preparation contract",
      "description": "Canonical endpoint, OpenAPI references, required fields and local placeholder template; reading it creates no order.",
      "mimeType": "application/json"
    },
    {
      "uri": "machinesignal://contracts/public-api",
      "name": "machinesignal-public-api-reference",
      "title": "MachineSignal public API and legal references",
      "description": "Read-only index of authoritative API, order, onboarding and legal documents.",
      "mimeType": "application/json"
    }
  ],
  "prompts": []
}