Metadata-Version: 2.5
Name: exclugo-client-mcp
Version: 0.1.0
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 for Claude (facility account)

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 an API token from your Exclugo admin

Ask your Exclugo administrator for an **API token**. It looks like a long string of letters and numbers.

They already have a snippet for this in the Exclugo-for-Claude README, under **Generating an API token**.

### 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”**

Ask your Exclugo admin for a new token and paste it in place of the old one. 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.

---

## For Exclugo administrators

Issue a Django REST token for the facility user (same snippet as in the Exclugo-for-Claude README under **Generating an API token**). Send only the token — not a password.

This server is **facility-only**. The user’s existing Exclugo permissions still apply.

To publish a new version:

```bash
cd exclugo-client-mcp
# bump version in pyproject.toml first
rm -rf dist
python -m build
twine upload dist/*
```

---

## License

MIT
