Skip to main content
Glama

Score a business’s online presence

scan_website

Score how well a business shows up online, out of 100, and name what is hurting it most. Give it a website (and an email to send the full report to) and it runs Kashif's audit of the business's online presence: whether customers can find them in search, whether AI assistants can read and recommend them, how fast the site feels on a phone and the first impression it makes, how trustworthy it looks, and how easy the business is to reach (WhatsApp, phone, a contact form). Returns a 0-100 score with the top issues to fix first. Use it whenever someone asks to audit, check, review, grade or improve a company's website or online presence. This starts a live scan and creates a lead for the Kashif team, who follow up with the full written report by email. If the result comes back with status "processing", the scan is still running: wait about 30 seconds, then call get_scan_result with the scanId it returned to collect the score.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
urlYesThe business’s website, e.g. example.com or https://example.com.
nameNoOptional: the person or business name, used to label the lead.
emailYesAn email address to send the full written report to. Required — this is a lead for the team.
languageNoReport language: "en" (default) or "ar" for Arabic.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
noteYesPlain-language context about the score and the full report to come.
scoreYes0-100 online-presence score, or null until the quick pass finishes.
scanIdNoPresent while status is "processing": pass it to get_scan_result to collect the finished result.
statusYes"ready" = quick score below; "processing" = still running, report follows; "failed" = site could not be checked.
websiteYesThe website that was scanned.
findingsYesThe top issues to fix first, most urgent first.
whatsappYesA WhatsApp link to reach the Kashif team about this business.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedOutput schema / properties / scanId
      Added value: +{
      +  "description": "Present while status is \"processing\": pass it to get_scan_result to collect the finished result.",
      +  "type": "string"
      +}
  2. First observed

TDQS

A4.8/5.0
Behavior5/5

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

Beyond annotations, the description discloses critical side effects: it starts a live scan, creates a lead for the Kashif team, and triggers a follow-up written report by email. It also explains the async processing path and required wait before retrieving results. This is exactly the behavioral context an agent needs before invoking a non-read-only, open-world tool.

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?

The description is front-loaded with the core purpose, score range, and return meaning. It is somewhat dense and repeats the 0-100 score concept, but every sentence carries useful selection, side-effect, or async-handling information. Minor compression could improve it, but it is not bloated.

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

Completeness5/5

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

Given the tool's complexity, the description covers purpose, usage conditions, required inputs, side effects, lead creation, email follow-up, and async result collection. An output schema exists, so the description need not explain return formatting in detail, but it still clarifies the 0-100 score and top issues. Nothing essential for correct invocation is missing.

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

Parameters4/5

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

Schema coverage is 100%, so the schema already documents all parameters, establishing a baseline of 3. The description adds useful semantics by explaining that the URL is the business website and the email is required because it sends the full report and creates a lead. It does not add details for name or language, but the schema covers those adequately.

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

Purpose5/5

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

The description states a specific verb and resource: it scores a business's online presence out of 100 and names top issues. It also distinguishes itself from the async sibling by explaining that a processing result should be collected with get_scan_result. An agent can select it without opening the schema.

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

Usage Guidelines5/5

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

It gives explicit usage triggers: 'whenever someone asks to audit, check, review, grade or improve a company's website or online presence.' It also handles the async edge case by naming get_scan_result and specifying a ~30-second wait. Alternative routing is clear.

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