chore(release): v0.6.3

GitOrigin-RevId: c0cfd7b2442f4b5b7170c8ced783fc0bf78e0aff

Author: github-actions[bot]

CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## Unreleased
 
+## 0.6.3 - 2026-08-08
+
+- Updated public ID documentation and validation errors to describe the current typed ID format
+  without retired migration-version terminology.
+
 ## 0.6.2 - 2026-08-04
 
 - Redacted MCP startup diagnostics so invalid credentials and environment values are not written

README.md

@@ -83,13 +83,13 @@ installs, set it to your API v1 root, for example `https://rank.example/api/v1`.
 token (`bsb_pat_live_...`). Set optional `BISIBILITY_PROJECT_ID` as the default
 `X-Bisibility-Project` selector for project-implicit PAT tools; a tool's
 optional `project_id` argument overrides it for that call. Every resource ID
-accepted by the MCP server, including `BISIBILITY_PROJECT_ID`, must use public
-ID v3: a canonical lowercase prefix plus `_` and a 24-character lowercase
-CUID2 suffix, for example `prj_a1b2c3d4e5f6g7h8j9k0m2n3`. Raw database IDs,
-legacy IDs, mixed-case IDs, and wrong resource prefixes are rejected. Location
-selection uses the returned `location_key`, never a location ID.
+accepted by the MCP server, including `BISIBILITY_PROJECT_ID`, must use the
+current typed public ID format: a canonical lowercase prefix plus `_` and a
+24-character lowercase suffix, for example `prj_a1b2c3d4e5f6g7h8j9k0m2n3`.
+Malformed IDs, mixed-case IDs, and wrong resource prefixes are rejected.
+Location selection uses the returned `location_key`, never a location ID.
 
-The server consumes the public ID v3 contract from the published
+The server consumes the public ID contract from the published
 `@bisibility/sdk` package. Do not replace it with a local SDK link.
 
 `BISIBILITY_MCP_READ_ONLY` accepts `1`, `true`, `yes`, or `on`, ignoring case. When enabled,

docs/DISTRIBUTION.md

@@ -1,14 +1,14 @@
 # Distribution
 
 This page is the public source of truth for where the bisibility MCP server is available. Statuses
-were last verified on 2026-08-04.
+were last verified on 2026-08-08.
 
 | Channel | Status | Link | Version |
 | --- | --- | --- | --- |
-| npm | Published | [@bisibility/mcp](https://www.npmjs.com/package/@bisibility/mcp) | `0.6.2` |
-| Official MCP Registry | Published | [com.bisibility/mcp](https://registry.modelcontextprotocol.io/v0.1/servers?search=com.bisibility%2Fmcp) | `0.6.2` |
-| GitHub MCP Registry and VS Code | Pending downstream indexing | [GitHub MCP Registry](https://github.com/mcp) | `0.6.2` upstream |
-| Glama server | Listed, schema scan pending | [Open-source server](https://glama.ai/mcp/servers/CorgiCorner/bisibility-mcp) | `0.6.2` |
+| npm | Published | [@bisibility/mcp](https://www.npmjs.com/package/@bisibility/mcp) | `0.6.3` |
+| Official MCP Registry | Published | [com.bisibility/mcp](https://registry.modelcontextprotocol.io/v0.1/servers?search=com.bisibility%2Fmcp) | `0.6.3` |
+| GitHub MCP Registry and VS Code | Pending downstream indexing | [GitHub MCP Registry](https://github.com/mcp) | `0.6.3` upstream |
+| Glama server | Listed, schema scan pending | [Open-source server](https://glama.ai/mcp/servers/CorgiCorner/bisibility-mcp) | `0.6.3` |
 | Glama connector | Listed, unhealthy - rescan required | [Hosted connector](https://glama.ai/mcp/connectors/com.bisibility/mcp) | Hosted |
 | Smithery | Published | [bisibility/mcp](https://smithery.ai/servers/bisibility/mcp) | Hosted |
 | Docker MCP Catalog | Submitted - under review | [docker/mcp-registry#4603](https://github.com/docker/mcp-registry/pull/4603) | `0.6.0` |

mcpb/manifest.json

@@ -3,7 +3,7 @@
   "manifest_version": "0.4",
   "name": "bisibility",
   "display_name": "bisibility",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "description": "Track keyword rankings, research SEO opportunities, and manage bisibility projects with AI agents.",
   "long_description": "Connect a local MCP client to bisibility Cloud or a self-hosted bisibility instance. The bundle exposes the same rank tracking, keyword research, backlink, alert, and project tools as the npm package, with guided configuration for credentials and least-privilege tool selection.",
   "author": {

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@bisibility/mcp",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "mcpName": "com.bisibility/mcp",
   "description": "MCP server for SEO rank tracking - give AI agents access to keyword rankings, SERP history, and rank checks.",
   "type": "module",

package.json

@@ -3,7 +3,7 @@
   "name": "com.bisibility/mcp",
   "title": "bisibility",
   "description": "Track keyword rankings, research SEO opportunities, and manage bisibility projects with AI agents.",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "websiteUrl": "https://bisibility.com/docs/sdks/mcp",
   "repository": {
     "url": "https://github.com/CorgiCorner/bisibility-mcp",
@@ -20,7 +20,7 @@
     {
       "registryType": "npm",
       "identifier": "@bisibility/mcp",
-      "version": "0.6.2",
+      "version": "0.6.3",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"

server.json

@@ -126,7 +126,7 @@ export function readBisibilityMcpConfig(env: BisibilityMcpEnv = process.env): Bi
   if (projectId) {
     const parsedProjectId = projectIdInput.safeParse(projectId);
     if (!parsedProjectId.success) {
-      throw new Error("BISIBILITY_PROJECT_ID must be a prj_ public ID v3.");
+      throw new Error("BISIBILITY_PROJECT_ID must be a prj_ public ID.");
     }
     return { apiKey, baseUrl, projectId: parsedProjectId.data };
   }

src/config.ts

@@ -54,7 +54,7 @@ export function assertPublicId<Prefix extends PublicIdPrefix>(
   prefix: Prefix,
 ): asserts value is PublicIdForPrefix<Prefix> {
   if (!matchesPublicId(value, prefix)) {
-    throw new Error(`Expected a ${prefix}_ public ID v3.`);
+    throw new Error(`Expected a ${prefix}_ public ID.`);
   }
 }
 
@@ -71,7 +71,7 @@ export const publicIdInput = <Prefix extends PublicIdPrefix>(prefix: Prefix) =>
     .string()
     .trim()
     .regex(publicIdPattern(prefix), {
-      message: `Expected a ${prefix}_ public ID v3.`,
+      message: `Expected a ${prefix}_ public ID.`,
     })
     .transform((value) => parsePublicId(value, prefix));
 
@@ -1014,7 +1014,7 @@ function validateAlertTargets(
     if (!matchesPublicId(targetId, expectedPrefix)) {
       ctx.addIssue({
         code: "custom",
-        message: `Expected a ${expectedPrefix}_ public ID v3.`,
+        message: `Expected a ${expectedPrefix}_ public ID.`,
         path: ["target_ids", index],
       });
     }

src/schemas.ts

@@ -25,7 +25,7 @@ function startupFailureReason(error: unknown) {
   if (error.message === "BISIBILITY_BASE_URL cannot be empty.") {
     return "empty_base_url";
   }
-  if (error.message === "BISIBILITY_PROJECT_ID must be a prj_ public ID v3.") {
+  if (error.message === "BISIBILITY_PROJECT_ID must be a prj_ public ID.") {
     return "invalid_project_id";
   }
   if (error.message.startsWith("Unknown BISIBILITY_MCP_TOOLSETS value")) {