Foreman MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| FOREMAN_URL | No | The URL of the Foreman server | https://$hostname |
| FOREMAN_PASSWORD | No | The password for Foreman authentication | changeme |
| FOREMAN_USERNAME | No | The username for Foreman authentication | admin |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| call_foreman_apiC | Call an action on a Foreman API resource. Needs Foreman API resource to be available. |
| fetch_foreman_dsl_docsC | Fetches the DSL documentation from Foreman. |
| get_foreman_api_resource_docsC | Fetches the documentation for given Foreman API resource. |
| Get Foreman DSL DocumentationB | Reads from cache and returns the documentation of available macros for template writing in Markdown format based on provided section. Refer to foreman://documentation/dsl/sections for available sections. |
Prompts
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 |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Foreman Resources | Provides a list of all resources available in the Foreman API. |
| Foreman API Resource | Checks if the Foreman API is available and can be used. |
| 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. |
TDQS
Scored across 4 tools
The tools have some overlap in purpose, particularly around documentation fetching. 'fetch_foreman_dsl_docs' and 'Get Foreman DSL Documentation' both retrieve DSL documentation, though one fetches from source and the other from cache. 'call_foreman_api' is distinct as an action tool, while 'get_foreman_api_resource_docs' focuses on API resource documentation. The descriptions help clarify the differences, but the two DSL documentation tools could cause confusion.
The naming is inconsistent with mixed conventions. 'call_foreman_api', 'fetch_foreman_dsl_docs', and 'get_foreman_api_resource_docs' follow a snake_case pattern with verb prefixes, but 'Get Foreman DSL Documentation' uses a different style with spaces and title case. This deviation breaks the pattern and reduces predictability, though the core naming is still readable.
With 4 tools, the count is reasonable for a server focused on Foreman API interactions and documentation. It covers core operations like calling the API and fetching documentation, though it might feel slightly thin if more advanced actions are needed. The scope is well-defined, and each tool has a clear role, making the count appropriate for the apparent purpose.
The tool set covers basic API calls and documentation retrieval, but there are notable gaps. It lacks operations for managing Foreman resources (e.g., create, update, delete) and does not provide full CRUD coverage. Agents can work around this by using 'call_foreman_api' for various actions, but the surface is incomplete for comprehensive Foreman management, focusing more on documentation and generic API access.