Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 14 additions & 5 deletions PUBLISHING.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,12 @@
# Publishing @instanode/mcp
# Publishing instanode-mcp

> **Note (2026-05-12):** the package name moved from the scoped
> `@instanode/mcp` to unscoped `instanode-mcp` because the `@instanode`
> npm org was never registered and the publish workflow was 404-ing on
> every release. The unscoped name removes the org-setup blocker; the
> install commands below reflect the new name. Historical references in
> downstream READMEs / launch posts that still say `@instanode/mcp` should
> be migrated when they're next touched.

End-to-end checklist for pushing a new version out to every registry we
care about. Do steps in order — smithery + the MCP registry both pull
Expand Down Expand Up @@ -34,13 +42,14 @@ npm whoami # should print: instanode
npm publish --access public
```

The `--access public` flag is required for scoped packages (`@instanode/...`)
that start life private by default on npm.
`--access public` is harmless on an unscoped package (the flag was originally
required when the name was scoped `@instanode/mcp`; kept here so the publish
workflow doesn't have to branch on the name).

Verify it landed:

```bash
npm view @instanode/mcp version
npm view instanode-mcp version
```

## 2. MCP Registry (registry.modelcontextprotocol.io)
Expand Down Expand Up @@ -98,7 +107,7 @@ appear at https://cursor.com/mcp within ~24 hours. No separate action.

```bash
# Regular user install path (what a dev finds in Claude Code docs)
npx -y @instanode/mcp@latest --version
npx -y instanode-mcp@latest --version

# Registry URL (should resolve to a listing page)
open https://registry.modelcontextprotocol.io/v0/servers/io.github.instanode-dev/mcp
Expand Down
12 changes: 6 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# @instanode/mcp
# instanode-mcp

MCP server for [instanode.dev](https://instanode.dev). Lets AI coding agents
(Claude Code, Cursor, Windsurf, Continue, etc.) provision the full bundle of
Expand Down Expand Up @@ -27,15 +27,15 @@ get the dashboard claim URL.
### Claude Code

```bash
claude mcp add instanode -- npx -y @instanode/mcp@latest
claude mcp add instanode -- npx -y instanode-mcp@latest
```

To authenticate (unlock paid-tier limits and the account-management tools):

```bash
claude mcp add instanode \
--env INSTANODE_TOKEN=<paste from https://instanode.dev/dashboard> \
-- npx -y @instanode/mcp@latest
-- npx -y instanode-mcp@latest
```

### Cursor
Expand All @@ -47,7 +47,7 @@ Add to `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global):
"mcpServers": {
"instanode": {
"command": "npx",
"args": ["-y", "@instanode/mcp@latest"],
"args": ["-y", "instanode-mcp@latest"],
"env": {
"INSTANODE_TOKEN": "<optional — paste from dashboard for paid tier>"
}
Expand All @@ -65,7 +65,7 @@ Add to `~/.codeium/windsurf/mcp_config.json`:
"mcpServers": {
"instanode": {
"command": "npx",
"args": ["-y", "@instanode/mcp@latest"],
"args": ["-y", "instanode-mcp@latest"],
"env": {
"INSTANODE_TOKEN": "<optional>"
}
Expand All @@ -82,7 +82,7 @@ Add to your `~/.continue/config.yaml`:
mcpServers:
- name: instanode
command: npx
args: ["-y", "@instanode/mcp@latest"]
args: ["-y", "instanode-mcp@latest"]
env:
INSTANODE_TOKEN: "<optional>"
```
Expand Down
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"name": "@instanode/mcp",
"name": "instanode-mcp",
"version": "0.8.0",
"description": "MCP server for instanode.dev \u2014 lets AI coding agents provision ephemeral Postgres, Redis, MongoDB, NATS queues, S3-compatible object storage, and webhook receivers over HTTPS, with optional bearer-token auth for paid users.",
"keywords": [
Expand Down
6 changes: 3 additions & 3 deletions server.json
Original file line number Diff line number Diff line change
Expand Up @@ -6,13 +6,13 @@
"url": "https://github.com/InstaNode-dev/mcp",
"source": "github"
},
"version": "0.7.2",
"version": "0.8.0",
"websiteUrl": "https://instanode.dev",
"packages": [
{
"registryType": "npm",
"identifier": "@instanode/mcp",
"version": "0.7.2",
"identifier": "instanode-mcp",
"version": "0.8.0",
"transport": {
"type": "stdio"
},
Expand Down
2 changes: 1 addition & 1 deletion smithery.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ startCommand:
commandFunction: |-
(config) => ({
command: 'npx',
args: ['-y', '@instanode/mcp@latest'],
args: ['-y', 'instanode-mcp@latest'],
env: {
...(config.instanodeToken ? { INSTANODE_TOKEN: config.instanodeToken } : {}),
...(config.instanodeApiBase ? { INSTANODE_API_BASE: config.instanodeApiBase } : {})
Expand Down
2 changes: 1 addition & 1 deletion src/index.ts
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
#!/usr/bin/env node
/**
* @instanode/mcp — MCP server for instanode.dev
* instanode-mcp — MCP server for instanode.dev
*
* Exposes tools to AI coding agents (Claude Code, Cursor, Windsurf, etc.):
*
Expand Down
4 changes: 2 additions & 2 deletions test.sh
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
#!/usr/bin/env bash
# Integration test for @instanode/mcp
# Integration test for instanode-mcp
# Usage: INSTANODE_API_URL=http://localhost:30080 ./test.sh
set -euo pipefail

Expand All @@ -12,7 +12,7 @@ pass() { echo "PASS: $*"; }
# Build first
npm run build --silent

echo "Testing @instanode/mcp against $BASE_URL"
echo "Testing instanode-mcp against $BASE_URL"
echo ""

# Test 1: initialize
Expand Down
Loading