lacspace-mcp
The Lacspace tools for AI agents — one MCP server for Claude, Cursor and VS Code.
claude mcp add lacspace -- npx -y lacspace-mcpEverything, in one command
lacspace-mcp speaks MCP over stdio (JSON-RPC, one message per line), the transport every local AI client uses, and implements the protocol itself rather than shipping an SDK at runtime — protocol versions 2025-06-18, 2025-03-26 and 2024-11-05. The tools wrap lacspace-scraper, lacspace-extract, lacspace-inspect, lacspace-enrich, lacspace-leads and the @lacspace email packages. Safety switches: extract_document reads files only under allowed directories (symlinks resolved), --block-private refuses private-network and cloud-metadata targets, and --only/--disable trim the tool list. Its interoperability tests drive the built server with the official MCP SDK client — the same code path Claude Code and Cursor use. The same tools run from the terminal with `lacspace-mcp call`.
An MCP server runs next to your AI client, not in a browser. Install it with the one-liner above, or print the config for Claude Desktop, Cursor, VS Code or Windsurf with `npx lacspace-mcp config <client>`.
What's inside
fetch_page & crawl_site
Readable text, headings, links, tables, Open Graph and JSON-LD from a page (render: true for JavaScript-built pages), or a bounded crawl with live progress.
screenshot_page
A PNG of the rendered page the model can look at — viewport or full page, wait for a selector, scroll for lazy content.
scrape
Exact fields with CSS selectors — `a@href`, `.price | number` — repeated over every item.
extract_document
PDF, DOCX, PPTX, EPUB, HTML, CSV, XLSX and Markdown → Markdown, from a local file or a URL, with PDF page ranges.
audit_page
SEO, social, structured data, security headers and crawlability graded A–F, with a fix for every problem.
enrich_domain
Company name, logo, emails, phones, socials, tech stack, MX/SPF/DMARC and RDAP registration from a domain.
check_site
Status, redirect chain, response time, server headers and TLS certificate expiry.
validate_email
Syntax, disposable, role account, typo suggestion, normalised form and MX lookup. Nothing is sent.
find_leads
Google Maps businesses by type and city with rating, phone, website and, on request, email and socials.
Safe by default
Read-only tools; file access limited to your open workspace folders and --allow-path; --block-private stops SSRF into your network or cloud metadata; a confirmation question before big crawls and lead runs.
Tested against the official client
Unit, tool and interoperability layers; the MCP SDK client drives the built server over stdio.
Copy, paste, done
Real commands and snippets — from a one-liner to the typed library.
claude mcp add lacspace -- npx -y lacspace-mcpThen ask: “Read https://example.com/pricing and summarise the plans.”
npx lacspace-mcp config cursor
npx lacspace-mcp config claude-desktop
npx lacspace-mcp config vscodePrints the exact JSON to paste, including any safety flags you pass.
npx lacspace-mcp --block-private --allow-path ~/docs --disable find_leadsNo private-network fetches, files only under ~/docs, no browser-driven tool.
npx lacspace-mcp call check_site '{"url":"https://developer.lacspace.com"}'
npx lacspace-mcp call extract_document '{"source":"./report.pdf","pages":"1-3"}'Same tools from the terminal — handy for debugging and scripts.
import { createServer, serveStdio } from "lacspace-mcp";
const server = createServer({ policy: { blockPrivate: true }, extraTools: [myTool] });
await serveStdio(server);What people build with it
✓ Let Claude or Cursor read and cite live web pages
✓ Audit a landing page from inside the editor
✓ Pull tables out of PDFs during a chat
✓ Research a company or a lead list without leaving the agent
Run lacspace-mcp today
Free, open-source, no API keys. It's a CLI and a typed library.
claude mcp add lacspace -- npx -y lacspace-mcp