frontend-mcp

PyPI alias for frontend-perception-engine.

Deterministic browser runtime + fast code resolvers for AI coding agents.

Install

pip install --upgrade frontend-mcp
frontend-mcp-install    # optional: prints Cursor config
frontend-mcp

Or:

uvx --from frontend-mcp frontend-mcp-install
uvx --from frontend-mcp frontend-mcp

Agent quick start

Read perception://agent-guide at session start
perception_health → perception_session_start
perception_navigate_and_observe → save scan_id
Code ↔ UI: perception://resolver-guide → perception_resolve_route (not perception_code_context)
Edit files → perception_verify (never skip)

Key MCP resources

URI	Use
`perception://agent-guide`	Main playbooks
`perception://resolver-guide`	`perception_resolve_*` tools
`perception://seo-guide`	`perception_seo_audit_start` + poll

Local development

Point Cursor at your checkout:

{
  "mcpServers": {
    "frontend-mcp": {
      "command": "python",
      "args": ["-m", "navigation.mcp"],
      "env": {
        "PYTHONPATH": "/path/to/frontend-perception-engine/src",
        "FRONTEND_PERCEPTION_DEFAULT_REPO_ROOT": "/path/to/frontend-perception-engine/sandbox"
      }
    }
  }
}

Restart MCP after changes. Run smoke: python scripts/phase3_mcp_smoke.py

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

frontend_mcp-1.2.0.dev22.tar.gz (2.0 kB view details)

Uploaded Jul 22, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

frontend_mcp-1.2.0.dev22-py3-none-any.whl (2.4 kB view details)

Uploaded Jul 22, 2026 Python 3

File details

Details for the file frontend_mcp-1.2.0.dev22.tar.gz.

File metadata

Download URL: frontend_mcp-1.2.0.dev22.tar.gz
Upload date: Jul 22, 2026
Size: 2.0 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for frontend_mcp-1.2.0.dev22.tar.gz
Algorithm	Hash digest
SHA256	`c2b641f7e92675d549a4aa7591f93ec3922ceca5f7ca2ba65900645ac79170b4`
MD5	`9973a4df09d97cc54e862f290599f983`
BLAKE2b-256	`6753b8ffd5d83202b155dc8f88dd6985593fb46ac818b1c003b98ce593fe2857`

See more details on using hashes here.

File details

Details for the file frontend_mcp-1.2.0.dev22-py3-none-any.whl.

File metadata

Download URL: frontend_mcp-1.2.0.dev22-py3-none-any.whl
Upload date: Jul 22, 2026
Size: 2.4 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for frontend_mcp-1.2.0.dev22-py3-none-any.whl
Algorithm	Hash digest
SHA256	`665bfd75dfb8905bd1c3630352bd3fbd346233f2b039cb2087f23f8985b1a2ff`
MD5	`503391b063e445d347945b31ce94f951`
BLAKE2b-256	`b6a7b28f5256d101c4b770abca2a44c3611e36132ce4462b87e0f6cfdd7c0c28`