Skip to content
Back to search

uplyo-mcp

MCP server for evidence-based website audits: technical SEO/CRO checks, Core Web Vitals and French company registry lookup

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/isma2034--uplyo-mcp/badge.svg)](/listings/isma2034--uplyo-mcp)

HTML

<a href="/listings/isma2034--uplyo-mcp"><img src="/api/listings/isma2034--uplyo-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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](https://console.cloud.google.com/apis/credentials).

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.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 101 lines
  1. # uplyo-mcp
  2. An [MCP](https://modelcontextprotocol.io) server for **evidence-based website audits**.
  3. It gives any MCP client (Claude Code, Claude Desktop, Cursor, ...) tools to check a
  4. site's technical SEO and conversion basics, measure real Core Web Vitals, and look up a
  5. company in the official French registry.
  6. Every audit separates what was **observed** (direct evidence, safe to quote to a client)
  7. from what is **to verify** (a hypothesis, phrased as a question, never as a fact). No tool
  8. estimates rankings or traffic, and none writes to a site: the server is read-only.
  9. > Tool descriptions and tool output are in **French**. The structured output
  10. > (`structuredContent`) is machine-readable JSON, so a client can translate or reformat it.
  11. ## Tools
  12. | Tool | What it does |
  13. |---|---|
  14. | `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. |
  15. | `uplyo_crawl_site` | Crawls every page of the sitemap (sitemap indexes are resolved). Long operation: returns a `job_id`. |
  16. | `uplyo_pagespeed` | Real Core Web Vitals through the PageSpeed Insights API (needs your free API key). |
  17. | `uplyo_company_lookup` | Looks a company up in the official French registry (`recherche-entreprises.api.gouv.fr`, open INSEE/SIRENE data, no key needed). |
  18. | `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. |
  19. ## Safety built in
  20. - **Politeness floor that cannot be bypassed:** at least 1 second between requests. Before
  21. any crawl, one `HEAD` request looks for a CDN in the headers. If the origin is bare
  22. (Apache or nginx with nothing in front), the delay is **raised automatically**. Crawling
  23. a small origin server with no pause can take it offline.
  24. - **Browser-built pages:** Elementor and Divi render forms with JavaScript, so zero `<form>`
  25. tags proves nothing. When a page builder is detected, that finding is downgraded to
  26. "to verify".
  27. - **Long operations never block the client:** they return a `job_id` to poll.
  28. - The PageSpeed key is read from `.env`, never returned in a tool result and never logged.
  29. Only audit sites you own or have permission to audit.
  30. ## Install
  31. Requires Node.js 20 or newer, `bash`, `curl`, `perl`, and `jq`.
  32. ```bash
  33. git clone https://github.com/isma2034/uplyo-mcp.git
  34. cd uplyo-mcp
  35. npm install
  36. npm run build
  37. ```
  38. Optional, for `uplyo_pagespeed`: copy `.env.example` to `.env` and add a free
  39. [PageSpeed Insights API key](https://console.cloud.google.com/apis/credentials).
  40. ### Claude Code
  41. ```bash
  42. claude mcp add uplyo --scope user -- node /absolute/path/to/uplyo-mcp/dist/index.js
  43. ```
  44. ### Claude Desktop, Cursor and other clients
  45. ```json
  46. {
  47. "mcpServers": {
  48. "uplyo": {
  49. "command": "node",
  50. "args": ["/absolute/path/to/uplyo-mcp/dist/index.js"]
  51. }
  52. }
  53. }
  54. ```
  55. Try it without any client: `npm run inspect` opens the MCP Inspector.
  56. ## Configuration
  57. | Variable | Default | Purpose |
  58. |---|---|---|
  59. | `UPLYO_SKILL_DIR` | the repository root | Folder that contains `scripts/` and `.env`. |
  60. | `UPLYO_OUTPUT_DIR` | `~/Uplyo-MCP` | Where audit files (JSON and summaries) are written. |
  61. ## How it works
  62. The server does not reimplement the audit. It wraps
  63. [`scripts/technical_audit.sh`](scripts/technical_audit.sh), the same engine as the
  64. [web-optimization](https://github.com/isma2034/web-optimization-skill) skill, and adds
  65. validated inputs, actionable errors, the politeness floor, and job handling. The raw files
  66. the script produces are returned **inside the conversation**, so the tools also work from a
  67. client that has no access to your disk.
  68. ## Tests
  69. ```bash
  70. npm test
  71. ```
  72. Starts the server over stdio, checks the tool inventory, schemas and error messages, then
  73. runs one real audit of `example.com`. It needs network access.
  74. ## License
  75. MIT, see [`LICENSE`](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.