1password-api-patternslisted
Install: claude install-skill WYRE-AI/msp-claude-plugins
# 1Password API Patterns
## Overview
The 1Password connector is a read-only security view of one 1Password Business or
Enterprise account per connection. It wraps two official APIs: the Events API (audit
trail, shared-vault item usage, sign-in attempts) and the Users API (user inventory).
Neither returns secret values, and vault contents are never reachable.
## Credentials and headers
Each client account is one Conduit connection, set up in the Conduit web UI. Conduit sends
the stored values to the MCP server as headers (nothing is configured on the client, and
Conduit drops any `X-OnePassword-*` header a client sends):
| Field | Header | Required |
|---|---|---|
| Region (`us`, `ent`, `ca`, `eu`) | `X-OnePassword-Region` | Always |
| Events Reporting token | `X-OnePassword-Events-Token` | For the Events tools |
| Users API client ID | `X-OnePassword-Client-Id` | For the Users tools |
| Users API client secret | `X-OnePassword-Client-Secret` | For the Users tools |
| Account ID (26 characters) | `X-OnePassword-Account-Id` | For the Users tools |
A connection can carry the Events token, the Users API client, or both. A tool whose half
is missing fails with a credential error; it never falls back to the other half.
## Tools, credentials and Conduit tiers
| Tool | Credential | Conduit tier |
|---|---|---|
| `1password_events_introspect` | Events token | read |
| `1password_audit_events_list` | Events token with `auditevents` | admin |
| `1password_item_usages_list` | Eve