Skip to main content
Glama
commit-check

commit-check-mcp

Official
by commit-check

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
server_healthA

Return server and dependency versions. Read-only, no side effects. Returns dict with server name, server version, commit-check version, and MCP SDK version. Useful as a first call to verify the server is running and check version compatibility.

validate_commit_messageA

Validate a commit message against commit-check rules. Read-only validation. Returns a structured result with overall status ('pass'/'fail') and a list of per-check results. Each check includes the check name, status, value, error message (on failure), and suggestion (on failure).

Use this tool when you have a specific commit message string to validate. For batch validation of message, branch, and author together, use validate_commit_context instead.

Parameters:

  • message (required): The commit message text to validate.

  • config (optional): Inline JSON config overrides on top of any loaded config file.

  • repo_path (optional): Path to the git repository for repo-relative config loading.

  • config_path (optional): Path to a custom commit-check TOML config file.

validate_branch_nameA

Validate branch naming conventions with commit-check. Read-only validation. Returns a structured result with overall status ('pass'/'fail') and per-check results (check name, status, value, error, suggest).

Use this when you need to verify a branch name follows configured convention rules (e.g., feature/, bugfix/). For combined message+branch+author validation, use validate_commit_context.

Parameters:

  • branch (optional): The branch name to validate. If omitted, detected from the current repo.

  • config (optional): Inline JSON config overrides.

  • repo_path (optional): Path to the git repository.

  • config_path (optional): Path to a custom commit-check TOML config file.

validate_author_infoA

Validate commit author name and/or email with commit-check. Read-only validation. Returns a structured result with overall status and per-check results (check name, status, value, error, suggest).

Use this when you need to verify author metadata against configured rules (e.g., allowed email domains, name patterns). When both name and email are provided, both are validated. If neither is provided, both are checked against repo context. For combined validation, use validate_commit_context.

Parameters:

  • author_name (optional): The author name to validate.

  • author_email (optional): The author email to validate.

  • config (optional): Inline JSON config overrides.

  • repo_path (optional): Path to the git repository.

  • config_path (optional): Path to a custom commit-check TOML config file.

validate_push_safetyA

Validate that a push is not a force push. Read-only validation. Returns a structured result with overall status and per-check results (check name, status, value, error, suggest). By default, force push is rejected; configure via 'push.allow_force_push' in config.

Use this before performing a git push to ensure force-push protection rules are satisfied. Only validates the no_force_push rule. Use validate_commit_context for combined checks.

Parameters:

  • push_refs (optional): The push ref specification to validate. If omitted, checks upstream fallback state.

  • config (optional): Inline JSON config overrides.

  • repo_path (optional): Path to the git repository.

  • config_path (optional): Path to a custom commit-check TOML config file.

validate_commit_contextA

Run combined commit-check validations for message, branch, and/or author in one call. Read-only validation. Returns a structured result with overall status and a unified list of per-check results (check name, status, value, error, suggest).

Use this when you need to validate multiple commit aspects simultaneously in a single call. At least one of message, branch, author_name, or author_email must be provided. For individual aspects, use the specific validate_commit_message, validate_branch_name, or validate_author_info tools.

Parameters:

  • message (optional): Commit message text to validate.

  • branch (optional): Branch name to validate.

  • author_name (optional): Author name to validate.

  • author_email (optional): Author email to validate.

  • config (optional): Inline JSON config overrides on top of any loaded config file.

  • repo_path (optional): Path to the git repository for repo-relative config loading.

  • config_path (optional): Path to a custom commit-check TOML config file.

validate_repository_stateA

Validate the current repository state including latest commit message, active branch, author metadata, and optional push safety. Read-only validation. Reads git data (message, branch, author) from the local repository. Returns a structured result with overall status and per-check results.

Use this to validate the entire state of a local git repository in one call — ideal for pre-commit or CI hooks. Controls which checks run via boolean include_* flags. For validating arbitrary (non-repo) values, use validate_commit_context or individual validation tools instead.

Parameters:

  • repo_path (optional): Path to the git repository. If omitted, uses current working directory.

  • config (optional): Inline JSON config overrides on top of any loaded config file.

  • config_path (optional): Path to a custom commit-check TOML config file.

  • include_message (optional, default true): Whether to validate the latest commit message.

  • include_branch (optional, default true): Whether to validate the current branch name.

  • include_author (optional, default true): Whether to validate the latest commit author.

  • include_push (optional, default false): Whether to validate push safety.

describe_validation_rulesA

Return enabled commit-check rules after merging defaults, repo config, and inline overrides. Read-only, no side effects. Returns a dict with commit_check_version, the full merged config, supported check types, and enabled rules (each with check name, config, and pattern details).

Use this to inspect which validation rules are currently active before running any validation. Helps debug rule configuration and check which checks will be applied.

Parameters:

  • config (optional): Inline JSON config overrides on top of any loaded config file.

  • repo_path (optional): Path to the git repository for repo-relative config loading.

  • config_path (optional): Path to a custom commit-check TOML config file.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/commit-check/commit-check-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server