{
  "schema_version": "2026-08-24.machine-buyer-discovery.v13",
  "service": "MachineSignal",
  "updated_at": "2026-08-24",
  "purpose": "Help buyer agents run a no-side-effect public preview, then choose the MS-DEC-250 entry product or the entitlement-gated MS-ACT-25 continuation while rejecting every other scope.",
  "canonical_resources": {
    "website": "https://machinesignal.it/",
    "public_preview_page_it": "https://machinesignal.it/it/prova/",
    "public_preview_endpoint": "https://api.machinesignal.it/v1/previews/public-readiness",
    "llms": "https://machinesignal.it/llms.txt",
    "product_catalog": "https://machinesignal.it/product-catalog.json",
    "agent_sales": "https://machinesignal.it/agent-sales.json",
    "machine_onboarding": "https://machinesignal.it/machine-onboarding.json",
    "machine_buyer_quickstart": "https://machinesignal.it/machine-buyer-quickstart.json",
    "machine_buyer_quickstart_html": "https://machinesignal.it/machine-buyer-quickstart/",
    "openapi": "https://machinesignal.it/openapi.json",
    "order_intake_openapi": "https://api.machinesignal.it/openapi.json",
    "order_intake_openapi_static_copy": "https://machinesignal.it/order-openapi.json",
    "order_intent_validation_profile": "https://machinesignal.it/order-intent-validation-profile.json",
    "mcp_tool_manifest": "https://machinesignal.it/mcp-tool-manifest.json",
    "mcp_discovery_endpoint": "https://mcp.machinesignal.it/mcp",
    "a2a_agent_card": "https://a2a.machinesignal.it/.well-known/agent-card.json",
    "a2a_rest_origin": "https://a2a.machinesignal.it",
    "ms_dec_250_product_page": "https://machinesignal.it/products/ms-dec-250/",
    "ms_act_25_product_page": "https://machinesignal.it/products/ms-act-25/",
    "ms_dec_250_product_page_it": "https://machinesignal.it/it/prodotti/ms-dec-250/",
    "ms_act_25_product_page_it": "https://machinesignal.it/it/prodotti/ms-act-25/",
    "ms_dec_250_example": "https://machinesignal.it/ms-dec-250-example.json",
    "ms_act_25_example": "https://machinesignal.it/ms-act-25-example.json",
    "lead_decision_api_guide": "https://machinesignal.it/resources/lead-decision-api-b2b-italy/",
    "lead_opportunity_score_api_landing": "https://machinesignal.it/api/lead-opportunity-score/",
    "target_company_prioritization_guide_it": "https://machinesignal.it/risorse/prioritizzazione-aziende-target-api/",
    "market_potential_analysis_api_guide_it": "https://machinesignal.it/risorse/analisi-mercato-potenziale-api/",
    "official_mcp_registry_canonical": "https://registry.modelcontextprotocol.io/v0.1/servers?search=it.machinesignal%2Fdiscovery",
    "official_mcp_registry_semantic_alias": "https://registry.modelcontextprotocol.io/v0.1/servers?search=it.machinesignal%2Fb2b-lead-scoring-ranking-italy",
    "dec_250_quality_contract": "https://machinesignal.it/resources/dec-250-quality-contract/",
    "dec_to_act_case_study": "https://machinesignal.it/resources/dec-to-act-case-study/",
    "well_known_discovery": "https://machinesignal.it/.well-known/machinesignal.json",
    "mcp_server_card": "https://mcp.machinesignal.it/.well-known/mcp/server-card.json"
  },
  "first_live_product": {
    "code": "MS-DEC-250",
    "name": "Lead Decision Pack 250",
    "product_page_url": "https://machinesignal.it/products/ms-dec-250/",
    "localized_product_page_url": "https://machinesignal.it/it/prodotti/ms-dec-250/",
    "price_eur": 49,
    "currency": "EUR",
    "included_valid_outputs": 250,
    "delivery_unit": "one machine-readable decision for each valid input record, up to 250 valid outputs",
    "output_format": "application/json",
    "example_output_url": "https://machinesignal.it/ms-dec-250-example.json",
    "customer_scope": "B2B Italy only",
    "payment_method": "controlled card-only payment after eligibility validation",
    "public_checkout_url_exposed": false
  },
  "product_fit": {
    "good_fit_when": [
      "the buyer is an Italian business or professional",
      "the buyer already has a B2B Italy company list, domain list, CRM export or lead records",
      "the buyer needs machine-readable lead decisions: prioritize, review, watchlist or discard",
      "the buyer can provide Italian billing data, Italian VAT or tax identifier, SDI or PEC and billing address",
      "the buyer agent has explicit authority to request the order intent and later authorize business card payment"
    ],
    "not_a_fit_when": [
      "the buyer needs MachineSignal to source or sell a lead list from scratch",
      "the buyer is a consumer or B2C customer",
      "the buyer is a B2B customer outside Italy",
      "the buyer wants automated outreach, CRM writes or external contact execution",
      "the buyer cannot provide Italian fiscal and electronic invoicing data"
    ],
    "first_purchase_question": "Does the buyer already have a B2B Italy list to score?",
    "if_yes": "MS-DEC-250 is the approved first product to test a machine-origin purchase.",
    "if_no": "Do not order MS-DEC-250 yet. A future target-discovery product would be a better fit, but it is not approved for live sale now."
  },
  "controlled_order_intent": {
    "protocol": "machinesignal_order_intent_v0",
    "documentation": "https://machinesignal.it/agent-sales.json",
    "production_endpoint": "https://api.machinesignal.it/v1/order-intents",
    "order_status_template": "https://api.machinesignal.it/v1/order-intents/{order_intent_id}",
    "openapi": "https://api.machinesignal.it/openapi.json",
    "method": "POST",
    "idempotency_header": "Idempotency-Key",
    "payment_link_returned": false,
    "public_checkout_url_returned": false,
    "authenticated_order_status": {
      "scope": "accepted external MS-DEC-250 B2B Italy order intents only",
      "receipt_response_path": "order_tracking.order_receipt",
      "status_url_response_path": "order_tracking.status_url",
      "receipt_header": "X-MachineSignal-Order-Receipt",
      "receipt_is_payment_credential": false,
      "receipt_storage": "SHA-256 hash only",
      "checkout_handoff_status": "buyer_specific_zero_touch_active_after_validation",
      "zero_touch_processing_active": true,
      "normal_order_human_intervention_required": false,
      "public_checkout_url_exposed": false,
      "buyer_specific_checkout_may_be_returned_in_authenticated_status": true,
      "dataset_upload_authorized_at_intake": false,
      "dataset_upload_authorized_after_verified_payment": true,
      "payment_executed_at_intake": false,
      "invoice_or_sdi_executed_at_intake": false,
      "invoice_and_sdi_automatic_after_verified_payment": true,
      "instruction": "Keep the receipt private and poll only the authenticated status URL. Follow next_machine_action: use the buyer-specific checkout only when returned, submit DEC inputs only after paid_verified, then retrieve the artifact with its expiring token."
    },
    "real_order_candidate_rule": "Real, plausible B2B Italy billing and legal-acceptance data are required. Synthetic and placeholder values are rejected on the production origin.",
    "public_first_product_only": "MS-DEC-250",
    "ms_act_25_entitlement_required": true
  },
  "machine_instructions": [
    "Use the public read-only MCP endpoint for discovery and local preparation only; it cannot accept an order or return checkout data.",
    "Call check_buyer_fit with the optional closed primary_need category when one applies. The value is counted only in ephemeral aggregates; never send free text or buyer data.",
    "When check_buyer_fit returns ready_to_prepare=true, follow recommended_next_tool and call prepare_order_intent with the returned arguments. It provides the endpoint, authoritative OpenAPI, 17 required fields, validation profile and a placeholder-only local template. Fill real buyer data locally and never send it to the discovery MCP.",
    "For any B2B need from Italy or a foreign market, including one unrelated to current MachineSignal products, call map_business_need with a closed origin_market bucket plus domain/action/object/output fields. Foreign demand is research-only and does not enable a sale. Never send free text, buyer identity, fiscal/contact data, documents or payment data; the tool only contributes ephemeral aggregate demand signals and creates no product or order.",
    "Read product-catalog.json, agent-sales.json and the production OpenAPI before submitting an order intent.",
    "Use MS-DEC-250 as the first product for an eligible B2B Italy buyer with a list.",
    "Submit a real MS-DEC-250 order intent to https://api.machinesignal.it/v1/order-intents with a unique Idempotency-Key.",
    "Keep the receipt private, poll authenticated status and follow next_machine_action; use only its buyer-specific checkout with explicit buyer authority.",
    "After payment_status=paid_verified, submit company-only DEC inputs through the authenticated inputs endpoint.",
    "Poll until the artifact token is available and retrieve the purchased result through the authenticated artifact endpoint.",
    "Use MS-ACT-25 only with the signed entitlement issued to the same buyer after paid and completed MS-DEC-250 for exactly 25 qualified records.",
    "Do not scrape or publish checkout URLs, receipts or artifact tokens.",
    "Do not execute outreach, CRM writes, Wise payouts, B2C or non-Italian orders."
  ],
  "blocked_flows": [
    "public anonymous checkout",
    "public listing of live Stripe Payment Link URL",
    "B2B EU outside Italy",
    "B2B extra-EU",
    "B2C",
    "marketplace listing",
    "external outreach",
    "Wise payout",
    "synthetic orders on the production origin"
  ],
  "contact": {
    "email": "info@machinesignal.it",
    "pec": "machinesignal@registerpec.it"
  },
  "conditional_continuation_product": {
    "code": "MS-ACT-25",
    "name": "Opportunity Action Pack 25",
    "product_page_url": "https://machinesignal.it/products/ms-act-25/",
    "localized_product_page_url": "https://machinesignal.it/it/prodotti/ms-act-25/",
    "status": "live_post_purchase_only",
    "purchasable": true,
    "order_intent_allowed": true,
    "anonymous_purchase_allowed": false,
    "public_checkout_url_exposed": false,
    "product_price_eur": 399,
    "stamp_duty_eur": 2,
    "total_due_eur": 401,
    "currency": "EUR",
    "included_valid_outputs": 25,
    "included_company_records": 25,
    "delivery_unit": "one complete 25-target campaign package with one detailed machine-readable action pack per selected company record",
    "output_format": "application/json",
    "product_promise": "A complete execution-ready campaign package for exactly 25 qualified targets, prepared for a buyer-controlled CRM or workflow.",
    "buyer_result_summary": "Receive Deep Analysis across 25 selected targets, explicit mini-checks, cluster strategy, message drafts, CRM/workflow payloads, a day 0/7/21/60 sequence, automatic rules, reputation/spam risk assessment and an audit trail.",
    "package_scope": {
      "target_count": 25,
      "deep_analysis_included": true,
      "target_or_cluster_diagnosis_required": true,
      "observable_evidence_required": true,
      "explicit_mini_check_required": true,
      "cluster_strategy_required": true,
      "initial_follow_up_nurturing_messages_required": true,
      "crm_workflow_payload_required": true,
      "campaign_sequence_days": [0, 7, 21, 60],
      "automatic_contact_stop_nurture_rules_required": true,
      "reputation_spam_risk_assessment_required": true,
      "audit_trail_required": true
    },
    "example_output_url": "https://machinesignal.it/ms-act-25-example.json",
    "continuation_from": "MS-DEC-250",
    "eligibility_rule": "The same approved B2B Italy buyer must have paid for and completed MS-DEC-250 and must present a seller-signed entitlement bound to the buyer, source order, source delivery and exactly 25 unique qualified output references.",
    "qualified_record_rule": "Each source record must have decision buy_deep_analysis, opportunity_score >= 75 and confidence >= 0.65; duplicates, invalid and incomplete records do not count.",
    "deliverables": [
      "Deep Analysis included across all 25 selected targets",
      "concrete diagnosis per target or cluster with observable evidence and uncertainties",
      "explicit ready-to-use mini-check per target or cluster",
      "target clustering and an operating strategy for each cluster",
      "recommended offer, buyer hypothesis and reason to act now",
      "initial message, follow-up and nurturing variant as approval-gated drafts",
      "CRM/workflow payload with tags, priority, pipeline status, next action, follow-up date and reason code",
      "day 0, day 7, day 21 and day 60 operating sequence",
      "automatic contact, stop and nurturing rules",
      "reputation and spam risk assessment, approval gate and auditable decision trail"
    ],
    "output_validity_rule": "Every cited mini-check must list its explicit points. Each point must state the problem, observed evidence, recommended intervention and connected CRM/workflow action. A vague count such as '3 interventions' is invalid.",
    "external_action_policy": "MachineSignal delivers an execution-ready package but does not send messages, contact targets, invoke customer webhooks or write to a CRM automatically. External execution remains buyer-controlled and approval-gated.",
    "fulfillment_release_policy": "Fail closed: do not create or release a buyer-specific checkout and do not accept paid fulfillment unless the complete 25-target output contract can be generated and delivery readiness has been verified.",
    "payment_path": "A buyer-specific one-use controlled checkout may be created only after entitlement verification. No reusable or anonymous public Payment Link is exposed.",
    "machine_instruction": "Submit MS-ACT-25 only after receiving a valid continuation entitlement for the same buyer and 25-record set; otherwise stop."
  }
}
