Skip to main content
Glama
ofedoren

Foreman MCP Server

by ofedoren

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
FOREMAN_URLNoThe URL of the Foreman serverhttps://$hostname
FOREMAN_PASSWORDNoThe password for Foreman authenticationchangeme
FOREMAN_USERNAMENoThe username for Foreman authenticationadmin

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

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

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription
Basic Subnets Static ReportA prompt for generating a static report of all subnets in Foreman.
Basic Hosts Pending Security Updates Static ReportA prompt for generating a static report of hosts with pending security updates in Foreman.
Basic Template WritingA prompt for writing a basic template in Foreman

Resources

Contextual data attached and managed by the client

NameDescription
Foreman ResourcesProvides a list of all resources available in the Foreman API.
Foreman API ResourceChecks if the Foreman API is available and can be used.
Foreman DSL SectionsReturns all Foreman DSL sections available for template writing.
Foreman Template KindsProvides a list of all template kinds available in Foreman.
Foreman Template ModelsProvides a list of all template models available in Foreman.
Foreman Template SchemaReturns the schema of a Foreman template.

TDQS

C2.7/5.0

Scored across 4 tools

Disambiguation3/5

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.

Naming Consistency2/5

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.

Tool Count4/5

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.

Completeness3/5

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.

Maintenance

ActivityInactive
ResponsivenessNo issues