# Avanan MSP (Legacy SmartAPI) (oci · ghcr.io/wyre-ai/avanan-legacy-mcp:v2.3.0)

MCP server for the legacy Avanan SmartAPI: MSP tenant management plus per-tenant security tools.

- Trust score: 44/100 (low)
- Change this week: +6
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-20

## Components

- oci · `ghcr.io/wyre-ai/avanan-legacy-mcp:v2.3.0`: 44/100 (this document), [markdown](https://verifymcp.io/servers/wyre-ai-avanan-legacy-mcp/ghcr-io-wyre-ai-avanan-legacy-mcp-v2-3-0.md), [page](https://verifymcp.io/servers/wyre-ai-avanan-legacy-mcp/ghcr-io-wyre-ai-avanan-legacy-mcp-v2-3-0)

## Channel facts

- Registry: `oci`
- Package: `ghcr.io/wyre-ai/avanan-legacy-mcp:v2.3.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-09-20.

- **Supply Chain Security**: 0/100
  - Malware scan not yet available for this package.
  - Known CVEs could not be checked: this artifact ships no SBOM, so there is no dependency list to read. Publishing one would let us assess it.
  - Install-script risk not yet assessed.
  - Dependency health could not be checked: this artifact ships no SBOM, so there is no dependency list to read. Publishing one would let us assess it.
- **Provenance & Transparency**: 32/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - License check failed: no license is declared.
  - Actively maintained (last published 10 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 85/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Tool/resource definitions use about 3033 tokens (~89/item across 34 items; 33 tools + 1 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 37/100
  - Stability observed for 11 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 97/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 91% of tool parameters carry a description.
- **Tool Safety**: 81/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - 1 of 4 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "avanan_delete_msp_partner" implies "delete" and declares no destructiveHint at all, which the MCP spec reads as destructive by default.
  - An AI judge read all 34 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.
  - Supports UI / widget rendering.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### How do I install the Avanan MSP (Legacy SmartAPI) MCP server?

Avanan MSP (Legacy SmartAPI) runs locally as a container image, launched with docker run --rm -i ghcr.io/wyre-ai/avanan-legacy-mcp:v2.3.0. Ready-made configuration for Claude, Cursor, VS Code, Codex and 3 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add wyre-ai-avanan-legacy-mcp -- docker run --rm -i ghcr.io/wyre-ai/avanan-legacy-mcp:v2.3.0
```

### Cursor

```json
{
  "mcpServers": {
    "wyre-ai-avanan-legacy-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/wyre-ai/avanan-legacy-mcp:v2.3.0"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "wyre-ai-avanan-legacy-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/wyre-ai/avanan-legacy-mcp:v2.3.0"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add wyre-ai-avanan-legacy-mcp -- docker run --rm -i ghcr.io/wyre-ai/avanan-legacy-mcp:v2.3.0
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "wyre-ai-avanan-legacy-mcp": {
      "type": "local",
      "command": [
        "docker",
        "run",
        "--rm",
        "-i",
        "ghcr.io/wyre-ai/avanan-legacy-mcp:v2.3.0"
      ],
      "enabled": true
    }
  }
}
```

### Hermes

```yaml
mcp_servers:
  wyre-ai-avanan-legacy-mcp:
    command: "docker"
    args: ["run", "--rm", "-i", "ghcr.io/wyre-ai/avanan-legacy-mcp:v2.3.0"]
```

### Netclaw

```json
{
  "McpServers": {
    "wyre-ai-avanan-legacy-mcp": {
      "Transport": "stdio",
      "Command": "docker",
      "Arguments": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/wyre-ai/avanan-legacy-mcp:v2.3.0"
      ]
    }
  }
}
```

### Other

```json
{
  "mcpServers": {
    "wyre-ai-avanan-legacy-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/wyre-ai/avanan-legacy-mcp:v2.3.0"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-09-20 (score 44, +1)

No change was recorded against any check on this day. Stability & Change Management went from 33 to 37. That category is still filling its 30-day observation window: 10 days of observed history at the previous scan, 11 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-18 (score 43, +1)

No change was recorded against any check on this day. Stability & Change Management went from 27 to 30. That category is still filling its 30-day observation window: 8 days of observed history at the previous scan, 9 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-17 (score 42, +4)

- [functional improvement] Stability: unverified → 0.27

### 2026-09-09 (score 38)

First indexed and scored.

## MCP tools (33)

### `avanan_test_connection` (~52 tokens)

Verify the configured Avanan credentials: performs the auth handshake, lists the key's scopes, and probes an MSP endpoint to confirm the key is MSP-scoped. Run this first when MSP tools return 403.

### `avanan_list_scopes` (~58 tokens)

List the farm:tenant scopes this key can query. A customer-tenant key has one; an MSP key has one per managed customer, usable as `scopes` / `scope` on the event, search and action tools.

### `avanan_query_events` (~250 tokens)

Query Avanan security events (phishing, malware, DLP, anomaly, shadow IT, malicious URL). Filter by type, state, severity, SaaS, date range, or description text. Returns each event's available remediation actions.

Input parameters:

- `confidenceIndicator` (string): Confidence indicator, e.g. 'malicious'.
- `description` (string): Substring to match in the event description.
- `endDate` (string): End of the time frame (ISO 8601). Defaults to now.
- `eventIds` (array): Fetch these specific event IDs.
- `eventStates` (array): Event states to include.
- `eventTypes` (array): Event types to include.
- `saas` (array): SaaS platforms to include.
- `scopes` (array): MSP keys only: restrict to these farm:tenant scopes (see avanan_list_scopes).
- `scrollId` (string): Pagination scroll ID from a previous response.
- `severities` (array): Severities to include.
- `startDate` (string): Start of the time frame (ISO 8601, e.g. 2026-09-01T00:00:00Z).

### `avanan_get_event` (~36 tokens)

Get full details of one security event by its Avanan event ID.

Input parameters:

- `eventId` (string, required): Avanan event ID.

### `avanan_search_emails` (~199 tokens)

Search secured entities (emails and SaaS objects) by platform and date range, with optional attribute filters (fromEmail, subject, recipients, isQuarantined, attachmentMd5, ...).

Input parameters:

- `endDate` (string): End of the time frame (ISO 8601). Defaults to now.
- `filters` (array): Attribute filters, ANDed together.
- `saas` (string, required): SaaS platform, e.g. office365_emails, google_mail, office365_onedrive, slack, ms_teams.
- `saasEntity` (string): SaaS entity type, e.g. office365_emails_email.
- `scopes` (array): MSP keys only: restrict to these farm:tenant scopes (see avanan_list_scopes).
- `scrollId` (string): Pagination scroll ID from a previous response.
- `startDate` (string, required): Start of the time frame (ISO 8601).

### `avanan_get_email` (~43 tokens)

Get full details of one secured entity (email, file, message) by its Avanan entity ID.

Input parameters:

- `entityId` (string, required): Avanan entity ID.

### `avanan_list_exceptions` (~32 tokens)

List whitelist or blacklist exception entries.

Input parameters:

- `excType` (string, required): Exception list: whitelist or blacklist.

### `avanan_get_exception` (~46 tokens)

Get one whitelist or blacklist entry by its entity ID.

Input parameters:

- `excId` (string, required): Exception entity ID.
- `excType` (string, required): Exception list: whitelist or blacklist.

### `avanan_add_exception` (~292 tokens)

Add a whitelist or blacklist entry. Provide at least one match field (senderEmail, senderDomain, senderName, recipient, subject, attachmentMd5, linkDomains, senderIp).

Input parameters:

- `actionNeeded` (string): Action to apply on match (as accepted by the portal).
- `attachmentMd5` (string): Attachment MD5 hash.
- `comment` (string): Why this exception exists.
- `excType` (string, required): Exception list: whitelist or blacklist.
- `ignoringSpfCheck` (boolean): Ignore SPF check for this exception.
- `linkDomainMatching` (string)
- `linkDomains` (string): Link domain(s) in the email body.
- `matchOnlyFuture` (string): Apply only to future emails.
- `quarantineAll` (string): Quarantine all matches (blacklist).
- `recipient` (string): Recipient email address.
- `recipientMatching` (string)
- `senderClientIp` (string): Sender client IP address.
- `senderDomain` (string): Sender domain.
- `senderDomainMatching` (string)
- `senderEmail` (string): Sender email address.
- `senderEmailMatching` (string)
- `senderIp` (string): Sender IP address.
- `senderName` (string): Sender display name.
- `senderNameMatching` (string)
- `subject` (string): Email subject.
- `subjectMatching` (string)

### `avanan_update_exception` (~278 tokens)

Update an existing whitelist or blacklist entry by its entity ID.

Input parameters:

- `actionNeeded` (string): Action to apply on match (as accepted by the portal).
- `attachmentMd5` (string): Attachment MD5 hash.
- `comment` (string): Why this exception exists.
- `excId` (string, required): Exception entity ID.
- `excType` (string, required): Exception list: whitelist or blacklist.
- `ignoringSpfCheck` (boolean): Ignore SPF check for this exception.
- `linkDomainMatching` (string)
- `linkDomains` (string): Link domain(s) in the email body.
- `matchOnlyFuture` (string): Apply only to future emails.
- `quarantineAll` (string): Quarantine all matches (blacklist).
- `recipient` (string): Recipient email address.
- `recipientMatching` (string)
- `senderClientIp` (string): Sender client IP address.
- `senderDomain` (string): Sender domain.
- `senderDomainMatching` (string)
- `senderEmail` (string): Sender email address.
- `senderEmailMatching` (string)
- `senderIp` (string): Sender IP address.
- `senderName` (string): Sender display name.
- `senderNameMatching` (string)
- `subject` (string): Email subject.
- `subjectMatching` (string)

### `avanan_delete_exception` (~59 tokens)

DESTRUCTIVE and irreversible: delete a whitelist or blacklist entry by its entity ID. Confirm with the user before invoking.

Input parameters:

- `excId` (string, required): Exception entity ID.
- `excType` (string, required): Exception list: whitelist or blacklist.

### `avanan_quarantine_events` (~74 tokens)

HIGH IMPACT: quarantine the emails behind one or more security events. Reversible with avanan_restore_events. Returns task IDs. Confirm with the user before invoking.

Input parameters:

- `eventIds` (array, required): Event IDs.
- `scope` (string): MSP keys only: the farm:tenant scope the IDs belong to.

### `avanan_restore_events` (~56 tokens)

Restore previously quarantined emails behind one or more security events. Returns task IDs.

Input parameters:

- `eventIds` (array, required): Event IDs.
- `scope` (string): MSP keys only: the farm:tenant scope the IDs belong to.

### `avanan_quarantine_emails` (~91 tokens)

HIGH IMPACT: quarantine specific secured entities (emails) by entity ID. Reversible with avanan_restore_emails. Returns task IDs. Confirm with the user before invoking.

Input parameters:

- `entityIds` (array, required): Entity IDs.
- `entityType` (string): Entity type (default: email).
- `scope` (string): MSP keys only: the farm:tenant scope the IDs belong to.

### `avanan_restore_emails` (~71 tokens)

Restore specific quarantined entities (emails) by entity ID. Returns task IDs.

Input parameters:

- `entityIds` (array, required): Entity IDs.
- `entityType` (string): Entity type (default: email).
- `scope` (string): MSP keys only: the farm:tenant scope the IDs belong to.

### `avanan_get_task_status` (~38 tokens)

Check the state of a quarantine/restore task by the task ID an action returned.

Input parameters:

- `taskId` (string, required): Task ID.

### `avanan_list_msp_partners` (~33 tokens)

List all associated child MSP partners under the current MSP. Returns id and name for each child MSP.

### `avanan_create_msp_partner` (~126 tokens)

Create a new child MSP partner under the current MSP (msppartners-extended endpoint, July 2026 guide).

Input parameters:

- `country` (string, required): Country the MSP is located in, spelled as in the guide's country list (e.g. 'United States').
- `name` (string, required): Name of the new MSP partner.
- `state` (string): US state name from the guide's state list. Required only when country is 'United States'.
- `website` (string, required): MSP partner website URL.
- `zip` (string, required): Postal / ZIP code.

### `avanan_delete_msp_partner` (~48 tokens)

Delete a child MSP partner by ID. WARNING: all tenants associated with this MSP are also deleted.

Input parameters:

- `msp_id` (integer, required): ID of the MSP partner to delete.

### `avanan_list_msp_users` (~53 tokens)

List all MSP users.

Input parameters:

- `MSPId` (integer): Parent MSPs only: restrict to the users of this child MSP.
- `scrollId` (string): Pagination scroll ID from a previous response.

### `avanan_get_msp_user` (~31 tokens)

Get a single MSP user by ID.

Input parameters:

- `user_id` (integer, required): MSP user ID.

### `avanan_create_msp_user` (~163 tokens)

Create a new MSP user.

Input parameters:

- `MSPId` (integer): Parent MSPs only: create the user under this child MSP.
- `directLogin` (boolean, required): Allow password login to the MSP portal.
- `email` (string, required): User email address.
- `firstName` (string, required): User first name.
- `lastName` (string, required): User last name.
- `receiveWeeklyReports` (boolean, required): Send weekly reports from customer tenants to this user.
- `role` (string, required): User role.
- `samlLogin` (boolean, required): Allow SAML login to the MSP portal.
- `sendAlerts` (boolean, required): Send customer tenant alerts to this user.
- `viewPrivateData` (boolean, required): Allow the user to view private data on customer portals.

### `avanan_update_msp_user` (~165 tokens)

Update an MSP user by ID. All fields are required per the SmartAPI spec.

Input parameters:

- `directLogin` (boolean, required): Allow password login to the MSP portal.
- `email` (string, required): User email address.
- `firstName` (string, required): User first name.
- `lastName` (string, required): User last name.
- `receiveWeeklyReports` (boolean, required): Send weekly reports from customer tenants to this user.
- `role` (string, required): User role.
- `samlLogin` (boolean, required): Allow SAML login to the MSP portal.
- `sendAlerts` (boolean, required): Send customer tenant alerts to this user.
- `user_id` (integer, required): MSP user ID.
- `viewPrivateData` (boolean, required): Allow the user to view private data on customer portals.

### `avanan_delete_msp_user` (~30 tokens)

Delete an MSP user by ID.

Input parameters:

- `user_id` (integer, required): MSP user ID.

### `avanan_list_tenants` (~77 tokens)

List all customer tenants associated with the current MSP. Each tenant entry includes domain, deployment mode, user counts, status, license package and add-ons.

Input parameters:

- `MSPId` (integer): Parent MSPs only: restrict to the tenants of this child MSP.
- `scrollId` (string): Pagination scroll ID from a previous response.

### `avanan_get_tenant` (~48 tokens)

Get details of a single customer tenant by ID, including license, PoC/paid dates, user count, and expiration.

Input parameters:

- `tenant_id` (integer, required): Avanan tenant ID.

### `avanan_create_tenant` (~131 tokens)

Create a new customer tenant under the current MSP.

Input parameters:

- `MSPId` (integer): Parent MSPs only: create the tenant under this child MSP.
- `adminEmail` (string, required): Tenant administrator email.
- `adminName` (string, required): Tenant administrator's first and last name.
- `companyName` (string, required): Name of the company associated with the tenant.
- `phone` (string, required): Tenant administrator phone number (10 digits).
- `tenantName` (string, required): Tenant name (used in the customer portal domain).
- `tenantRegion` (string, required): Country code for tenant creation region (lowercase).

### `avanan_delete_tenant` (~41 tokens)

Delete a customer tenant by ID. WARNING: this deletes the tenant and all its data.

Input parameters:

- `tenant_id` (integer, required): Avanan tenant ID.

### `avanan_list_licenses` (~37 tokens)

List all available license packages (id, codeName, displayName). Use the codeName when assigning a license to a tenant.

### `avanan_list_addons` (~35 tokens)

List all available license add-ons (id, name). Add-on IDs are used when assigning a license to a tenant.

### `avanan_assign_license` (~113 tokens)

Assign a license (and optional add-ons) to an existing customer tenant.

Input parameters:

- `addonIdList` (array): Optional list of add-on IDs from avanan_list_addons.
- `licenseCodeName` (string, required): Code name of the desired license from avanan_list_licenses (e.g. 'complete_malware').
- `maxLicensedUsers` (integer): Optional maximum number of users for the tenant under this license.
- `tenant_id` (integer, required): Avanan tenant ID to assign the license to.

### `avanan_get_monthly_usage` (~108 tokens)

Get monthly usage details across all customer tenants for a given year/month. Returns per-day, per-tenant rows with user count, daily price, and cost.

Input parameters:

- `month` (integer, required): Month, 1-12.
- `msp_ids` (array): Parent MSPs only: restrict usage to these child MSP IDs.
- `scrollId` (string): Pagination scroll ID from a previous response.
- `year` (integer, required): Year, e.g. 2024.

### `avanan_get_daily_usage` (~100 tokens)

Get daily usage details across all customer tenants for a specific year/month/day.

Input parameters:

- `day` (integer, required): Day of month.
- `month` (integer, required): Month, 1-12.
- `msp_ids` (array): Parent MSPs only: restrict usage to these child MSP IDs.
- `scrollId` (string): Pagination scroll ID from a previous response.
- `year` (integer, required): Year, e.g. 2024.

## Diagnostics

Captured diagnostic sections: Provenance. The full working is on the page: https://verifymcp.io/servers/wyre-ai-avanan-legacy-mcp/ghcr-io-wyre-ai-avanan-legacy-mcp-v2-3-0#diagnostics

## Score history

- 2026-09-20: 44
- 2026-09-19: 43
- 2026-09-18: 43
- 2026-09-17: 42
- 2026-09-16: 38
- 2026-09-15: 38
- 2026-09-14: 38
- 2026-09-13: 38
- 2026-09-12: 38
- 2026-09-11: 38
- 2026-09-10: 38
- 2026-09-09: 38

## Common questions

### What is the Avanan MSP (Legacy SmartAPI) MCP server?

Avanan MSP (Legacy SmartAPI) is an MCP server listed in the public MCP registry as io.github.WYRE-AI/avanan-legacy-mcp. MCP server for the legacy Avanan SmartAPI: MSP tenant management plus per-tenant security tools. This page covers its container image (ghcr.io/wyre-ai/avanan-legacy-mcp:v2.3.0).

### Is the Avanan MSP (Legacy SmartAPI) MCP server safe to use?

Avanan MSP (Legacy SmartAPI) scores 44 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Avanan MSP (Legacy SmartAPI) MCP server expose?

Avanan MSP (Legacy SmartAPI) exposes 33 tools: avanan_test_connection, avanan_list_scopes, avanan_query_events, avanan_get_event, avanan_search_emails, and 28 more. Their descriptions and schemas cost roughly 3,014 tokens of context every time the server is loaded.

### Is the Avanan MSP (Legacy SmartAPI) MCP server still maintained?

Avanan MSP (Legacy SmartAPI) is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Repository: https://github.com/WYRE-AI/avanan-legacy-mcp
- Changelog RSS feed: https://verifymcp.io/servers/wyre-ai-avanan-legacy-mcp/ghcr-io-wyre-ai-avanan-legacy-mcp-v2-3-0.xml
- Changelog JSON feed: https://verifymcp.io/servers/wyre-ai-avanan-legacy-mcp/ghcr-io-wyre-ai-avanan-legacy-mcp-v2-3-0.json
- HTML version of this page: https://verifymcp.io/servers/wyre-ai-avanan-legacy-mcp/ghcr-io-wyre-ai-avanan-legacy-mcp-v2-3-0