Skip to main content
Glama

uplyo-mcp

An MCP server for evidence-based website audits. It gives any MCP client (Claude Code, Claude Desktop, Cursor, ...) tools to check a site's technical SEO and conversion basics, measure real Core Web Vitals, and look up a company in the official French registry.

Every audit separates what was observed (direct evidence, safe to quote to a client) from what is to verify (a hypothesis, phrased as a question, never as a fact). No tool estimates rankings or traffic, and none writes to a site: the server is read-only.

Tool descriptions and tool output are in French. The structured output (structuredContent) is machine-readable JSON, so a client can translate or reformat it.

Tools

Tool

What it does

uplyo_audit_page

Audits a few pages of a site: title, meta description, H1s, canonical, JSON-LD, image alt text, mixed content, CMS fingerprints, forms, robots.txt, sitemap. Returns observed findings and a to-verify list.

uplyo_crawl_site

Crawls every page of the sitemap (sitemap indexes are resolved). Long operation: returns a job_id.

uplyo_pagespeed

Real Core Web Vitals through the PageSpeed Insights API (needs your free API key).

uplyo_company_lookup

Looks a company up in the official French registry (recherche-entreprises.api.gouv.fr, open INSEE/SIRENE data, no key needed).

uplyo_job_status, uplyo_job_result, uplyo_list_jobs, uplyo_cancel_job

Follow a long operation, fetch the files it produced into the conversation, list or cancel jobs.

Related MCP server: SyteCheck MCP Server

Safety built in

  • Politeness floor that cannot be bypassed: at least 1 second between requests. Before any crawl, one HEAD request looks for a CDN in the headers. If the origin is bare (Apache or nginx with nothing in front), the delay is raised automatically. Crawling a small origin server with no pause can take it offline.

  • Browser-built pages: Elementor and Divi render forms with JavaScript, so zero <form> tags proves nothing. When a page builder is detected, that finding is downgraded to "to verify".

  • Long operations never block the client: they return a job_id to poll.

  • The PageSpeed key is read from .env, never returned in a tool result and never logged.

Only audit sites you own or have permission to audit.

Install

Requires Node.js 20 or newer, bash, curl, perl, and jq.

git clone https://github.com/isma2034/uplyo-mcp.git
cd uplyo-mcp
npm install
npm run build

Optional, for uplyo_pagespeed: copy .env.example to .env and add a free PageSpeed Insights API key.

Claude Code

claude mcp add uplyo --scope user -- node /absolute/path/to/uplyo-mcp/dist/index.js

Claude Desktop, Cursor and other clients

{
  "mcpServers": {
    "uplyo": {
      "command": "node",
      "args": ["/absolute/path/to/uplyo-mcp/dist/index.js"]
    }
  }
}

Try it without any client: npm run inspect opens the MCP Inspector.

Configuration

Variable

Default

Purpose

UPLYO_SKILL_DIR

the repository root

Folder that contains scripts/ and .env.

UPLYO_OUTPUT_DIR

~/Uplyo-MCP

Where audit files (JSON and summaries) are written.

How it works

The server does not reimplement the audit. It wraps scripts/technical_audit.sh, the same engine as the web-optimization skill, and adds validated inputs, actionable errors, the politeness floor, and job handling. The raw files the script produces are returned inside the conversation, so the tools also work from a client that has no access to your disk.

Tests

npm test

Starts the server over stdio, checks the tool inventory, schemas and error messages, then runs one real audit of example.com. It needs network access.

License

MIT, see LICENSE.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Remote MCP server for Keytomic, the AI SEO agent: SEO audits, Search Console and GA4 data, keyword research, articles, CMS publishing, indexing, backlinks, Reddit and AI visibility. You sign in with your Keytomic account.
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables MCP-capable agents to fetch public pages, extract business signals and FAQ content, score a local business's web presence from 0-10, and generate a sales-ready audit with ranked gaps and a recommended offer.
      4
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables MCP clients to crawl and audit websites for SEO and technical health, checking on-page elements, links, robots.txt, sitemaps, and duplicate metadata, then returning scores and prioritized fixes.
      4
      MIT