Alloy Navigator MCP Server
by wyre-aiio.github.WYRE-AI/alloy-navigator-mcpv1.0.0
MCP server for Alloy Navigator's REST API - IT asset management and ITSM data for MSPs.
context tax
queued
security
queued
cold start
queued
freshness
Active19d ago
Install Alloy Navigator MCP server
Install in Claude Code
claude mcp add alloy-navigator -e ALLOY_BASE_URL='<alloy-base-url>' -e ALLOY_CLIENT_ID='<alloy-client-id>' -e ALLOY_CLIENT_SECRET='<alloy-client-secret>' -- docker run -i --rm -e ALLOY_BASE_URL -e ALLOY_CLIENT_ID -e ALLOY_CLIENT_SECRET ghcr.io/wyre-ai/alloy-navigator-mcp:v1.0.0Install in Cursor
{
"mcpServers": {
"alloy-navigator": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ALLOY_BASE_URL",
"-e",
"ALLOY_CLIENT_ID",
"-e",
"ALLOY_CLIENT_SECRET",
"ghcr.io/wyre-ai/alloy-navigator-mcp:v1.0.0"
],
"env": {
"ALLOY_BASE_URL": "<alloy-base-url>",
"ALLOY_CLIENT_ID": "<alloy-client-id>",
"ALLOY_CLIENT_SECRET": "<alloy-client-secret>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"alloy-navigator": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ALLOY_BASE_URL",
"-e",
"ALLOY_CLIENT_ID",
"-e",
"ALLOY_CLIENT_SECRET",
"ghcr.io/wyre-ai/alloy-navigator-mcp:v1.0.0"
],
"env": {
"ALLOY_BASE_URL": "<alloy-base-url>",
"ALLOY_CLIENT_ID": "<alloy-client-id>",
"ALLOY_CLIENT_SECRET": "<alloy-client-secret>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"alloy-navigator": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ALLOY_BASE_URL",
"-e",
"ALLOY_CLIENT_ID",
"-e",
"ALLOY_CLIENT_SECRET",
"ghcr.io/wyre-ai/alloy-navigator-mcp:v1.0.0"
],
"env": {
"ALLOY_BASE_URL": "<alloy-base-url>",
"ALLOY_CLIENT_ID": "<alloy-client-id>",
"ALLOY_CLIENT_SECRET": "<alloy-client-secret>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"alloy-navigator": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ALLOY_BASE_URL",
"-e",
"ALLOY_CLIENT_ID",
"-e",
"ALLOY_CLIENT_SECRET",
"ghcr.io/wyre-ai/alloy-navigator-mcp:v1.0.0"
],
"env": {
"ALLOY_BASE_URL": "<alloy-base-url>",
"ALLOY_CLIENT_ID": "<alloy-client-id>",
"ALLOY_CLIENT_SECRET": "<alloy-client-secret>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| ALLOY_BASE_URL | yes | — | Base URL of the Alloy Navigator server this connector talks to, e.g. https://alloy.example.com. Every Alloy Navigator instance is self-hosted (on-prem or self-hosted-cloud); there is no shared hosted endpoint. |
| ALLOY_CLIENT_ID | yes | yes | Application account client ID, registered in Alloy Navigator's Settings App under Services > API > Applications. |
| ALLOY_CLIENT_SECRET | yes | yes | Application account client secret, issued alongside the client ID. |
| MCP_TRANSPORT | — | — | Transport mode for the server. Set to 'stdio' for local CLI use; the image defaults to 'http' for gateway hosting. |
| AUTH_MODE | — | — | Credential source: 'env' reads vars locally, 'gateway' expects header injection from the WYRE MCP Gateway. |
| LOG_LEVEL | — | — | Log verbosity: debug, info, warn, error |
Freshness
Active — last maintenance signal 19d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-21 · 19d ago · GitHub
Latest release
2026-09-21 · 19d ago · GitHub · v1.0.0
Package published
no data · npm/PyPI
Registry entry updated
2026-09-21 · 19d ago · official registry · v1.0.0
FAQ
›How do I install the Alloy Navigator MCP server in Claude Code?
Run: claude mcp add alloy-navigator -e ALLOY_BASE_URL='<alloy-base-url>' -e ALLOY_CLIENT_ID='<alloy-client-id>' -e ALLOY_CLIENT_SECRET='<alloy-client-secret>' -- docker run -i --rm -e ALLOY_BASE_URL -e ALLOY_CLIENT_ID -e ALLOY_CLIENT_SECRET ghcr.io/wyre-ai/alloy-navigator-mcp:v1.0.0. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Alloy Navigator require an API key?
Yes. It expects ALLOY_BASE_URL, ALLOY_CLIENT_ID, ALLOY_CLIENT_SECRET, of which 2 are secrets.
›Can I use Alloy Navigator as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Alloy Navigator in the official MCP registry?
Yes, as io.github.WYRE-AI/alloy-navigator-mcp.