Symbols MCP
Plugs Claude directly into the Symbols.app ecosystem with documentation search, code generation, and project publishing. You get tools to convert React or HTML into DOMQL components, audit code against 62 strict rules via frank-audit, and manage the full publish pipeline from generate_component through save_to_project and push. The get_project_context tool reads symbols.json from your working directory to configure everything automatically. Built for the modern smbls stack with signal reactivity, declarative fetch, and SSR. Most documentation tools work immediately; project management requires a Symbols account login.
- GitHub stars
- 1
- tools
- 20
- transport
- STDIO
- last updated
- Nov 11, 2026
Tools
20 toolsPublic tool metadata for what this MCP can expose to an agent.
get_project_contextCALL FIRST. Walks up from cwd to find symbols.json, returns owner, key, dir, bundler, sharedLibraries, brender, env_type, env_evidence, env_guidance, token_present, and a next_step hint telling the agent what to do.
CALL FIRST. Walks up from cwd to find symbols.json, returns owner, key, dir, bundler, sharedLibraries, brender, env_type, env_evidence, env_guidance, token_present, and a next_step hint telling the agent what to do.
No parameter schema in public metadata yet.
get_project_rulesMandatory ruleset. No arguments returns a compact CORE bundle; section="SYNTAX" (or COMPONENTS, FRANKABILITY, RULES + part=N, etc.) fetches one section per call. full=true returns the legacy one-shot ruleset.
Mandatory ruleset. No arguments returns a compact CORE bundle; section="SYNTAX" (or COMPONENTS, FRANKABILITY, RULES + part=N, etc.) fetches one section per call. full=true returns the legacy one-shot ruleset.
No parameter schema in public metadata yet.
get_cli_referenceComplete Symbols CLI (@symbo.ls/cli) command reference.
Complete Symbols CLI (@symbo.ls/cli) command reference.
No parameter schema in public metadata yet.
get_sdk_referenceComplete Symbols SDK (@symbo.ls/sdk) API reference.
Complete Symbols SDK (@symbo.ls/sdk) API reference.
No parameter schema in public metadata yet.
search_symbols_docsKeyword search across all bundled Symbols documentation files.
Keyword search across all bundled Symbols documentation files.
No parameter schema in public metadata yet.
detect_environmentLegacy caller-supplied flags variant of env classification. Prefer get_project_context.
Legacy caller-supplied flags variant of env classification. Prefer get_project_context.
No parameter schema in public metadata yet.
generate_componentGenerate a DOMQL component from a natural language description. Returns prompt + bundled context.
Generate a DOMQL component from a natural language description. Returns prompt + bundled context.
No parameter schema in public metadata yet.
generate_pageGenerate a full page with routing, helmet metadata, and declarative fetch: integration.
Generate a full page with routing, helmet metadata, and declarative fetch: integration.
No parameter schema in public metadata yet.
convert_reactConvert React/JSX code to Symbols DOMQL (modern smbls stack).
Convert React/JSX code to Symbols DOMQL (modern smbls stack).
No parameter schema in public metadata yet.
convert_htmlConvert raw HTML/CSS to Symbols DOMQL components.
Convert raw HTML/CSS to Symbols DOMQL components.
No parameter schema in public metadata yet.
convert_to_jsonConvert DOMQL JS source to platform JSON. Use after generate_component / generate_page to feed save_to_project.
Convert DOMQL JS source to platform JSON. Use after generate_component / generate_page to feed save_to_project.
No parameter schema in public metadata yet.
audit_componentInline validator for a single file's code. Returns violations and warnings. Pass file_path and include_playbook=True to also dump the AUDIT.md playbook.
Inline validator for a single file's code. Returns violations and warnings. Pass file_path and include_playbook=True to also dump the AUDIT.md playbook.
No parameter schema in public metadata yet.
audit_projectReturns the multi-phase project audit playbook (instructions for the agent, Phase 0 setup through Phase 5 report).
Returns the multi-phase project audit playbook (instructions for the agent, Phase 0 setup through Phase 5 report).
No parameter schema in public metadata yet.
loginLog in to Symbols platform and return a JWT token.
Log in to Symbols platform and return a JWT token.
No parameter schema in public metadata yet.
list_projectsList the user's projects (names, keys, IDs) to choose from.
List the user's projects (names, keys, IDs) to choose from.
No parameter schema in public metadata yet.
create_projectCreate a new Symbols project on the platform.
Create a new Symbols project on the platform.
No parameter schema in public metadata yet.
get_projectGet a project's current data (components, pages, design system, state).
Get a project's current data (components, pages, design system, state).
No parameter schema in public metadata yet.
save_to_projectSave components/pages/data to a project, creating a new version with change tuples, granular changes, orders, and auto-generated schema entries.
Save components/pages/data to a project, creating a new version with change tuples, granular changes, orders, and auto-generated schema entries.
No parameter schema in public metadata yet.
publishPublish a version (make it live).
Publish a version (make it live).
No parameter schema in public metadata yet.
pushDeploy a project to an environment (production, staging, dev).
Deploy a project to an environment (production, staging, dev).
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
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
Details
- Repository
- github.com/symbo-ls/symbols-mcp
- Package
symbols-mcp- Transport
- STDIO
- Registry
- MCP registry, active