Symbols MCP

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/symbo-ls-symbols-mcp

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools

17 read · 6 write · 1 delete · 4 not yet classified

Secrets

None asked for

Install scripts

None found

Runs as

Python package

Tools (28)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• apply_frankability_edit_ops

  Apply LLM-generated edit ops to a Symbols project with verify-or-rollback. Pass `ops_json` as a JSON string of either: - { "ops": [...] } - or just an array of op objects. Each op must be one of the 8 strict kinds (see prescribe_frankability_fixes). The applier validates every op, snapshots affected files, applies, runs frank.toJSON to verify, and rolls back if the result regresses against the pre-apply state. Args: symbols_dir: Absolute path to the symbols/ directory. ops_json: JSON string containing the edit ops. Returns: JSON with applied/skipped/rolledBack/baseline/finalSta…

• audit_and_fix_frankability

  Run frank-audit and optionally apply fixes — supports a sampling-driven LLM loop that resolves findings the mechanical fixer can't safely handle. Modes: 'report' — run audit, list findings, do not modify files 'safe-fix' — apply mechanical fixes with verify-or-rollback safety (every applied fix is verified against frank.toJSON; regressions roll back) 'full' — run safe-fix first, THEN drive an LLM loop via MCP sampling over the remaining prescriptions: 1. prescribe_frankability_fixes(dir) → JSON prescriptions 2.…

• audit_component

  Audit a Symbols/DOMQL file (component, page, function, …) for v3 compliance — checks for v2 syntax, raw px values, hardcoded colors, direct DOM manipulation, and more. Pass file_path so the checks that depend on the file's folder apply where it really lives; without it the code is audited as a component. Also warns on four STRICT shape rules: one condition repeated across 3+ CSS props (Rule 19 — use isX + '.isX'), an interactive element with ':hover' but no ':active' (Rule 65), a state-driven `if:` on an element in flow beside siblings (Rule 66 — keep it mounted, toggle visibility), a built-in…

• audit_project

  Returns the multi-phase PROJECT AUDIT PLAYBOOK (instructions for the agent). Strict mode is the default. Strict means EXHAUSTIVE — the agent does not stop until every finding is `resolved`, `framework_bug` (in framework_audit_results.md), or an active `🟢 ASK USER` block awaiting user input. No finding stays `open`. Two CLI flags (default ON in strict mode, both opt-out via --no-...): - `--deep-fix`: agent does NOT stop at first blocker (missing project key, auth-protected route, missing CLI subcommand). Surfaces ASK-USER blocks or runs documented fallbacks (e.g. publish blocked → local …

• convert_html

  Convert raw HTML/CSS to Symbols.app DOMQL v3 components with full context.

• convert_react

  Convert React/JSX code to Symbols.app DOMQL v3 with migration context.

• convert_to_json

  Convert DOMQL v3 JavaScript source code to platform JSON format. Parses export statements, stringifies functions, outputs JSON ready for save_to_project.

• create_project

  Create a new Symbols project on the platform.

• detect_environment

  Detect project type (local, CDN, JSON runtime, or remote server) based on project indicators.

• explain_frankability_rule

  Return the documentation block for a specific frank-audit rule. Each rule (FA001 through FA902) has an `explain()` method that returns a human-readable description, examples of the bad/good patterns, and the rationale. Use this when an agent encounters an unfamiliar finding and needs context before deciding on a fix. Args: rule_id: The rule ID (e.g. 'FA301', 'FA806'). Returns: JSON with { ok, ruleId, name, severity, description, explanation }.

• frankability_log

  Tail the audit log for a Symbols project. Returns the most recent NDJSON entries from `<symbols_dir>/.frank-audit/log`. Each entry records audit/fix/apply-edits/rollback events with opId, timestamp, and outcome — useful for understanding history without re-running ops. Args: symbols_dir: Absolute path to the symbols/ directory. limit: Maximum number of entries to return (default 50). Returns: JSON with { ok, entries: [...] }.

• generate_component

  Generate a Symbols.app DOMQL v3 component from a description with full context (rules, syntax, cookbook, default library).

• generate_page

  Generate a Symbols.app page with routing integration and full context.

• get_cli_reference

  Returns the complete Symbols CLI (@symbo.ls/cli) command reference — all smbls commands, options, and workflows.

• get_project

  Get a project's current data (components, pages, design system, state).

Compare and alternatives

Featured in

• Best MCP servers for code generation

Signals

Stars

1

Forks

0

Open issues

2

Weekly downloads

664

Last commit

Oct 24, 2026 (7 days ago)

Last release

Oct 22, 2026 (9 days ago)

Last package publish

Oct 21, 2026 (9 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.symbo-ls/symbols-mcp

Version

3.14.779

Auth

No auth

Packages

pypi symbols-mcp

License

CC-BY-NC-4.0

Repository

github.com/symbo-ls/symbols-mcp

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql