Symbols MCP server
Symbols.app MCP — docs, code generation, publishing, CLI/SDK reference
1 stars162 downloads/wk
Reviews
Write oneNobody has reviewed Symbols MCP yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Symbols MCP tools (28, 4 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
apply_frankability_edit_opsApply LLM-generated edit ops to a Symbols project with verify-or-rollback.
audit_and_fix_frankabilitywrite actionRun frank-audit and optionally apply fixes — supports a sampling-driven LLM loop that resolves findings the mechanical fixer can't safely handle.
audit_componentAudit a Symbols/DOMQL component for v3 compliance — checks for v2 syntax, raw px values, hardcoded colors, direct DOM manipulation, and more. Returns violations, warnings, and a score.
audit_projectconvert_htmlConvert raw HTML/CSS to Symbols.app DOMQL v3 components with full context.
convert_reactConvert React/JSX code to Symbols.app DOMQL v3 with migration context.
convert_to_jsonConvert DOMQL v3 JavaScript source code to platform JSON format. Parses export statements, stringifies functions, outputs JSON ready for save_to_project.
create_projectwrite actionCreate a new Symbols project on the platform.
detect_environmentDetect project type (local, CDN, JSON runtime, or remote server) based on project indicators.
explain_frankability_ruleReturn the documentation block for a specific frank-audit rule.
frankability_logTail the audit log for a Symbols project.
generate_componentGenerate a Symbols.app DOMQL v3 component from a description with full context (rules, syntax, cookbook, default library).
generate_pageGenerate a Symbols.app page with routing integration and full context.
get_cli_referenceReturns the complete Symbols CLI (@symbo.ls/cli) command reference — all smbls commands, options, and workflows.
get_projectGet a project's current data (components, pages, design system, state).
get_project_contextRead the current Symbols project context — START HERE for any Symbols task.
get_project_rulesALWAYS call this first before any generate_* tool. Returns the mandatory Symbols.app rules that MUST be followed. Violations cause silent failures — black page, nothing renders.
get_sdk_referenceReturns the complete Symbols SDK (@symbo.ls/sdk) API reference — all services, methods, and usage examples.
list_projectsList the user's Symbols projects (names, keys, IDs) to choose from.
loginLog in to the Symbols platform and get an access token for project operations.
prescribe_frankability_fixesGenerate LLM-ready prescriptions for frank-audit findings that can't be auto-fixed.
publishwrite actionPublish a version of a Symbols project. Makes the specified version (or latest) the published/live version.
pushwrite actionDeploy a Symbols project to an environment (production, staging, dev).
rollback_frankabilityRestore a Symbols project to its state before a specific op ran.
save_to_projectSave components/pages/data to a Symbols project. Creates a new version with change tuples, granular changes, orders, and auto-generated schema entries (mirrors CLI push pipeline).
search_symbols_docsSearch the Symbols documentation knowledge base for relevant information including CLI commands, SDK services, syntax, components, and more.
snapshots_frankabilityList recent snapshotted opIds for a Symbols project.
verify_frankabilityVerify a Symbols project bundles cleanly via frank.toJSON.
Public scan report
scanner v0.1.9 · 2026-09-23 · same rubric, same numbers if you re-run it
- Code scan22 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 0 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10
What the publisher says
From the Symbols MCP repository's README, as published. We do not edit it. Read it on GitHub
symbols-mcp
mcp-name: io.github.symbo-ls/symbols-mcp
MCP server for Symbols.app — provides documentation search, code generation, conversion, auditing, project management, publishing/deployment, and CLI/SDK reference tools for AI coding assistants (Cursor, Claude Code, Windsurf, claude.ai, etc.).
Targets the modern smbls stack — flat element API, signal-based reactivity, declarative fetch: (@symbo.ls/fetch), polyglot translations (@symbo.ls/polyglot), helmet metadata (@symbo.ls/helmet), SPA routing via el.router(...), theme via @symbo.ls/scratch, and SSR via @symbo.ls/brender.
No API keys required for documentation tools. Project management tools require a Symbols account (login or API key).
Tools
Context — start here
Generation & conversion
Audit
For filesystem-wide audits the package ships a CLI: npx -y @symbo.ls/mcp symbols-audit (strict by default, exit 1 on findings). Under the hood it runs frank-audit audit --strict — the audit core is now @symbo.ls/frank-audit, the AST-based engine that owns the canonical 59-rule registry, prescription generation, and verify-or-rollback fixers.
lib/audit.js is preserved as a backward-compat shim that delegates to frank-audit (subprocess CLI, or the /audit-content HTTP endpoint when FRANKAUDITURL is set). The legacy programmatic API stays callable for non-CLI consumers (the @symbo.ls/cli, the MCP HTTP worker, web/edge clients):
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Install directly
claude mcp add symbols-mcp -- uvx symbols-mcp
Symbols MCP: common questions
- Is Symbols MCP server safe?
- Yes, by our scan: it is graded A (94/100). Read the Symbols MCP safety report
- How do I install Symbols MCP?
- It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
- Does Symbols MCP need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Symbols MCP maintained?
- The last commit was in the last day (2026-09-23). The latest release is v3.14.763.
- What can I use instead of Symbols MCP?
- Servers from other publishers that do the same job: classifier.dev docs MCP server, gflow-cli MCP server and Context7 MCP server. Compare all Symbols MCP alternatives.
Alternatives to Symbols MCP
Same job from other publishers: the closest match first, then the best rated.
- classifier.dev docsclassifier.dev documentation as tools: list, read and search the reference, benchmark and guides.not reviewedEstablishedA
- gflow-cliDrive Google Flow from an agent: Veo video and Imagen image generationnot reviewedGrowingA
Context7Up-to-date code docs for any promptnot reviewedWidely usedA- Svelte MCPThe official Svelte MCP server providing docs and autofixing tools for Svelte developmentnot reviewedEstablishedA
- Coolify45 optimized tools for managing Coolify infrastructure, diagnostics, and docs searchnot reviewedEstablishedB