Metadata-Version: 2.4
Name: exclugo-client-mcp
Version: 0.1.1
Summary: Client-only MCP server for Exclugo facility users
Author: Exclugo
License: MIT
Requires-Python: >=3.10
Requires-Dist: httpx>=0.25
Requires-Dist: mcp[cli]<2,>=1.0
Description-Content-Type: text/markdown

# Exclugo Client MCP

> **These instructions are for Claude Desktop.** Support for other AI assistants is coming soon.

[![PyPI](https://img.shields.io/pypi/v/exclugo-client-mcp)](https://pypi.org/project/exclugo-client-mcp/)

Talk to Claude about **your** Exclugo account — dashboard, people, licenses, alerts, reports, and orders — in plain English.

After a one-time setup, you never log in. There is no username or password. Your Exclugo admin gives you an API token once; you paste it into Claude Desktop.

---

## Setup (about 5 minutes)

### 1. Install `uv`

`uv` is a small tool that runs Exclugo for Claude. You only install it once.

**Mac**

1. Open **Terminal** (`Cmd + Space`, type Terminal, press Enter).
2. Paste this and press Enter:

   ```bash
   curl -LsSf https://astral.sh/uv/install.sh | sh
   ```

3. Quit Terminal completely (`Cmd + Q`) and reopen it.

**Windows**

1. Open **PowerShell**.
2. Paste this and press Enter:

   ```powershell
   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
   ```

3. Close PowerShell completely and reopen it.

### 2. Get your API token

1. Log in to [Exclugo](https://app.exclugo.com) and go to **Users** (`app.exclugo.com/users`).
2. Click **Edit** on the user you want to connect.
3. Scroll to the **Claude Token** section and copy the token.

If you don't see the Users page or the Claude Token section, ask your account admin to enable user management for your login.

### 3. Add it to Claude Desktop

1. Open Claude Desktop.
2. **Claude** menu → **Settings…** → **Developer** → **Edit Config**.
3. Paste this (replace `paste-token-here` with your token):

   ```json
   {
     "mcpServers": {
       "exclugo-client": {
         "command": "uvx",
         "args": ["exclugo-client-mcp"],
         "env": {
           "EXCLUGO_BASE_URL": "https://app.exclugo.com",
           "EXCLUGO_API_TOKEN": "paste-token-here"
         }
       }
     }
   }
   ```

   If you already have other servers listed, add only the `"exclugo-client": { ... }` block inside `"mcpServers"`.

4. Save (`Cmd + S` or `Ctrl + S`).
5. Fully quit Claude Desktop (`Cmd + Q` on Mac) and reopen it.

You should see a hammer icon in the chat box. Click it — those are your Exclugo tools.

---

## Try it

- *Show me my dashboard.*
- *Who is flagged at my facilities?*
- *Find Jane Doe born 1984-03-12.*
- *Open report 184920.*
- *Which licenses expire in the next 30 days?*
- *Order a new employee screening for John Smith at Sunrise Care.*

Claude only sees **your** account. If something is turned off for your login, Claude will say your account admin needs to enable it in Exclugo.

---

## Troubleshooting

**“Failed to spawn process: No such file or directory”**

`uv` is not installed, or Claude was not restarted after installing it. Redo step 1, then fully quit and reopen Claude Desktop.

If it still fails, run `which uvx` (Mac) or `where.exe uvx` (Windows), and put that full path in the config as `"command"` instead of `"uvx"`.

**Claude does not show Exclugo tools**

Save the config, fully quit Claude, and reopen it. Check the JSON at [jsonlint.com](https://jsonlint.com).

**”This token isn't valid”**

Go to **Users** in [Exclugo](https://app.exclugo.com/users), edit the user, and copy a fresh token from the Claude Token section. Paste it in the config and restart Claude.

**“You don't have permission”**

Your login does not have that action turned on (for example Process reports, Manage users, Monitoring, or Preferences). Ask your account admin to enable it in Exclugo.

---

## License

MIT
