get_architecture
Get detailed information about a specific architecture.
LABSCO SUMMARY
Read-only, and built around not blowing up the context window.
Infrastructure inventories are big enough that a naive listing call is useless — one answer and the conversation is full. Every search here returns a capped page with selectable fields, which is what makes asking about a few thousand hosts practical. Nothing in the tool set changes state.
What it is
A read-only server over Foreman and Katello. It covers hosts and the searches that find them, the organisations, locations and hostgroups they belong to, the network objects around them, and the content side — content views, repositories and lifecycle environments. Results are capped by default so a large estate does not flood the context.
What you get
- Hosts listed with a search filter and a choice of fields, any single host in detail, and its status
- Hosts searched by location, operating system, environment, hostgroup, or an arbitrary fact name and value
- Organisations, locations and hostgroups listed
- Subnets and domains listed and read individually
- Smart proxies listed and read individually
- Operating systems, architectures and installation media, listed and read one at a time
- Katello content views, repositories and lifecycle environments, with field filtering on the large ones
- Deliberate result caps — the searches return a limited page by default rather than everything that matched
Requirements
A Foreman instance, and in the environment its URL, a username, a password and whether to verify SSL. The password field takes a Personal Access Token, created under User Administration, Personal Access Tokens, not your web login password. The account needs the view_ permissions for hosts, organizations, locations, hostgroups, subnets, domains and smart proxies — the built-in Viewer role covers it. A recent Python, pip install foreman-mcp-server.
Setup effort
One command plus credentials — pip install foreman-mcp-server, then supply credentials
USE CASES
01
Finding a host you only know something about
Search by location, by operating system or by environment, then read the one that matches in full.
02
Checking whether a machine is healthy before you touch it
Read the host and its status rather than opening the Foreman web UI.
03
Answering "how many of these are out there"
Search on a fact name and value, or by hostgroup, and count from a filtered list instead of the whole estate.
04
Getting oriented in someone else's Foreman
List the organisations, locations and hostgroups first, so later searches use names that exist.
05
Tracing a network problem to its configuration
List the subnets and domains, then read the specific one, and check the smart proxy that serves it.
06
Working out what a build will actually install
Read the operating systems, architectures and media on offer, then the content view, repository and lifecycle environment behind them.
29 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
get_content_view
Get detailed information about a specific content view.
get_domain
Get detailed information about a specific domain.
get_host
Get detailed information about a specific host
get_host_status
Get status information for a specific host.
get_lifecycle_environment
Get detailed information about a specific lifecycle environment.
get_media
Get detailed information about a specific installation media.
get_operatingsystem
Get detailed information about a specific operating system.
get_repository
Get detailed information about a specific repository.
get_smart_proxy
Get detailed information about a specific smart proxy.
get_subnet
Get detailed information about a specific subnet.
list_architectures
List all architectures in Foreman.
CONTEXT OPTIMIZATION: Only 6 architectures total. Safe for context window.
list_content_views
List all content views in Foreman/Katello with field filtering.
CONTEXT OPTIMIZATION: 102 total content views! Use per_page=5-10 max. Each content view has extensive metadata. Consider getting specific CV by ID.
Field filtering: By default returns essential fields only (id, name, version_count, latest_version). Use include_fields="all" for complete data, or specify comma-separated fields.
list_domains
List all domains in Foreman.
CONTEXT OPTIMIZATION: DNS domains typically <30. Safe for context window.
list_hostgroups
List all hostgroups in Foreman.
CONTEXT OPTIMIZATION: Can be 50+ hostgroups. Consider using search if available.
list_hosts
List hosts from Foreman with optional search filter and field filtering.
CONTEXT OPTIMIZATION: Default per_page=10 to prevent overflow. Use search filters like 'location ~ SYD03' or 'os ~ Windows' to narrow results. Total hosts available: ~1000+. Always use search parameter for large inventories.
Field filtering: By default returns essential fields only (id, name, ip, os, location, status). Use include_fields="all" for complete data, or specify comma-separated fields like "id,name,ip,mac".
list_lifecycle_environments
List all lifecycle environments for a specific organization in Foreman/Katello.
CONTEXT OPTIMIZATION: 16 total environments. Safe for context window.
Args: organization_id: Required numeric organization ID (e.g., "1", "4"). Organization names are not supported by this endpoint. per_page: Number of results per page. include_fields: Field filtering options.
Field filtering: By default returns essential fields only (id, name, description, library). Use include_fields="all" for complete data, or specify comma-separated fields.
list_locations
List all locations in Foreman.
CONTEXT OPTIMIZATION: Typically <30 locations. Safe for context window.
list_media
List all installation media in Foreman.
CONTEXT OPTIMIZATION: 22 total media entries. Safe for context window.
list_operatingsystems
List all operating systems in Foreman.
CONTEXT OPTIMIZATION: 67 total OS entries. Use per_page=5-10 for quick overview.
list_organizations
List all organizations in Foreman.
CONTEXT OPTIMIZATION: Typically <20 organizations. Safe for context window.
list_repositories
List all repositories in Foreman/Katello with field filtering.
⚠️ CONTEXT WARNING: 258 total repositories with extensive metadata! Use per_page=5 max or context will overflow. Consider specific repo searches.
Field filtering: By default returns essential fields only (id, name, content_type, url, product). Use include_fields="all" for complete data, or specify comma-separated fields.
list_smart_proxies
List all smart proxies in Foreman.
CONTEXT OPTIMIZATION: Smart proxies typically <20. Safe for context window.
list_subnets
List all subnets in Foreman.
CONTEXT OPTIMIZATION: Network subnets typically <50. Safe for context window.
search_hosts_by_environment
Search hosts by environment (e.g., 'production', 'development').
CONTEXT OPTIMIZATION: Returns max 10 results by default.
search_hosts_by_fact
Search hosts by a specific fact name and value.
CONTEXT OPTIMIZATION: Returns max 10 results by default.
search_hosts_by_hostgroup
Search hosts by hostgroup name or title.
CONTEXT OPTIMIZATION: Returns max 10 results by default.
search_hosts_by_location
Search hosts by location (e.g., 'SYD03', 'MEL03').
CONTEXT OPTIMIZATION: Returns max 10 results by default. Use specific location codes for best results.
search_hosts_by_os
Search hosts by operating system (e.g., 'Windows', 'Oracle Linux').
CONTEXT OPTIMIZATION: Returns max 10 results by default. Use specific OS names like 'Windows Server 2022' for targeted results.
BEFORE YOU INSTALL
What to know first
Tools you get
29 tools when we connected. All tools are read-only; none creates, updates, reboots or deletes, and the documentation recommends Foreman's built-in Viewer role.
Requires
- FOREMAN_PASSWORD in your environment
- FOREMAN_USERNAME in your environment
Where it runs
The documented client runs the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 29 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
pip install foreman-mcp-serverMCP Clients
Any MCP client
ANY MCP CLIENT · JSON
{
"mcpServers": {
"foreman-mcp-server": {
"command": "foreman-mcp-server",
"env": {
"FOREMAN_URL": "<YOUR_FOREMAN_URL>",
"FOREMAN_USERNAME": "<YOUR_FOREMAN_USERNAME>",
"FOREMAN_PASSWORD": "<YOUR_FOREMAN_PASSWORD>",
"FOREMAN_VERIFY_SSL": "true"
}
}
}
}
