Audit web pages for SEO and technical issues using an AI CMO to receive actionable fixes and evidence.
Also known as Kumar2421/okara-alternative
- Stars
- 9
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.1.0
- Last commit
- Nov 14, 2026
- License
- AGPL-3.0
What is Marlo MCP?
Marlo is an MCP server. Audit web pages for SEO and technical issues using an AI CMO to receive actionable fixes and evidence.
Summary generated from the project's README
About Marlo MCP server
Auditing web pages for SEO and technical issues through an AI CMO is what marlo-mcp enables for developers using Claude, Cursor, or Windsurf. By using the audit_site tool, your AI assistant fetches a single webpage to identify critical problems and provide actionable solutions. The server operates in a read-only capacity, ensuring that no changes are made to your live site during the inspection process.
Setup requires Node.js 20 or newer and is configured via npx in your MCP client settings. While the server connects to a hosted Marlo endpoint by default, users can avoid public rate limits by providing a MARLO_BASE_URL and MARLO_ACCESS_PASSWORD to connect to a self-hosted instance. Each audit returns the top three findings, including specific evidence, the reasoning behind the issue, and a concrete fix to implement.
What you can do with it
- 1Prioritize SEO fixesAsk your AI assistant to analyze a specific URL and determine which technical issues require immediate attention.
- 2Pre-deployment quality checksVerify the technical health of a webpage before you push it to a live production environment.
Written from the project's README. Every use case is checked against a quote from it.
How to install Marlo MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Marlo MCP in Claude Code
$ claude mcp add --env 'MARLO_ACCESS_PASSWORD=<YOUR_MARLO_ACCESS_PASSWORD>' marlo-mcp -- npx -y marlo-mcpInstall Marlo MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"marlo-mcp": {
"command": "npx",
"args": [
"-y",
"marlo-mcp"
],
"env": {
"MARLO_ACCESS_PASSWORD": "<YOUR_MARLO_ACCESS_PASSWORD>"
}
}
}
}Install Marlo MCP in VS Code
.vscode/mcp.json
{
"servers": {
"marlo-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"marlo-mcp"
],
"env": {
"MARLO_ACCESS_PASSWORD": "<YOUR_MARLO_ACCESS_PASSWORD>"
}
}
}
}Install Marlo MCP in VS Code CLI
$ code --add-mcp '{"name":"marlo-mcp","type":"stdio","command":"npx","args":["-y","marlo-mcp"],"env":{"MARLO_ACCESS_PASSWORD":"<YOUR_MARLO_ACCESS_PASSWORD>"}}'Install Marlo MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"marlo-mcp": {
"command": "npx",
"args": [
"-y",
"marlo-mcp"
],
"env": {
"MARLO_ACCESS_PASSWORD": "<YOUR_MARLO_ACCESS_PASSWORD>"
}
}
}
}Install Marlo MCP in Codex
$ codex mcp add marlo-mcp --env 'MARLO_ACCESS_PASSWORD=<YOUR_MARLO_ACCESS_PASSWORD>' -- npx -y marlo-mcpInstall Marlo MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.marlo-mcp] command = "npx" args = ["-y", "marlo-mcp"] [mcp_servers.marlo-mcp.env] MARLO_ACCESS_PASSWORD = "<YOUR_MARLO_ACCESS_PASSWORD>"
Install Marlo MCP in Gemini CLI
$ gemini mcp add -s user -e 'MARLO_ACCESS_PASSWORD=<YOUR_MARLO_ACCESS_PASSWORD>' marlo-mcp npx -- -y marlo-mcpInstall Marlo MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"marlo-mcp": {
"command": "npx",
"args": [
"-y",
"marlo-mcp"
],
"env": {
"MARLO_ACCESS_PASSWORD": "<YOUR_MARLO_ACCESS_PASSWORD>"
}
}
}
}Configuration
MARLO_ACCESS_PASSWORDSecretThe MARLO_ACCESS_PASSWORD of your self-hosted Marlo, if you set one. Only sent to MARLO_BASE_URL.
MARLO_BASE_URLBase URL of your own self-hosted Marlo. Leave empty to use the hosted app at https://app.marlo.mlforge.in.
| Name | Description | |
|---|---|---|
| MARLO_ACCESS_PASSWORD | The MARLO_ACCESS_PASSWORD of your self-hosted Marlo, if you set one. Only sent to MARLO_BASE_URL. | Secret |
| MARLO_BASE_URL | Base URL of your own self-hosted Marlo. Leave empty to use the hosted app at https://app.marlo.mlforge.in. |
Automated checks
Ran Nov 12, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledNot checked
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on GitHubmarlo-mcp
An MCP server that lets Claude, Cursor and other AI assistants audit a web page for SEO and technical issues with Marlo, the open-source AI CMO.
Ask your assistant things like:
- "Audit https://mysite.com and tell me what to fix first."
- "Check this page before I ship it."
It has one tool, audit_site. It is read-only: it fetches the page and changes nothing. It checks one page, and returns the top findings, each with evidence, why it matters and a concrete fix.
Install
Add it to your MCP client. For Claude Desktop, Cursor, Windsurf and similar clients:
{
"mcpServers": {
"marlo": {
"command": "npx",
"args": ["-y", "marlo-mcp"]
}
}
}
For Claude Code: claude mcp add marlo -- npx -y marlo-mcp
Requires Node.js 20 or newer.
Use your own Marlo server
By default the tool calls the hosted Marlo at https://app.marlo.mlforge.in, which rate limits public audits. To use your own self-hosted Marlo instead:
| Variable | Purpose |
|---|---|
MARLO_BASE_URL |
Your server, for example http://localhost:3000 |
MARLO_ACCESS_PASSWORD |
Your server's MARLO_ACCESS_PASSWORD, if you set one. It is only ever sent to MARLO_BASE_URL, never to the hosted app. |
{
"mcpServers": {
"marlo": {
"command": "npx",
"args": ["-y", "marlo-mcp"],
"env": { "MARLO_BASE_URL": "http://localhost:3000" }
}
}
}
What it sends
Only the page address you ask about, to Marlo's public audit endpoint. No API keys, files or conversation text leave your machine. Private and local addresses are refused by the server.
Limits
- One page per call, and the top three findings. The full product tracks findings over time, checks AI readiness (GEO), reads Search Console and opens draft fix PRs on GitHub.
- The hosted endpoint is rate limited. If you hit the limit, the tool says so and when to retry.
Development
npm install
npm test
node bin/marlo-mcp.mjs # speaks MCP over stdio
License: AGPL-3.0, same as Marlo.
Marlo MCP questions
How do I add Marlo MCP to Claude Code?
Run claude mcp add --env 'MARLO_ACCESS_PASSWORD=<YOUR_MARLO_ACCESS_PASSWORD>' marlo-mcp -- npx -y marlo-mcp in your terminal. Add --scope user to make it available in every project.
How do I add Marlo MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Does this server change my website?
No, the server is read-only and only fetches the page to perform the audit.
What information is sent to the Marlo server?
Only the URL of the page you want to audit is sent; no files, API keys, or conversation text are transmitted.
What are the limitations of the audit tool?
The tool audits one page per call and returns the top three findings.