IGLOO_MCP_COMMUNITY - Base URL of your Igloo community
IGLOO_MCP_COMMUNITY_KEY - Numeric identifier for your digital workplace
IGLOO_MCP_APP_ID - Application ID for the Igloo API
IGLOO_MCP_APP_PASS - Application password for the Igloo API
IGLOO_MCP_USERNAME - Username to authenticate with
IGLOO_MCP_PASSWORD - Password to authenticate with
Optional:
IGLOO_MCP_SERVER_NAME (default: "Igloo") - Server name shown to clients
IGLOO_MCP_SERVER_INSTRUCTIONS (default: "Use this server to search and retrieve information from an Igloo instance.") - Instructions describing the server's purpose and capabilities to clients.
IGLOO_MCP_FETCH_MAX_LENGTH (default: 50000) - Maximum Markdown content length per page (1000-500000)
IGLOO_MCP_FETCH_TIMEOUT (default: 15.0) - Timeout in seconds for fetch requests (5.0-120.0)
IGLOO_MCP_FETCH_MAX_PAGES (default: 5) - Maximum number of URLs per multi-URL fetch request (1-20)
Transport Options
By default, the server uses stdio transport. For HTTP transport, set IGLOO_MCP_TRANSPORT="streamable-http" - the server will be available at http://localhost:8000/mcp.
Available Tools
search_content
Search for content in the Igloo community with extensive filtering options.
Key Parameters:
query: Search query text
applications: Filter by type (blog, wiki, document, forum, gallery, calendar, pages, people, space, microblog)
sort: Sort by "default" or "views"
limit: Maximum results to return
updated_date_type: Filter by date (past_hour, past_24_hours, past_week, past_month, past_year, custom_range)
include_archived: Include archived content (default: false)
fetch_content
Fetch one or more pages from the Igloo community and convert to Markdown for LLM consumption.
Parameters:
url: A single URL string or a list of URLs to fetch
max_length: Maximum Markdown content length per page (optional, uses config default)
start_index: Character offset to start reading from (optional). Use the next_start_index value from a previous truncated response to continue reading. Cannot be used with section. Ignored for multi-URL requests.
section: Name of section to jump to, e.g., "API Reference" (optional). Case-insensitive, fuzzy matches Markdown headers. Cannot be used with start_index. Ignored for multi-URL requests.
Smart Truncation:
When content exceeds max_length, the response is truncated at semantic boundaries (paragraphs, sentences) rather than mid-sentence. Truncated responses include navigation metadata:
Total document size and percentage shown
List of remaining sections
A CONTINUE hint with the exact next_start_index cursor for seamless continuation
Example Workflow:
1. Agent: fetch_content(url="https://igloo.example.com/wiki/deployment")
Response: [content] + "CONTINUE: fetch_content(url="...", start_index=49801)"
2. Agent continues: fetch_content(url="...", start_index=49801)
OR jumps to section: fetch_content(url="...", section="Troubleshooting")
search_members
Search for members in the Igloo community by name. Returns basic information only.
Parameters:
query: Name or partial name to search for (e.g., "John Smith", "Jane")
limit: Maximum number of members to return (default: 10)
Returns:
List of matching members with basic info (name, email, member ID)
Use the member_id with fetch_members to get detailed profiles
Use Cases:
Looking for someone by name
Need to identify which member to get more information about
fetch_members
Get detailed profile information for one or more members by their ID(s).
Parameters:
members_ids: A list of member IDs (obtained from search_members results)
Returns:
Detailed member profile(s) including:
Full name and email
Job title and department
Manager name
Contact information (phone, office location)
Profile URL
Example Workflow:
1. Agent: search_members(query="John Smith")
Response: [list of matching members with their member_ids]
2. Agent: fetch_members(members_ids=["12345-abcd-..."])
Response: [detailed profile for John Smith]
3. Agent: fetch_members(members_ids=["12345-abcd-...", "67890-efgh-..."])
Response: [detailed profiles for multiple members]
Docker
cp .env.example .env # Configure your credentials
docker compose up -d
The server will be available at http://localhost:8000/mcp with a health check at /health.