[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7C46V9DV4MYN9PXAS07Q2RJ":3,"skill-same:01M7C46V9DV4MYN9PXAS07Q2RJ":49},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":30,"commitSha":31,"skillDirectory":32,"forksCount":13,"repositoryHtmlUrl":33,"repositoryHomepageUrl":6,"ownerHtmlUrl":34,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":35,"install":36,"resources":48},"01M7C46V9DV4MYN9PXAS07Q2RJ","using-parcel-mcp",null,"Use when someone says connect Parcel, what Parcel tools do I have, search Parcel for an account or contact, read or update a workspace record, or why did Parcel refuse that, including reconnecting an expired OAuth grant and reporting a scope or plan refusal honestly. Do not use for authoring, revising, or publishing a Parcel skill, use `\u002Fbuilder:create-skill` instead.","nick-parcel\u002Fbuilder","nick-parcel","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F284836222?v=4","01M7C46J950HHMVWFRMNE24ZA4","01M7C46J9S1K39BZJT2Q5RPFDW",0,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fnick-parcel\u002Fbuilder\u002Fblob\u002Fmain\u002Fplugin\u002Fskills\u002Fusing-parcel-mcp\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: using-parcel-mcp\ndescription: Use when someone says connect Parcel, what Parcel tools do I have, search Parcel for an account or contact, read or update a workspace record, or why did Parcel refuse that, including reconnecting an expired OAuth grant and reporting a scope or plan refusal honestly. Do not use for authoring, revising, or publishing a Parcel skill, use `\u002Fbuilder:create-skill` instead.\nlicense: Apache-2.0\ncompatibility: Any MCP client that can connect to a remote HTTP MCP server and complete an OAuth authorization flow\nmetadata:\n  parcel:\n    schema-version: 1\n    version: 0.5.0\n    visibility:\n      claude-plugin: true\n      parcel-explore: false\n      parcel-installable: false\n      parcel-runtime: false\n---\n\n# Using Parcel over MCP\n\n## Overview\n\nParcel serves a remote HTTP MCP server at `https:\u002F\u002Fmcp.parcelengineering.com\u002Fmcp`. Everything you may do there is decided by the OAuth grant the person authorized, by their plan, and by their client's approval prompt. This skill is documentation; reading it changes none of those.\n\nTwo facts drive every decision below:\n\n- The tool list and the scope groups are properties of the live grant, not of this document. Inspect them.\n- The workspace is pinned by the grant. No Parcel tool takes a workspace id, so there is nothing to guess.\n\n## Connect first\n\nIf Parcel tools are missing or every call returns an authorization error, the grant is not connected. Ask the person to complete their client's own flow:\n\n- Claude Code: run `\u002Fmcp`, or `claude mcp login parcel`.\n- Other hosts: use that host's connector or authorization screen.\n\nNever ask for a token, header, cookie, or API key, and never offer to paste one anywhere. The OAuth flow is the only path.\n\n## Workflow\n\n1. Call `tools\u002Flist` and read what the grant actually exposes, including which scope groups it carries. Do not assume a fixed inventory; it changes between releases and between grants.\n2. Call `workspace_get_info` to pin the workspace and read its plan, entitlements, and settings before acting. It costs no credits. Use `workspace_get_credits` when the person asks what a search will leave them.\n3. Call `search_fields` (and `get_fields` for one field) before composing any filter you have not used before. Field discovery costs no credits and returns the real filter keys and enum values, so it replaces guessing.\n4. Call the data tool itself, for example `search_contacts`, with the filter you just verified. Report what came back, then stop and let the person choose the next step.\n\nWork with the identifiers the server gave you in an earlier response. If you do not have an id, search for the record instead of inventing one; a fabricated id is a wrong answer, not a shortcut.\n\n## Global data tools and workspace tools\n\n| Family | What it touches | What it costs |\n| --- | --- | --- |\n| `search_*` and `get_*` over accounts, contacts, projects, signals | Parcel's own datasets | credits per record returned |\n| `search_fields`, `get_fields`, `workspace_get_info`, `workspace_get_credits` | Schema and account context | no credits |\n| `workspace_*` reads and writes | This member's own workspace book, Views, subscriptions, members, invitations | no credits for reads |\n\nGlobal reads spend the workspace's credits, so say what a broad search will cost before you run it and prefer a narrow filter. Workspace writes change the person's own records, so name the record and the field you are about to change before you call the tool. Deleting workspace records and changing membership are not offered to MCP clients at all; when someone asks for one, say it belongs in the Parcel app. Skills and knowledge pages are the exception: `manage_skill` deletes a skill and `manage_knowledge` archives a page, each after the person approves that call.\n\n## Skills and knowledge\n\n- Skills are three tools: `find_skill` (a phrase is a ranked search; filters list skills), `get_skill` (one skill, or one file inside it with `path`), and `manage_skill` (create, update, publish, unpublish, delete, transfer, move, fork, install, or uninstall, chosen by `command`). For authoring a skill, use `\u002Fbuilder:create-skill`.\n- Knowledge is the workspace's own pages about the firm, such as who it targets, positioning, and proof points. `find_knowledge` takes 1 to 4 phrasings, or none for the page tree; `get_knowledge` reads a page, a section, or an attached file; `manage_knowledge` creates a page, edits by `str_replace`, inserts after a heading, replaces, moves, deletes (archives), or restores. Edits need the page's current revision, so read the page before changing it.\n\n## Approvals\n\nThe client's own approval prompt is the only confirmation surface. Parcel cannot draw a confirmation card inside another product. So:\n\n- Ask for a decision in your own words before a write or an expensive search, and let the client's prompt do the rest.\n- If the person declines, stop. Do not re-run the same call with a smaller argument to slip past the prompt.\n- Never describe a tool as pre-approved because it appeared in `tools\u002Flist`.\n\n## When a call is refused\n\nReport the refusal in plain language, say what would fix it, and stop. Do not retry a refused call unchanged, and do not route around it with a different tool.\n\n| What you see | What it means | What to say |\n| --- | --- | --- |\n| Tool missing from `tools\u002Flist` | The grant does not carry that scope group | The grant needs to be reauthorized with the missing scope group selected |\n| `forbidden` on a tool that exists | The scope, role, or principal is not allowed here | Name the scope group and let the person decide |\n| Plan refusal | The workspace is not on the Pro plan | The plan gates the whole MCP surface; upgrading is the person's call |\n| 401 or `unauthorized` mid-session | The grant expired or was revoked | Reconnect through the host, then retry once |\n| Skill tools absent on an older grant | The grant predates skill scopes | Reconnect so `skills:read` and `skills:write` are included |\n| Knowledge tools absent | The grant does not carry the knowledge scopes | Reconnect so `knowledge:read` and `knowledge:write` are included |\n\nSay \"this grant cannot do that\" and stop. Guessing an id, retrying in a loop, or telling the person a refusal is a bug is worse than the refusal.\n\n## Red flags\n\n- Writing a workspace id into any argument.\n- Composing a filter from a field name you have not seen in `search_fields`.\n- Listing Parcel's tools, prices, or plan limits from memory instead of from the live response.\n- Running a broad global search \"to see what happens\" while credits are metered.\n- Explaining away a refusal instead of reporting it.\n","# Using Parcel over MCP\n\n## Overview\n\nParcel serves a remote HTTP MCP server at `https:\u002F\u002Fmcp.parcelengineering.com\u002Fmcp`. Everything you may do there is decided by the OAuth grant the person authorized, by their plan, and by their client's approval prompt. This skill is documentation; reading it changes none of those.\n\nTwo facts drive every decision below:\n\n- The tool list and the scope groups are properties of the live grant, not of this document. Inspect them.\n- The workspace is pinned by the grant. No Parcel tool takes a workspace id, so there is nothing to guess.\n\n## Connect first\n\nIf Parcel tools are missing or every call returns an authorization error, the grant is not connected. Ask the person to complete their client's own flow:\n\n- Claude Code: run `\u002Fmcp`, or `claude mcp login parcel`.\n- Other hosts: use that host's connector or authorization screen.\n\nNever ask for a token, header, cookie, or API key, and never offer to paste one anywhere. The OAuth flow is the only path.\n\n## Workflow\n\n1. Call `tools\u002Flist` and read what the grant actually exposes, including which scope groups it carries. Do not assume a fixed inventory; it changes between releases and between grants.\n2. Call `workspace_get_info` to pin the workspace and read its plan, entitlements, and settings before acting. It costs no credits. Use `workspace_get_credits` when the person asks what a search will leave them.\n3. Call `search_fields` (and `get_fields` for one field) before composing any filter you have not used before. Field discovery costs no credits and returns the real filter keys and enum values, so it replaces guessing.\n4. Call the data tool itself, for example `search_contacts`, with the filter you just verified. Report what came back, then stop and let the person choose the next step.\n\nWork with the identifiers the server gave you in an earlier response. If you do not have an id, search for the record instead of inventing one; a fabricated id is a wrong answer, not a shortcut.\n\n## Global data tools and workspace tools\n\n| Family | What it touches | What it costs |\n| --- | --- | --- |\n| `search_*` and `get_*` over accounts, contacts, projects, signals | Parcel's own datasets | credits per record returned |\n| `search_fields`, `get_fields`, `workspace_get_info`, `workspace_get_credits` | Schema and account context | no credits |\n| `workspace_*` reads and writes | This member's own workspace book, Views, subscriptions, members, invitations | no credits for reads |\n\nGlobal reads spend the workspace's credits, so say what a broad search will cost before you run it and prefer a narrow filter. Workspace writes change the person's own records, so name the record and the field you are about to change before you call the tool. Deleting workspace records and changing membership are not offered to MCP clients at all; when someone asks for one, say it belongs in the Parcel app. Skills and knowledge pages are the exception: `manage_skill` deletes a skill and `manage_knowledge` archives a page, each after the person approves that call.\n\n## Skills and knowledge\n\n- Skills are three tools: `find_skill` (a phrase is a ranked search; filters list skills), `get_skill` (one skill, or one file inside it with `path`), and `manage_skill` (create, update, publish, unpublish, delete, transfer, move, fork, install, or uninstall, chosen by `command`). For authoring a skill, use `\u002Fbuilder:create-skill`.\n- Knowledge is the workspace's own pages about the firm, such as who it targets, positioning, and proof points. `find_knowledge` takes 1 to 4 phrasings, or none for the page tree; `get_knowledge` reads a page, a section, or an attached file; `manage_knowledge` creates a page, edits by `str_replace`, inserts after a heading, replaces, moves, deletes (archives), or restores. Edits need the page's current revision, so read the page before changing it.\n\n## Approvals\n\nThe client's own approval prompt is the only confirmation surface. Parcel cannot draw a confirmation card inside another product. So:\n\n- Ask for a decision in your own words before a write or an expensive search, and let the client's prompt do the rest.\n- If the person declines, stop. Do not re-run the same call with a smaller argument to slip past the prompt.\n- Never describe a tool as pre-approved because it appeared in `tools\u002Flist`.\n\n## When a call is refused\n\nReport the refusal in plain language, say what would fix it, and stop. Do not retry a refused call unchanged, and do not route around it with a different tool.\n\n| What you see | What it means | What to say |\n| --- | --- | --- |\n| Tool missing from `tools\u002Flist` | The grant does not carry that scope group | The grant needs to be reauthorized with the missing scope group selected |\n| `forbidden` on a tool that exists | The scope, role, or principal is not allowed here | Name the scope group and let the person decide |\n| Plan refusal | The workspace is not on the Pro plan | The plan gates the whole MCP surface; upgrading is the person's call |\n| 401 or `unauthorized` mid-session | The grant expired or was revoked | Reconnect through the host, then retry once |\n| Skill tools absent on an older grant | The grant predates skill scopes | Reconnect so `skills:read` and `skills:write` are included |\n| Knowledge tools absent | The grant does not carry the knowledge scopes | Reconnect so `knowledge:read` and `knowledge:write` are included |\n\nSay \"this grant cannot do that\" and stop. Guessing an id, retrying in a loop, or telling the person a refusal is a bug is worse than the refusal.\n\n## Red flags\n\n- Writing a workspace id into any argument.\n- Composing a filter from a field name you have not seen in `search_fields`.\n- Listing Parcel's tools, prices, or plan limits from memory instead of from the live response.\n- Running a broad global search \"to see what happens\" while credits are metered.\n- Explaining away a refusal instead of reporting it.\n",{"name":5,"license":14,"metadata":23,"description":7,"compatibility":29},{"parcel":24},{"version":25,"visibility":26,"schema-version":28},"0.5.0",{"claude-plugin":27,"parcel-explore":19,"parcel-runtime":19,"parcel-installable":19},true,1,"Any MCP client that can connect to a remote HTTP MCP server and complete an OAuth authorization flow","main","240f3489f15b248779faecf7404d70c65cab9ef3","plugin\u002Fskills\u002Fusing-parcel-mcp","https:\u002F\u002Fgithub.com\u002Fnick-parcel\u002Fbuilder","https:\u002F\u002Fgithub.com\u002Fnick-parcel","2026-11-07 11:02:58",{"source":8,"skillName":5,"commands":37,"prompt":47,"zipAvailable":27},[38,41,44],{"tool":39,"command":40},"npx","npx skills add nick-parcel\u002Fbuilder --skill using-parcel-mcp",{"tool":42,"command":43},"bunx","bunx skills add nick-parcel\u002Fbuilder --skill using-parcel-mcp",{"tool":45,"command":46},"pnpm","pnpm dlx skills add nick-parcel\u002Fbuilder --skill using-parcel-mcp","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fnick-parcel\u002Fbuilder\u002Fblob\u002Fmain\u002Fplugin\u002Fskills\u002Fusing-parcel-mcp\u002FSKILL.md",[],[50,57,63,69,75,81],{"skillNo":51,"name":52,"nameZh":6,"description":53,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":54,"categories":55,"keywords":56,"publishedAt":18},"01M7C48CBG8D6HFKWJYEWG8MKC","yaml-alias","Use when exercising the portable format validator in tests.","https:\u002F\u002Fgithub.com\u002Fnick-parcel\u002Fbuilder\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Finvalid\u002Fskills\u002Fyaml-alias\u002FSKILL.md",[],[],{"skillNo":58,"name":59,"nameZh":6,"description":53,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":18},"01M7C4898RFM2W7FYRDJWVJ2XE","wrong-visibility-flag","https:\u002F\u002Fgithub.com\u002Fnick-parcel\u002Fbuilder\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Finvalid\u002Fskills\u002Fwrong-visibility-flag\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":53,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":18},"01M7C485YHNT1FPPEWG9WS8KV6","top-level-version","https:\u002F\u002Fgithub.com\u002Fnick-parcel\u002Fbuilder\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Finvalid\u002Fskills\u002Ftop-level-version\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":53,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":18},"01M7C482T0WGVWGBQ2D628JEK5","shebang-line","https:\u002F\u002Fgithub.com\u002Fnick-parcel\u002Fbuilder\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Finvalid\u002Fskills\u002Fshebang-line\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":53,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":18},"01M7C4808K4XNCR9FMZ8QPTS7M","permission-claim","https:\u002F\u002Fgithub.com\u002Fnick-parcel\u002Fbuilder\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Finvalid\u002Fskills\u002Fpermission-claim\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":53,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":18},"01M7C47YKQKWZWN746F56Y69JA","non-semver-version","https:\u002F\u002Fgithub.com\u002Fnick-parcel\u002Fbuilder\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Finvalid\u002Fskills\u002Fnon-semver-version\u002FSKILL.md",[],[]]