Update Server

Update metadata and configuration of an existing MCP server

PUT /servers/:name

Update Server

cURL

curl --request PUT \
  --url https://api.example.com/servers/:name \
  --header 'Content-Type: application/json' \
  --data '
{
  "version": "<string>",
  "description": "<string>",
  "license": "<string>",
  "repository": {
    "type": "<string>",
    "url": "<string>"
  },
  "pricing": {
    "currency": "<string>",
    "amount": 123
  },
  "metadata": {
    "homepage": "<string>"
  }
}
'

200 Success

{
  "status": "success",
  "message": "Server 'weather-mcp' updated successfully",
  "server": {
    "name": "weather-mcp",
    "version": "1.3.0",
    "description": "Enhanced weather server with 10-day forecasts and alerts",
    "author": "areeb",
    "lang": "python",
    "license": "MIT",
    "entrypoint": "main.py",
    "repository": {
      "type": "git",
      "url": "https://github.com/areeb/weather-mcp"
    },
    "pricing": {
      "currency": "INR",
      "amount": 0
    }
  }
}

Endpoint

PUT https://api.superbox.ai/api/v1/servers/:name

Authentication

Required

This endpoint requires authentication. You must be the server owner.

Path Parameters

name · string · required

Unique server identifier to update. Example: weather-mcp

Request Body

All fields are optional. Only include fields you want to update.

version · string

New semantic version number. Format: MAJOR.MINOR.PATCH. Must be greater than the current version.

description · string

Updated description. Length: 20-500 characters

license · string

Updated software license. Examples: MIT, Apache-2.0, GPL-3.0

repository · object

Updated repository information

Show properties

type · string

Repository type

url · string

New repository URL (must be public)

Changing the repository URL will trigger a new security scan

pricing · object

Updated pricing configuration

Show properties

currency · string

Currency code (e.g., INR)

amount · number

New price amount

Pricing changes take effect immediately for new users

metadata · object

Optional metadata updates

Show properties

homepage · string

Updated homepage URL

Response

status · string

"success" on success, "error" on failure

message · string

Human-readable confirmation message

server · object

The updated server object (same structure as the Get Server response)

Examples

cURL

# Update version and description
curl -X PUT "https://api.superbox.ai/api/v1/servers/weather-mcp" \
  -H "Authorization: Bearer $SUPERBOX_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "version": "1.3.0",
    "description": "Enhanced weather server with 10-day forecasts"
  }'

# Update pricing
curl -X PUT "https://api.superbox.ai/api/v1/servers/weather-mcp" \
  -H "Authorization: Bearer $SUPERBOX_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "pricing": {
      "currency": "INR",
      "amount": 99
    }
  }'

Response Examples

200 Success

{
  "status": "success",
  "message": "Server 'weather-mcp' updated successfully",
  "server": {
    "name": "weather-mcp",
    "version": "1.3.0",
    "description": "Enhanced weather server with 10-day forecasts and alerts",
    "author": "areeb",
    "lang": "python",
    "license": "MIT",
    "entrypoint": "main.py",
    "repository": {
      "type": "git",
      "url": "https://github.com/areeb/weather-mcp"
    },
    "pricing": {
      "currency": "INR",
      "amount": 0
    }
  }
}

Update Scenarios

Version Bump

When to bump versions:

• Patch (1.0.0 to 1.0.1): Bug fixes, minor changes
• Minor (1.0.0 to 1.1.0): New features, backward compatible
• Major (1.0.0 to 2.0.0): Breaking changes

await fetch(url, {
  method: 'PUT',
  headers,
  body: JSON.stringify({ version: '1.0.1' })
});

Pricing Changes

// Make server free
await fetch(url, {
  method: 'PUT',
  headers,
  body: JSON.stringify({
    pricing: { currency: 'INR', amount: 0 }
  })
});

Existing users keep their current pricing until the next billing cycle

Description Updates

requests.put(url, headers=headers, json={
    'description': 'Now with 10-day forecasts and weather alerts!'
})

Repository Migration

Repository changes trigger a new security scan

await fetch(url, {
  method: 'PUT',
  headers,
  body: JSON.stringify({
    repository: {
      type: 'git',
      url: 'https://github.com/new-org/weather-mcp'
    }
  })
});

Best Practices

Semantic Versioning

Follow semver strictly to communicate changes clearly to users

Document Changes

Update your README and changelog when making updates

Test Before Update

Test changes in your repository before updating the server

Notify Users

For breaking changes, notify users through your communication channels