# IT Glue MCP Server

A Model Context Protocol (MCP) server for IT Glue API integration. Enables LLMs to interact with IT Glue documentation including organizations, configurations, passwords, contacts, flexible assets, and more.

## Features

- **Organizations**: List, get, create, update organizations
- **Configurations**: Manage IT assets (servers, workstations, network devices)
- **Passwords**: Credential management (with optional password access)
- **Contacts**: Manage people associated with organizations
- **Flexible Assets**: Custom documentation types with dynamic fields
- **Locations**: Physical addresses for organizations
- **Domains**: Domain registration tracking
- **Expirations**: Track warranties, certificates, and renewals

## Installation

```bash
npm install
npm run build
```

## Configuration

### Environment Variables

| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| `ITGLUE_API_KEY` | Yes | - | Your IT Glue API key |
| `ITGLUE_REGION` | No | `us` | API region: `us`, `eu`, or `au` |

### Getting an API Key

1. Log into IT Glue as an Administrator
2. Go to **Account > Settings > API Keys**
3. Click **+ Custom API Key**
4. Give it a name and optionally enable **Password Access**
5. Copy the generated key

**Note**: API keys expire after 90 days of inactivity.

### Password Access

The IT Glue API has a separate permission for password access. If your API key doesn't have this permission:
- You can still list and search passwords
- You can create and update passwords
- You **cannot** retrieve actual password values

Use the `itglue_check_password_access` tool to verify your access level.

## Usage with Claude Desktop

Add to your Claude Desktop configuration (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "itglue": {
      "command": "node",
      "args": ["C:/Users/Dan/GitHub/itglue-mcp-server/dist/index.js"],
      "env": {
        "ITGLUE_API_KEY": "ITG.your-api-key-here"
      }
    }
  }
}
```

## Available Tools

### Organizations
- `itglue_list_organizations` - List organizations with filtering
- `itglue_get_organization` - Get organization by ID
- `itglue_create_organization` - Create new organization
- `itglue_update_organization` - Update existing organization

### Configurations
- `itglue_list_configurations` - List configurations (devices/assets)
- `itglue_get_configuration` - Get configuration by ID
- `itglue_create_configuration` - Create new configuration
- `itglue_update_configuration` - Update existing configuration

### Passwords
- `itglue_list_passwords` - List passwords
- `itglue_get_password` - Get password by ID (includes value if permitted)
- `itglue_create_password` - Create new password entry
- `itglue_update_password` - Update existing password
- `itglue_check_password_access` - Check if API key has password access

### Contacts
- `itglue_list_contacts` - List contacts
- `itglue_get_contact` - Get contact by ID
- `itglue_create_contact` - Create new contact
- `itglue_update_contact` - Update existing contact

### Flexible Assets
- `itglue_list_flexible_assets` - List flexible assets
- `itglue_get_flexible_asset` - Get flexible asset by ID
- `itglue_create_flexible_asset` - Create new flexible asset
- `itglue_update_flexible_asset` - Update existing flexible asset
- `itglue_list_flexible_asset_types` - List all flexible asset types
- `itglue_get_flexible_asset_type` - Get flexible asset type with fields
- `itglue_list_flexible_asset_fields` - List fields for a type

### Locations
- `itglue_list_locations` - List locations
- `itglue_get_location` - Get location by ID
- `itglue_create_location` - Create new location
- `itglue_update_location` - Update existing location

### Domains
- `itglue_list_domains` - List domains
- `itglue_get_domain` - Get domain by ID

### Expirations
- `itglue_list_expirations` - List upcoming expirations

## Response Formats

All tools support two response formats via the `response_format` parameter:

- `markdown` (default) - Human-readable formatted output
- `json` - Structured JSON for programmatic use

## Pagination

List endpoints support pagination:

- `page` - Page number (1-indexed)
- `page_size` - Items per page (max 1000, default 50)

Response includes pagination metadata:
- `total_count` - Total items available
- `has_more` - Whether more pages exist
- `next_page` - Next page number (if available)

## Rate Limits

IT Glue allows 3000 requests per 5-minute window. The server will return a clear error message if you hit the rate limit.

## API Regions

IT Glue has separate API endpoints by region:

| Region | Base URL |
|--------|----------|
| US (default) | `https://api.itglue.com` |
| EU | `https://api.eu.itglue.com` |
| Australia | `https://api.au.itglue.com` |

Set the `ITGLUE_REGION` environment variable to match your account's region.

## Development

```bash
# Install dependencies
npm install

# Build TypeScript
npm run build

# Run in development mode with auto-reload
npm run dev

# Clean build artifacts
npm run clean
```

## License

MIT