Skip to main content
Glama

Rafid Intelligence Network

procurement_vendor_shortlist

Read-onlyIdempotent

Screen and rank 2–50 Oman suppliers in one procurement workflow using identity, risk, sanctions and public-evidence signals. When: Use when a procurement agent needs a ranked vendor shortlist from several candidate suppliers. Selection: specialized; prefer for Use when a procurement agent needs a ranked vendor shortlist from several candidate suppliers.. Input is a strict JSON object; see the schema. Price: $2.00 USD per call. No free preview is advertised for this capability. Full execution is paid per call via x402; an unpaid MCP call returns payment instructions.

Input Schema

NameRequiredDescriptionDefault
csvNo
suppliersNo
maxResultsNo

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changed
    • removedOutput schema / additionalProperties
      Removed value: -false
    • addedOutput schema / anyOf
      Added value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "limitations": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "result": {},
      +      "workflow": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "workflow",
      +      "result",
      +      "limitations"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "nextAction": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "instruction": {
      +            "type": "string"
      +          },
      +          "target": {
      +            "enum": [
      +              "x402_endpoint",
      +              "mcp_credits_endpoint",
      +              "payment_endpoint",
      +              "unavailable"
      +            ],
      +            "type": "string"
      +          },
      +          "type": {
      +            "enum": [
      +              "pay_and_retry",
      +              "authorize_and_use_mcp_credits",
      +              "payment_unavailable"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "type",
      +          "target",
      +          "instruction"
      +        ],
      +        "type": "object"
      +      },
      +      "payment": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "endpoint": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "method": {
      +            "const": "POST",
      +            "type": "string"
      +          },
      +          "retrySameBody": {
      +            "const": true,
      +            "type": "boolean"
      +          }
      +        },
      +        "required": [
      +          "endpoint",
      +          "method",
      +          "retrySameBody"
      +        ],
      +        "type": "object"
      +      },
      +      "paymentGuidance": {},
      +      "preview": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "fullResultAvailable": {
      +            "const": true,
      +            "type": "boolean"
      +          },
      +          "inputAccepted": {
      +            "const": true,
      +            "type": "boolean"
      +          },
      +          "summary": {
      +            "type": "string"
      +          },
      +          "useCases": {
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          }
      +        },
      +        "required": [
      +          "inputAccepted",
      +          "fullResultAvailable",
      +          "summary",
      +          "useCases"
      +        ],
      +        "type": "object"
      +      },
      +      "price": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "amount": {
      +            "minimum": 0,
      +            "type": "number"
      +          },
      +          "currency": {
      +            "type": "string"
      +          },
      +          "protocol": {
      +            "enum": [
      +              "x402",
      +              "api_credits",
      +              "subscription",
      +              "l402",
      +              "mpp",
      +              "unavailable"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "amount",
      +          "currency",
      +          "protocol"
      +        ],
      +        "type": "object"
      +      },
      +      "requestId": {
      +        "type": "string"
      +      },
      +      "status": {
      +        "const": "payment_required",
      +        "type": "string"
      +      },
      +      "tool": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "status",
      +      "tool",
      +      "requestId",
      +      "price",
      +      "preview",
      +      "payment",
      +      "nextAction"
      +    ],
      +    "type": "object"
      +  }
      +]
    • removedOutput schema / properties
      Removed value: -{
      -  "limitations": {
      -    "items": {
      -      "type": "string"
      -    },
      -    "type": "array"
      -  },
      -  "result": {},
      -  "workflow": {
      -    "type": "string"
      -  }
      -}
    • removedOutput schema / required
      Removed value: -[
      -  "workflow",
      -  "result",
      -  "limitations"
      -]
  2. Changed4 schema fields changed
    • addedOutput schema / additionalProperties
      Added value: +false
    • removedOutput schema / anyOf
      Removed value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "limitations": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "result": {},
      -      "workflow": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "workflow",
      -      "result",
      -      "limitations"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "nextAction": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "instruction": {
      -            "type": "string"
      -          },
      -          "target": {
      -            "enum": [
      -              "x402_endpoint",
      -              "mcp_credits_endpoint",
      -              "payment_endpoint",
      -              "unavailable"
      -            ],
      -            "type": "string"
      -          },
      -          "type": {
      -            "enum": [
      -              "pay_and_retry",
      -              "authorize_and_use_mcp_credits",
      -              "payment_unavailable"
      -            ],
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "type",
      -          "target",
      -          "instruction"
      -        ],
      -        "type": "object"
      -      },
      -      "payment": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "endpoint": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "method": {
      -            "const": "POST",
      -            "type": "string"
      -          },
      -          "retrySameBody": {
      -            "const": true,
      -            "type": "boolean"
      -          }
      -        },
      -        "required": [
      -          "endpoint",
      -          "method",
      -          "retrySameBody"
      -        ],
      -        "type": "object"
      -      },
      -      "paymentGuidance": {},
      -      "preview": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "fullResultAvailable": {
      -            "const": true,
      -            "type": "boolean"
      -          },
      -          "inputAccepted": {
      -            "const": true,
      -            "type": "boolean"
      -          },
      -          "summary": {
      -            "type": "string"
      -          },
      -          "useCases": {
      -            "items": {
      -              "type": "string"
      -            },
      -            "type": "array"
      -          }
      -        },
      -        "required": [
      -          "inputAccepted",
      -          "fullResultAvailable",
      -          "summary",
      -          "useCases"
      -        ],
      -        "type": "object"
      -      },
      -      "price": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "amount": {
      -            "minimum": 0,
      -            "type": "number"
      -          },
      -          "currency": {
      -            "type": "string"
      -          },
      -          "protocol": {
      -            "enum": [
      -              "x402",
      -              "api_credits",
      -              "subscription",
      -              "l402",
      -              "mpp",
      -              "unavailable"
      -            ],
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "amount",
      -          "currency",
      -          "protocol"
      -        ],
      -        "type": "object"
      -      },
      -      "requestId": {
      -        "type": "string"
      -      },
      -      "status": {
      -        "const": "payment_required",
      -        "type": "string"
      -      },
      -      "tool": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "status",
      -      "tool",
      -      "requestId",
      -      "price",
      -      "preview",
      -      "payment",
      -      "nextAction"
      -    ],
      -    "type": "object"
      -  }
      -]
    • addedOutput schema / properties
      Added value: +{
      +  "limitations": {
      +    "items": {
      +      "type": "string"
      +    },
      +    "type": "array"
      +  },
      +  "result": {},
      +  "workflow": {
      +    "type": "string"
      +  }
      +}
    • addedOutput schema / required
      Added value: +[
      +  "workflow",
      +  "result",
      +  "limitations"
      +]
  3. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "limitations": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "result": {},
      -      "workflow": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "workflow",
      -      "result",
      -      "limitations"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "nextAction": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "instruction": {
      -            "type": "string"
      -          },
      -          "target": {
      -            "const": "x402_endpoint",
      -            "type": "string"
      -          },
      -          "type": {
      -            "const": "pay_and_retry",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "type",
      -          "target",
      -          "instruction"
      -        ],
      -        "type": "object"
      -      },
      -      "payment": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "endpoint": {
      -            "type": "string"
      -          },
      -          "method": {
      -            "const": "POST",
      -            "type": "string"
      -          },
      -          "retrySameBody": {
      -            "const": true,
      -            "type": "boolean"
      -          }
      -        },
      -        "required": [
      -          "endpoint",
      -          "method",
      -          "retrySameBody"
      -        ],
      -        "type": "object"
      -      },
      -      "preview": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "fullResultAvailable": {
      -            "const": true,
      -            "type": "boolean"
      -          },
      -          "inputAccepted": {
      -            "const": true,
      -            "type": "boolean"
      -          },
      -          "summary": {
      -            "type": "string"
      -          },
      -          "useCases": {
      -            "items": {
      -              "type": "string"
      -            },
      -            "type": "array"
      -          }
      -        },
      -        "required": [
      -          "inputAccepted",
      -          "fullResultAvailable",
      -          "summary",
      -          "useCases"
      -        ],
      -        "type": "object"
      -      },
      -      "price": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "amount": {
      -            "minimum": 0,
      -            "type": "number"
      -          },
      -          "currency": {
      -            "type": "string"
      -          },
      -          "protocol": {
      -            "const": "x402",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "amount",
      -          "currency",
      -          "protocol"
      -        ],
      -        "type": "object"
      -      },
      -      "requestId": {
      -        "type": "string"
      -      },
      -      "status": {
      -        "const": "payment_required",
      -        "type": "string"
      -      },
      -      "tool": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "status",
      -      "tool",
      -      "requestId",
      -      "price",
      -      "preview",
      -      "payment",
      -      "nextAction"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "limitations": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "result": {},
      +      "workflow": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "workflow",
      +      "result",
      +      "limitations"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "nextAction": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "instruction": {
      +            "type": "string"
      +          },
      +          "target": {
      +            "enum": [
      +              "x402_endpoint",
      +              "mcp_credits_endpoint",
      +              "payment_endpoint",
      +              "unavailable"
      +            ],
      +            "type": "string"
      +          },
      +          "type": {
      +            "enum": [
      +              "pay_and_retry",
      +              "authorize_and_use_mcp_credits",
      +              "payment_unavailable"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "type",
      +          "target",
      +          "instruction"
      +        ],
      +        "type": "object"
      +      },
      +      "payment": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "endpoint": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "method": {
      +            "const": "POST",
      +            "type": "string"
      +          },
      +          "retrySameBody": {
      +            "const": true,
      +            "type": "boolean"
      +          }
      +        },
      +        "required": [
      +          "endpoint",
      +          "method",
      +          "retrySameBody"
      +        ],
      +        "type": "object"
      +      },
      +      "paymentGuidance": {},
      +      "preview": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "fullResultAvailable": {
      +            "const": true,
      +            "type": "boolean"
      +          },
      +          "inputAccepted": {
      +            "const": true,
      +            "type": "boolean"
      +          },
      +          "summary": {
      +            "type": "string"
      +          },
      +          "useCases": {
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          }
      +        },
      +        "required": [
      +          "inputAccepted",
      +          "fullResultAvailable",
      +          "summary",
      +          "useCases"
      +        ],
      +        "type": "object"
      +      },
      +      "price": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "amount": {
      +            "minimum": 0,
      +            "type": "number"
      +          },
      +          "currency": {
      +            "type": "string"
      +          },
      +          "protocol": {
      +            "enum": [
      +              "x402",
      +              "api_credits",
      +              "subscription",
      +              "l402",
      +              "mpp",
      +              "unavailable"
      +            ],
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "amount",
      +          "currency",
      +          "protocol"
      +        ],
      +        "type": "object"
      +      },
      +      "requestId": {
      +        "type": "string"
      +      },
      +      "status": {
      +        "const": "payment_required",
      +        "type": "string"
      +      },
      +      "tool": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "status",
      +      "tool",
      +      "requestId",
      +      "price",
      +      "preview",
      +      "payment",
      +      "nextAction"
      +    ],
      +    "type": "object"
      +  }
      +]
  4. Changed4 schema fields changed
    • removedOutput schema / additionalProperties
      Removed value: -false
    • addedOutput schema / anyOf
      Added value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "limitations": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "result": {},
      +      "workflow": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "workflow",
      +      "result",
      +      "limitations"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "nextAction": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "instruction": {
      +            "type": "string"
      +          },
      +          "target": {
      +            "const": "x402_endpoint",
      +            "type": "string"
      +          },
      +          "type": {
      +            "const": "pay_and_retry",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "type",
      +          "target",
      +          "instruction"
      +        ],
      +        "type": "object"
      +      },
      +      "payment": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "endpoint": {
      +            "type": "string"
      +          },
      +          "method": {
      +            "const": "POST",
      +            "type": "string"
      +          },
      +          "retrySameBody": {
      +            "const": true,
      +            "type": "boolean"
      +          }
      +        },
      +        "required": [
      +          "endpoint",
      +          "method",
      +          "retrySameBody"
      +        ],
      +        "type": "object"
      +      },
      +      "preview": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "fullResultAvailable": {
      +            "const": true,
      +            "type": "boolean"
      +          },
      +          "inputAccepted": {
      +            "const": true,
      +            "type": "boolean"
      +          },
      +          "summary": {
      +            "type": "string"
      +          },
      +          "useCases": {
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": "array"
      +          }
      +        },
      +        "required": [
      +          "inputAccepted",
      +          "fullResultAvailable",
      +          "summary",
      +          "useCases"
      +        ],
      +        "type": "object"
      +      },
      +      "price": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "amount": {
      +            "minimum": 0,
      +            "type": "number"
      +          },
      +          "currency": {
      +            "type": "string"
      +          },
      +          "protocol": {
      +            "const": "x402",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "amount",
      +          "currency",
      +          "protocol"
      +        ],
      +        "type": "object"
      +      },
      +      "requestId": {
      +        "type": "string"
      +      },
      +      "status": {
      +        "const": "payment_required",
      +        "type": "string"
      +      },
      +      "tool": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "status",
      +      "tool",
      +      "requestId",
      +      "price",
      +      "preview",
      +      "payment",
      +      "nextAction"
      +    ],
      +    "type": "object"
      +  }
      +]
    • removedOutput schema / properties
      Removed value: -{
      -  "limitations": {
      -    "items": {
      -      "type": "string"
      -    },
      -    "type": "array"
      -  },
      -  "result": {},
      -  "workflow": {
      -    "type": "string"
      -  }
      -}
    • removedOutput schema / required
      Removed value: -[
      -  "workflow",
      -  "result",
      -  "limitations"
      -]
  5. Added

TDQS

B3.3/5.0
Behavior4/5

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

Annotations already declare readOnly=true, idempotent=true, openWorld=false, destructive=false, so the safety profile is covered. The description adds real behavioral context beyond them: $2.00 USD per call, x402 paid execution, and that an unpaid MCP call returns payment instructions rather than results. That payment/quota disclosure is genuinely useful and not present in the structured fields.

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

Conciseness3/5

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

The purpose is front-loaded and pricing is clearly stated, but the 'Selection:' sentence is garbled, duplicating the 'When' clause verbatim and adding no information. This wasted sentence plus verbose payment detail dilute an otherwise compact definition.

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

Completeness3/5

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

An output schema exists, so return values need not be described. The description adequately covers what the tool does, when to use it, and the payment model, but for a tool taking a nested supplier array it omits input-shape guidance (csv vs suppliers) and the advertised range contradicts the schema, leaving an agent to infer invocation details from the schema alone.

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

Parameters2/5

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

Schema description coverage is 0% across all three parameters (csv, suppliers, maxResults), so the description carries the full burden and mostly fails it. It hints at a supplier count ('2–50 Oman suppliers') — which actually conflicts with the schema's maxItems of 100 — but never explains what the 'csv' alternative input is, how csv relates to suppliers, or what maxResults controls.

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?

The description names a specific verb and resource ('Screen and rank 2–50 Oman suppliers') and scopes it to a procurement workflow using identity, risk, sanctions and public-evidence signals, which distinguishes it from generic siblings like company_risk_batch or analyze_company_risk. It is clear and specific, though it does not explicitly name which sibling to use instead.

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?

It provides a concrete 'When' clause: a procurement agent needing a ranked vendor shortlist from several candidate suppliers. But there are no when-not conditions and no named alternatives, and the 'Selection: specialized; prefer for...' line just repeats the When text verbatim rather than adding routing guidance, leaving usage only implied.

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.