# workiq-mcp-bridge

CLI bridge that connects any local agent or LLM to Microsoft Work IQ's remote MCP server for enterprise grounding.

Work IQ (GA June 16, 2026) exposes organizational context, tools, and chat through a standard MCP server. This bridge lets you query it from the terminal, pipe results into your own agent, or use it as a standalone grounding layer without needing Microsoft 365 Copilot.

## What it does

1. Authenticates against Entra ID (device code flow or client credentials)
2. Connects to Work IQ's remote MCP endpoint via SSE transport
3. Exposes a local CLI to list tools, call them, and stream chat completions
4. Optionally proxies as a local MCP server so any MCP-compatible agent can consume Work IQ

## Quick start

```bash
npm install -g workiq-mcp-bridge

# Authenticate (device code flow)
workiq-mcp-bridge auth --tenant YOUR_TENANT_ID --client-id YOUR_CLIENT_ID

# List available Work IQ tools
workiq-mcp-bridge tools

# Query enterprise context
workiq-mcp-bridge context "Who owns the billing microservice?"

# Chat with grounding
workiq-mcp-bridge chat "Summarize last week's design decisions for Project Atlas"

# Run as local MCP proxy (other agents connect to localhost:3001)
workiq-mcp-bridge serve --port 3001
```

## Architecture

```
┌─────────────┐       ┌──────────────────┐       ┌───────────────┐
│ Your Agent  │──MCP──│ workiq-mcp-bridge │──SSE──│ Work IQ MCP   │
│ (local)     │       │ (localhost:3001)  │       │ (remote)      │
└─────────────┘       └──────────────────┘       └───────────────┘
                              │
                              ▼
                      Entra ID auth (MSAL)
```

## Requirements

- Node.js 20+
- An Entra ID app registration with Work IQ API permissions
- Access to Work IQ preview or GA (June 16, 2026)

## Configuration

Create `.workiq.json` in your project root or pass flags:

```json
{
  "tenantId": "your-tenant-id",
  "clientId": "your-client-id",
  "workiqEndpoint": "https://workiq.microsoft.com/mcp",
  "scopes": ["https://workiq.microsoft.com/.default"]
}
```

## Commands

| Command | Description |
|---------|-------------|
| `auth` | Authenticate via device code or client credentials |
| `tools` | List all Work IQ MCP tools available |
| `context <query>` | Query organizational context (grounded retrieval) |
| `chat <message>` | Send a grounded chat message |
| `serve` | Start local MCP proxy server |

## How it works

Work IQ's MCP server exposes a compact set of tools for context retrieval, chat, and workspace operations. This bridge handles the SSE transport, token refresh, and permission-aware scoping so you can focus on building your agent logic.

The local proxy mode re-exports Work IQ tools as a standard MCP server, meaning any framework (Semantic Kernel, LangChain, AutoGen, Copilot SDK) can consume enterprise intelligence without custom integration code.

## License

MIT