Skip to main content
Glama

Italian B2B Lead List Scoring, Ranking & JSON Decisions

Check MachineSignal buyer fit

check_buyer_fit
Read-onlyIdempotent

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. Calls update only anonymous aggregate counters in memory; submitted data is not saved.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "country": "<country>",
      "customer_type": "<customer_type>",
      "has_existing_company_list": "<has_existing_company_list>"
    },
    "name": "check_buyer_fit"
  }
}

Input Schema

NameRequiredDescriptionDefault
countryYesTwo-letter country code, for example IT.
primary_needNoOptional non-personal demand category used only in ephemeral aggregate counters; never send free text or buyer data.
customer_typeYesBuyer type. MachineSignal accepts B2B only.
requested_product_codeNoProduct being considered. Defaults to the entry product MS-DEC-250.
has_existing_company_listYesWhether the buyer already has a company, domain, CRM or lead list to evaluate.

Output Schema

NameRequiredDescriptionDefault
reasonYes
eligibleYes
boundariesYesPermanent safety boundaries of the public MCP discovery server.
fit_statusYes
reason_codeYes
next_resourceNo
ready_to_prepareYes
checkout_url_returnedNo
recommended_next_toolNo
requested_product_codeYes
recommended_next_argumentsNo
next_step_after_preparationNo
buyer_data_must_remain_localYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed7 schema fields changed
    • addedInput schema / properties / primary_need
      Added value: +{
      +  "description": "Optional non-personal demand category used only in ephemeral aggregate counters; never send free text or buyer data.",
      +  "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"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / buyer_data_must_remain_local
      Added value: +{
      +  "const": true,
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / next_step_after_preparation
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / ready_to_prepare
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / recommended_next_arguments
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "product_code": {
      +      "const": "MS-DEC-250",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "product_code"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / recommended_next_tool
      Added value: +{
      +  "const": "prepare_order_intent",
      +  "type": "string"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "fit_status",
      -  "eligible",
      -  "requested_product_code",
      -  "reason_code",
      -  "reason",
      -  "boundaries"
      -]New value: +[
      +  "fit_status",
      +  "eligible",
      +  "requested_product_code",
      +  "reason_code",
      +  "reason",
      +  "ready_to_prepare",
      +  "buyer_data_must_remain_local",
      +  "boundaries"
      +]
  2. Changed4 schema fields changed
    • addedInput schema / properties / customer_type / description
      Added value: +"Buyer type. MachineSignal accepts B2B only."
    • addedInput schema / properties / has_existing_company_list / description
      Added value: +"Whether the buyer already has a company, domain, CRM or lead list to evaluate."
    • addedInput schema / properties / requested_product_code / description
      Added value: +"Product being considered. Defaults to the entry product MS-DEC-250."
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "http://json-schema.org/draft-07/schema#",
      +  "additionalProperties": false,
      +  "properties": {
      +    "boundaries": {
      +      "additionalProperties": false,
      +      "description": "Permanent safety boundaries of the public MCP discovery server.",
      +      "properties": {
      +        "accepts_buyer_data": {
      +          "const": false,
      +          "type": "boolean"
      +        },
      +        "b2b_italy_only": {
      +          "const": true,
      +          "description": "Only Italian B2B buyers are in commercial scope.",
      +          "type": "boolean"
      +        },
      +        "checkout_url_exposed": {
      +          "const": false,
      +          "type": "boolean"
      +        },
      +        "external_outreach_enabled": {
      +          "const": false,
      +          "type": "boolean"
      +        },
      +        "invoice_enabled": {
      +          "const": false,
      +          "type": "boolean"
      +        },
      +        "marketplace_publication_enabled": {
      +          "const": false,
      +          "type": "boolean"
      +        },
      +        "mode": {
      +          "const": "public_read_only_discovery",
      +          "description": "Public discovery mode; never an order-processing surface.",
      +          "type": "string"
      +        },
      +        "order_tool_exposed": {
      +          "const": false,
      +          "type": "boolean"
      +        },
      +        "payment_enabled": {
      +          "const": false,
      +          "type": "boolean"
      +        },
      +        "persists_data": {
      +          "const": false,
      +          "type": "boolean"
      +        },
      +        "provider_call_enabled": {
      +          "const": false,
      +          "type": "boolean"
      +        },
      +        "provider_reference_loaded": {
      +          "const": false,
      +          "type": "boolean"
      +        },
      +        "sdi_enabled": {
      +          "const": false,
      +          "type": "boolean"
      +        },
      +        "wise_payout_enabled": {
      +          "const": false,
      +          "type": "boolean"
      +        }
      +      },
      +      "required": [
      +        "mode",
      +        "b2b_italy_only",
      +        "accepts_buyer_data",
      +        "persists_data",
      +        "order_tool_exposed",
      +        "checkout_url_exposed",
      +        "provider_reference_loaded",
      +        "provider_call_enabled",
      +        "payment_enabled",
      +        "invoice_enabled",
      +        "sdi_enabled",
      +        "wise_payout_enabled",
      +        "external_outreach_enabled",
      +        "marketplace_publication_enabled"
      +      ],
      +      "type": "object"
      +    },
      +    "checkout_url_returned": {
      +      "const": false,
      +      "type": "boolean"
      +    },
      +    "eligible": {
      +      "type": "boolean"
      +    },
      +    "fit_status": {
      +      "enum": [
      +        "blocked",
      +        "not_fit",
      +        "continuation_entitlement_required",
      +        "fit_for_controlled_dec_order_intent"
      +      ],
      +      "type": "string"
      +    },
      +    "next_resource": {
      +      "format": "uri",
      +      "type": "string"
      +    },
      +    "reason": {
      +      "type": "string"
      +    },
      +    "reason_code": {
      +      "type": "string"
      +    },
      +    "requested_product_code": {
      +      "enum": [
      +        "MS-DEC-250",
      +        "MS-ACT-25"
      +      ],
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "fit_status",
      +    "eligible",
      +    "requested_product_code",
      +    "reason_code",
      +    "reason",
      +    "boundaries"
      +  ],
      +  "type": "object"
      +}
  3. First observed

TDQS

A3.7/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly, idempotent and non-destructive, so the description is not carrying the safety burden alone. It adds genuinely new behavioral context beyond them: no order is created, only anonymous aggregate counters in memory are touched, and submitted data is not persisted — the key reassurance for a telemetry-style call.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three tight sentences with the capability claim front-loaded, followed by the input restriction and the data-handling guarantee. No filler, though the phrase "up to 250 records" is product jargon that only the enum clarifies.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present and annotations covering safety, the description covers what remains: input restrictions and privacy behavior. It leaves open what a negative fit result means, but for a simple gating check nothing essential to correct invocation is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with enum values and per-field descriptions, so the schema already does the heavy lifting and a 3 baseline applies. The description does tie the criteria together (country + B2B + existing company/domain/CRM/lead list) into a single fit decision, which adds a little meaning, but it does not explain requested_product_code or primary_need beyond what the schema says.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource: check whether a buyer can use MS-DEC-250 to score/rank/prioritize up to 250 records, and scopes the audience (Italian B2B buyers with an existing list). The clause "it creates no order" implicitly distinguishes it from prepare_order_intent, though no sibling is named directly.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is implied as a pre-purchase fit check, but there is no explicit when-to-use or when-not-to-use guidance, nor a pointer to get_product_catalog, get_purchase_requirements, or prepare_order_intent for the next step. The "coarse non-personal facts only" line is a constraint on inputs rather than routing guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources