Foreman MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Foreman MCP Server list all hosts with pending security updates"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
foreman-mcp-server
How to run
Using VSCode with Copilot
Start the server via uv
uv run foreman-mcp-server \
--foreman-url https://foreman.example.com \
--foreman-username $FOREMAN_USERNAME \
--foreman-password $FOREMAN_PASSWORD \
--log-level debug \
--host localhost \
--port 8080
--transport streamable-httpDefault values if not provided:
--foreman-url https://$hostname
--foreman-username admin
--foreman-password changeme
--log-level INFO
--host '127.0.0.1'
--port 8080
--transport streamable-httpRelated MCP server: foreman-mcp-py
Configure VSCode
# settings.json
{
"mcp": {
"servers": {
"foreman": {
"url": "http://127.0.0.1:8080/mcp/sse"
}
}
},
}Run VSCode client
Press Ctrl+Shift+P
Select MCP: List Servers command
Select foreman
Press Start Server
Using in Copilot Chat
Press Ctrl+Alt+I to open the chat
In Configure Tools select the MCP tools only
Prompts can be listed in the chat, e.g. /mcp.foreman.basic_hosts_pending_sec_updates_static_report
Resources can be attached via Add Context... > MCP Resources > resource
Using MCP Inspector
For use with mcp inspector
Start the inspector with
npx @modelcontextprotocol/inspectorOpen
http://localhost:6274in your browserSet
TypetoStreamable HTTPandURLtohttp://localhost:8080/mcp
or set
TypetoSSEandURLtohttp://localhost:8080/sse
Click connect
Using Claude Desktop on Linux
Note: this is highly experimental. Tested in a virtual machine running CentOS Stream 9.
Installation
Follow installation steps https://github.com/bsneed/claude-desktop-fedora?tab=readme-ov-file#1-fedora-package-new
If it doesn't launch, try `npm i -g electron
Configuration
# ~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"foreman": {
"command": "uv",
"args": ["--directory", "/home/$USER/foreman-mcp-server", "run","foreman-mcp-server", "--transport", "stdio"],
}
}
}Run Claude client
This will launch UI application, log in into your account. It will start and connect to the MCP server automatically.
claude-desktopClick
+button > Add from foreman: > Select any of Prompts and Resources from the serverClick Configuration button to select Tools from the server
Available Tools
4 toolscall_foreman_apiC
Call an action on a Foreman API resource. Needs Foreman API resource to be available.
Inputs: resource (required), action (required), params (required).
fetch_foreman_dsl_docsC
Fetches the DSL documentation from Foreman.
Inputs: section (required).
get_foreman_api_resource_docsC
Fetches the documentation for given Foreman API resource.
Inputs: resource (required).
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.
Inputs: section (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
Maintenance
Related MCP Connectors
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Your org's AI agents, tasks, runs, search, and brain files as MCP tools and resources.
Toolstile is a managed MCP gateway that connects remote MCP servers behind one endpoint, with per-agent permissions, shared accounts and activity logs. Connect at https://mcp.toolstile.com/mcp over Streamable HTTP with OAuth; sign in at https://toolstile.com, select a workspace and connect your upstream servers. Available tools, resources and prompts depend on that workspace and the agent's granted access.
Find, vet, and run MCP tools through a secure audited gateway with prompt-injection risk scoring
Related MCP Servers
AlicenseBqualityCmaintenanceEnables interaction with Foreman instances to manage systems through the Model Context Protocol. It provides access to Foreman resources and tools, such as security update reports, directly within AI-powered environments like VSCode and Claude Desktop.512GPL 3.0- FlicenseNot gradedqualityDmaintenanceMCP server to interact with Foreman (Red Hat Satellite) instances, enabling management of hosts, provisioning, and configuration via natural language.1-
- AlicenseCqualityBmaintenanceEnables AI agents to manage system updates, application installations, and remote host orchestration through MCP tools.813MIT
- AlicenseBqualityDmaintenanceMCP server for managing Foreman hosts and infrastructure. Enables listing, searching, and getting detailed information about hosts, organizations, locations, subnets, domains, and more via natural language.29MIT