marlo-mcp
v0.1.0
Published
MCP server that audits a web page for SEO and AI-readiness issues with Marlo, the open-source AI CMO.
Maintainers
Readme
marlo-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 stdioLicense: AGPL-3.0, same as Marlo.
