{
  "schema_version": "2026-07-29.agent-to-machine-sales.v12",
  "name": "MachineSignal",
  "purpose": "Machine-readable B2B Italy lead opportunity decisions for CRM, workflow automation and AI-agent systems.",
  "updated_at": "2026-07-29",
  "commercial_status": {
    "state": "b2b_italy_controlled_live_order_ready",
    "first_product": "MS-DEC-250",
    "owner_final_decision": "approved_for_two_products_b2b_italy",
    "public_checkout": false,
    "controlled_payment_path": "available_only_after_seller_side_b2b_italy_validation",
    "controlled_payment_url_publicly_exposed": false,
    "payment_method": "card_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,
    "external_outreach_executed": false,
    "live_product_codes": [
      "MS-DEC-250",
      "MS-ACT-25"
    ]
  },
  "public_urls": {
    "website": "https://machinesignal.it/",
    "api_overview": "https://machinesignal.it/api/",
    "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",
    "order_intent_endpoint": "https://api.machinesignal.it/v1/order-intents",
    "order_status_template": "https://api.machinesignal.it/v1/order-intents/{order_intent_id}",
    "production_health": "https://api.machinesignal.it/health",
    "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",
    "buyer_agent": "https://machinesignal.it/buyer-agent.json",
    "machine_buyer_quickstart": "https://machinesignal.it/machine-buyer-quickstart.json",
    "machine_buyer_quickstart_html": "https://machinesignal.it/machine-buyer-quickstart/",
    "product_catalog": "https://machinesignal.it/product-catalog.json",
    "agent_sales": "https://machinesignal.it/agent-sales.json",
    "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/",
    "llms": "https://machinesignal.it/llms.txt",
    "well_known_discovery": "https://machinesignal.it/.well-known/machinesignal.json",
    "mcp_server_card": "https://mcp.machinesignal.it/.well-known/mcp/server-card.json",
    "staging_health": "https://staging.machinesignal.it/health"
  },
  "access_policy": {
    "mode": "controlled_machine_first_access",
    "request_email": "info@machinesignal.it",
    "order_intent_endpoint": "https://api.machinesignal.it/v1/order-intents",
    "order_intent_endpoint_status": "public_production_external_ms_dec_250_intake_enabled",
    "order_intake_openapi": "https://api.machinesignal.it/openapi.json",
    "order_status_template": "https://api.machinesignal.it/v1/order-intents/{order_intent_id}",
    "order_status_receipt_header": "X-MachineSignal-Order-Receipt",
    "order_receipt_is_payment_credential": false,
    "order_receipt_storage": "SHA-256 hash only",
    "api_keys": "issued privately only after B2B Italy approval",
    "self_service_key_creation": false,
    "public_order_intent_submission": true,
    "public_checkout": false,
    "synthetic_or_placeholder_orders_allowed": false,
    "dataset_upload_authorized_at_intake": false,
    "payment_executed_at_intake": false,
    "human_call_or_chat_required": false,
    "order_intent_supported": true
    ,
    "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_after_verified_payment": true,
    "invoice_or_sdi_executed_at_intake": false,
    "invoice_and_sdi_automatic_after_verified_payment": true
  },
  "allowed_scope": {
    "customer_type": "B2B only",
    "country": "Italy",
    "product_code": "MS-DEC-250",
    "product_name": "Lead Decision Pack 250",
    "price_eur": 49,
    "currency": "EUR",
    "payment_method": "card only after controlled eligibility validation",
    "real_order_candidate_required_billing_quality": "Italian VAT/tax identifier and SDI/PEC must be real and plausible; synthetic and placeholder values are rejected by the production origin.",
    "product_fit": "Fit for buyer machines that already have a B2B Italy list, domain list, CRM export or lead records to score. Not fit for no-list target discovery from scratch.",
    "product_codes": [
      "MS-DEC-250",
      "MS-ACT-25"
    ]
  },
  "machine_flow": [
    {
      "step": 1,
      "call": "MCP https://mcp.machinesignal.it/mcp or GET /buyer-agent.json",
      "goal": "Use read-only discovery to determine fit, optionally declare one closed primary_need category, and use map_business_need for any structured B2B need from Italy or a foreign market even when unrelated to current products. Foreign demand is research-only; sales and order preparation remain B2B Italy only. Then follow recommended_next_tool to prepare_order_intent only when eligible. Validate and fill the placeholder-only MS-DEC-250 template locally: MCP cannot accept orders, buyer data or return checkout data."
    },
    {
      "step": 2,
      "call": "GET /product-catalog.json and GET /agent-sales.json",
      "goal": "Read current products, prices, scope, required buyer fields and zero-touch protocol."
    },
    {
      "step": 3,
      "call": "GET https://api.machinesignal.it/openapi.json",
      "goal": "Inspect the production DEC/ACT order, input, status and artifact contract."
    },
    {
      "step": 4,
      "call": "prepare real MS-DEC-250 order_intent",
      "goal": "Prepare real B2B Italy billing, legal acceptance and buyer payment-authority fields. Synthetic data are rejected."
    },
    {
      "step": 5,
      "call": "POST https://api.machinesignal.it/v1/order-intents",
      "goal": "Submit with a unique Idempotency-Key and retain order_tracking.order_receipt privately."
    },
    {
      "step": 6,
      "call": "GET https://api.machinesignal.it/v1/order-intents/{order_intent_id}",
      "goal": "Authenticate with X-MachineSignal-Order-Receipt, poll, follow next_machine_action and use only the returned buyer-specific checkout."
    },
    {
      "step": 7,
      "call": "POST https://api.machinesignal.it/v1/order-intents/{order_intent_id}/inputs",
      "goal": "For DEC only, submit up to 250 company-only targets after payment_status=paid_verified."
    },
    {
      "step": 8,
      "call": "GET authenticated order status, then GET /v1/order-intents/{order_intent_id}/artifact",
      "goal": "Poll until artifact_ready, then retrieve the purchased JSON with the receipt and expiring artifact token."
    },
    {
      "step": 9,
      "call": "POST one MS-ACT-25 continuation order intent",
      "goal": "Use only the signed entitlement for the same buyer, paid completed DEC order and exactly 25 qualified records; ACT reuses those records and requires no new input upload."
    }
  ],
  "disabled_actions": [
    "public anonymous checkout",
    "public listing of live Stripe Payment Link URL",
    "using a synthetic staging receipt as a payment credential",
    "issue Fatture in Cloud/SdI invoice before valid paid B2B Italy order",
    "execute Wise payout",
    "contact external targets",
    "process B2C customers",
    "process B2B customers outside Italy"
  ],
  "billing_policy": {
    "regime_fiscale": "RF19",
    "iva_code": "N2.2",
    "first_expected_online_invoice_number": "1/WEB",
    "bollo_rule": "Apply 2.00 EUR only if the net line total exceeds 77.47 EUR.",
    "bollo_for_ms_dec_250": false,
    "bollo_for_ms_act_25": true,
    "ms_act_25_total_due_eur": 401
  },
  "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."
  }
}