Skip to content

Align tool schema docs with supported item_get and note_create behavior#11

Merged
CakeRepository merged 7 commits into
masterfrom
copilot/fix-comments-in-review-thread
Jul 4, 2026
Merged

Align tool schema docs with supported item_get and note_create behavior#11
CakeRepository merged 7 commits into
masterfrom
copilot/fix-comments-in-review-thread

Conversation

Copilot AI commented Jul 4, 2026

Copy link
Copy Markdown
Contributor

This tightens the new tool documentation surfaced through MCP so it matches the behavior introduced in the PR. It corrects the secret reference format documented by item_get and clarifies the custom field wording in note_create.

  • Schema/docs alignment

    • Update item_get tool description to document secret references as op://vault/item/field
    • Update item_get.secretReference parameter docs to the same op://vault/item/field format
    • Clarify note_create.fields[].idOrTitle as a single identifier: id or title
  • Regression coverage

    • Add focused tool-schema tests to assert the exposed descriptions for:
      • item_get secret reference format
      • note_create custom field wording
server.tool(
  "item_get",
  "... Accepts a secret reference (op://vault/item/field) or vault ID + item ID.",
  {
    secretReference: z
      .string()
      .optional()
      .describe("Secret reference in op://vault/item/field format."),
  },
);

u2giants and others added 6 commits July 4, 2026 14:43
Retrieve a full 1Password item (title, category, tags, notes, and all
fields with id/title/type/section) via vault+item ID or a secret
reference. Concealed field values are hidden behind a placeholder unless
the caller passes reveal=true, mirroring password_read's conceal pattern.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Edit an existing item after creation: title, notes (empty string clears
notes — the create/edit/delete-notes capability), tags, website URL, and
field upserts/removals. The item is fetched, changes are applied
immutably, and written back via items.put; unreferenced fields are left
untouched and field values are never logged.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
List every item in a vault, returning id, title, category, tags, and
updatedAt for each. Returns metadata only — no secret values are read or
emitted. Also documents item_get/item_edit/item_list in the README tools
table.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Create a Secure Note item (ItemCategory.SecureNote) with a title, note
body, optional tags, and optional custom text/concealed fields. Mirrors
password_create conventions (items.create, errorResult, log/logError) and
never logs field values. Closes #8.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Archive an item via the SDK's items.archive(vaultId, itemId), moving it
to the archive instead of permanently deleting it. Guards with a
capability check (like item_delete) so older SDKs return a clean
errorResult. Closes #9.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Copilot AI changed the title [WIP] Fix code based on feedback in review comments Align tool schema docs with supported item_get and note_create behavior Jul 4, 2026
Copilot AI requested a review from CakeRepository July 4, 2026 14:45
@CakeRepository CakeRepository marked this pull request as ready for review July 4, 2026 14:46
@CakeRepository CakeRepository merged commit 67693ff into master Jul 4, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants