Foreman MCP Server

Official

Describes the environment variables required to run the server.

Name	Required	Description	Default
`HOST`	No	The host address to bind the server to.	127.0.0.1
`PORT`	No	The port number to bind the server to.	8080
`LOG_LEVEL`	No	Logging level. Options include debug, info, warning, error, critical.	INFO
`TRANSPORT`	No	The transport protocol to use (stdio or streamable-http).	streamable-http
`FOREMAN_URL`	Yes	URL of the Foreman instance. Defaults to https://$hostname if not provided.	https://$hostname
`FOREMAN_TOKEN`	No	Foreman authentication token.
`NO_VERIFY_SSL`	No	Set to 'true' to disable SSL certificate verification.
`FOREMAN_PASSWORD`	No	Foreman password for authentication.
`FOREMAN_USERNAME`	Yes	Foreman username for authentication.
`FOREMAN_CA_BUNDLE`	No	Path to a custom CA certificate bundle (e.g., /path/to/ca-bundle.pem).

Features and capabilities supported by this server

Capability	Details
`tools`	{ "listChanged": true }
`prompts`	{ "listChanged": false }
`resources`	{ "subscribe": false, "listChanged": false }
`experimental`	{}

Functions exposed to the LLM to take actions

Name	Description
call_foreman_api_get	Calls GET action on Foreman API.
fetch_foreman_dsl_docs	Fetches the DSL documentation from Foreman for a specific section.
get_foreman_api_resource_docs	Fetches the documentation for a specific Foreman API resource.
get_foreman_dsl_docs	Reads from cache and returns the documentation of available macros for template writing in Markdown format based on provided section.
poll_task	Polls a Foreman task until it reaches a terminal state (stopped or paused). Returns the final task state. Supports background execution for long-running tasks.

Interactive templates invoked by user choice

Name	Description
`Basic Subnets Static Report`	A prompt for generating a static report of all subnets in Foreman.
`Basic Hosts Pending Security Updates Static Report`	A prompt for generating a static report of hosts with pending security updates in Foreman.
`Basic Template Writing`	A prompt for writing a basic template in Foreman
`Apply Errata to Hosts`	A prompt for applying a specific errata to applicable hosts in Foreman using remote execution.
`Add Errata to Content Views`	A prompt for adding a specific errata to content views and making it available to hosts through publishing and promotion.

Contextual data attached and managed by the client

Name	Description
`Foreman Resources`	Provides a list of all resources available in the Foreman API.
`Foreman DSL Sections`	Returns all Foreman DSL sections available for template writing.
`Foreman Template Kinds`	Provides a list of all template kinds available in Foreman.
`Foreman Template Models`	Provides a list of all template models available in Foreman.
`Foreman Template Schema`	Returns the schema of a Foreman template.

Latest Blog Posts

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

curl -X GET 'https://glama.ai/api/mcp/v1/servers/theforeman/foreman-mcp-server'

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