Skip to main content
Glama
focal-mcp
by BAESI

FOCAL MCP Server

FOCAL MCP (Framework for Orchestrated Central AI ruLes) is a local MCP server that centralizes AI behavior rules and applies them across tools like Codex, Claude Code, and Cursor.

Quick Start

Prerequisites

  • uv installed (required for uvx)

uvx --from focal-mcp-server focal-mcp-server

Open the Web UI:

http://127.0.0.1:8765

MCP endpoint:

http://127.0.0.1:8765/mcp

WebSocket notifications:

ws://127.0.0.1:8765/mcp/ws

Related MCP server: mcp-rule-engine

Configure Your MCP Client

FOCAL MCP uses streamable HTTP, so you start the server yourself and point clients to the URL above.

Codex (example)

Add the following to ~/.codex/config.toml:

[mcp_servers.focal]
enabled = true
url = "http://127.0.0.1:8765/mcp"

Restart Codex after saving.

Edit Rules (Live)

Rules live outside the repo in:

~/.focal_mcp/workspace/
  core/
    system.md
    style.md
    safety.md
    tool_policy.md
  agents/

Use the Web UI to edit files. Updates are applied immediately.

How Rules Are Applied

FOCAL MCP exposes a tool named focal_rules. Agents should call it before every response to fetch the latest rules.

If rules do not update immediately:

  1. Ensure the client is connected to the MCP server.

  2. Ensure the client calls focal_rules before responding.

  3. Reconnect the client if needed.

Project Prompt (Codex)

The repository-level prompt is stored in:

agents.md

Roadmap

  • Project-specific rule management for multi-repo workflows

  • UI/UX improvements for rule editing and visibility

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides AI agents with queryable, version-controlled project rules and coding standards. Enables validation, rule-based guidance, and task summaries to keep AI work aligned with your project's conventions without repeating context.
      2
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      Captures code modifications via AST analysis, generates reusable rules, and injects them into AI agent context with version audit and token-budgeted rule retrieval.
      28
      8 npm
      Apache 2.0
    • A
      license
      B
      quality
      B
      maintenance
      Enables AI coding assistants to persist and recall project-specific conventions, prohibitions, and repair lessons locally, with approved rule injection before tasks and no external API calls.
      15
      370 PyPI
      MIT