Skip to content

mcp: rename package to instanode-mcp (unscoped) to unblock npm publish#2

Merged
mastermanas805 merged 1 commit into
masterfrom
unscoped-package-name
May 12, 2026
Merged

mcp: rename package to instanode-mcp (unscoped) to unblock npm publish#2
mastermanas805 merged 1 commit into
masterfrom
unscoped-package-name

Conversation

@mastermanas805
Copy link
Copy Markdown
Member

Summary

The publish workflow has been 404-ing on every release with
npm error 404 Not Found - PUT https://registry.npmjs.org/@instanode%2fmcp
because the @instanode npm org was never registered. npm rejects PUTs to a non-existent scope regardless of NPM_TOKEN validity.

Two options were on the table:

  • A. Switch to an unscoped name (this PR)
  • B. Keep the scope and have the operator run npm org create instanode (paid org, or claim it via npm support)

Chose A. Unscoped removes the org-setup blocker entirely, and there's no product reason to keep the scope — agents install via npx -y instanode-mcp@latest rather than discovering the package by scope. The MCP registry's name field stays as io.github.InstaNode-dev/mcp (the namespace there is GitHub, not npm) so the registry listing is unaffected.

Changes

  • package.json: name → "instanode-mcp"
  • server.json: npm identifier → "instanode-mcp", version → 0.8.0
  • README.md: every install command + heading updated
  • PUBLISHING.md: heading, npm view command, post-publish verification; added a top-of-file note explaining the rename for posterity
  • smithery.yaml: command args
  • src/index.ts: file header comment
  • test.sh: shell echoes

Test plan

  • npm run build — clean
  • npm test — 6/6 pass (still resolves serverInfo, tools/list, list_resources auth message, validation, claim helper)
  • After merge: next push to master triggers the publish workflow. Operator can run npm view instanode-mcp version to confirm 0.8.0.
  • After publish lands: npx -y instanode-mcp@latest --version resolves from a fresh machine.

Downstream callers (out of scope for this PR)

The following repos still reference @instanode/mcp in their READMEs / launch content and should be migrated when next touched (not blocking this fix):

  • /sdk-python/README.md, /llama-index-instanode/README.md, /langchain-instanode/README.md, /crewai-instanode-tools/README.md
  • /instant-lite-web/ content articles
  • /gtm-ops/ playbooks and changelog
  • /launch-content/ posts
  • Root package.json dependency on @instanode/mcp

🤖 Generated with Claude Code

The publish workflow has been 404-ing on every release because the
@instanode npm org was never registered. npm rejects PUTs to a scope
that doesn't exist with HTTP 404, regardless of NPM_TOKEN validity.

Two options were on the table:
  A. Switch to an unscoped name (this PR)
  B. Keep the scope and have the operator run `npm org create instanode`
     (paid org, or claim it via npm support if available)

Chose A. Unscoped removes the org-setup blocker entirely, and there's no
product reason to keep the scope — agents install via
`npx -y instanode-mcp@latest` rather than discovering the package by
scope. The MCP registry's `name` field stays as
`io.github.InstaNode-dev/mcp` (org namespace there is GitHub, not npm)
so the registry listing is unaffected.

Changes:
  - package.json: name → "instanode-mcp"
  - server.json: npm identifier → "instanode-mcp", version → 0.8.0
  - README.md: every install command + heading
  - PUBLISHING.md: heading, npm view command, post-publish verification;
    added a top-of-file note explaining the rename for posterity
  - smithery.yaml: command args
  - src/index.ts: file header comment
  - test.sh: shell echoes

Test gate:
  npm run build  — clean
  npm test       — 6/6 pass (still resolves serverInfo, tools/list,
                   list_resources auth message, validation, claim helper)

After merge, the next push to master triggers the publish workflow.
Operator verification:
  npm view instanode-mcp version    # should print 0.8.0

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@mastermanas805 mastermanas805 merged commit adc4deb into master May 12, 2026
1 check passed
@mastermanas805 mastermanas805 deleted the unscoped-package-name branch May 12, 2026 05:30
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.

1 participant