1password-credential-lookuplisted

# 1Password Credential Lookup ## CRITICAL: Use URL, Not Item Names **WRONG:** ```text get_credential(item_name="github.com") ← NEVER DO THIS get_credential(item_name="GitHub") ← NEVER DO THIS ``` **RIGHT:** ```text find_credential(url="github.com") ← CORRECT find_credential(url="github.com", username="clementwalter") ← EVEN BETTER ``` ## The One Rule **When logging into a website, use `find_credential` with the domain.** 1Password items have arbitrary names that don't match URLs. The `find_credential` tool searches by the URL field stored in 1Password, which matches the website you're visiting. ## Tools (in order of preference) ### 1. `find_credential` - PRIMARY TOOL Use this for ALL credential lookups: ```text find_credential(url="github.com") find_credential(url="linkedin.com", username="clement@example.com") ``` **Parameters:** - `url` (required): Domain of website (e.g., "github.com", "twitter.com") - `username` (optional): Filter by username when multiple accounts exist **Returns:** - Single match: `{"username": "...", "password": "...", "item_name": "..."}` - Multiple matches: List of accounts to choose from - No match: Error message ### 2. `list_items_for_url` - When unsure which account ```text list_items_for_url(url="github.com") ``` Shows all accounts for a domain with usernames. Use before `find_credential` if you don't know which account to use. ### 3. `get_credential` - RARELY NEEDED Only use if you have an exa