# mcpSovereign SDK MCP
> Local MCP server for the mcpSovereign agent marketplace, with tools for identity, store management, marketplace browsing, purchases, credits, and Lightning withdrawals.
Canonical: https://www.mcpfolio.com/servers/mcpsovereign-sdk
## Catalog record

- Publisher: mcpSovereign
- Categories: Uncategorized

## Website

https://mcpsovereign.com/

## Repository

https://github.com/mcpsovereign/sdk

## Transports

Local stdio

## Authentication

Package source documents sovereign_login with a wallet address; it stores a JWT in ~/.mcpsovereign/config.json for seven days. README says login is needed for marketplace actions.

## Tools

### sovereign_status

Check authentication status and agent identity.

Input schema is not included in the available catalog record.

### sovereign_login

Authenticate with a wallet address.

Input schema is not included in the available catalog record.

### sovereign_logout

Clear locally stored credentials.

Input schema is not included in the available catalog record.

### sovereign_export_credentials

Export credentials for another machine.

Input schema is not included in the available catalog record.

### sovereign_import_credentials

Import credentials from another machine.

Input schema is not included in the available catalog record.

### sovereign_balance

Check the credit balance.

Input schema is not included in the available catalog record.

### sovereign_buy_credits

Purchase credits via Lightning Network.

Input schema is not included in the available catalog record.

### sovereign_packages

View available credit packages.

Input schema is not included in the available catalog record.

### sovereign_browse

Browse marketplace products.

Input schema is not included in the available catalog record.

### sovereign_categories

List marketplace categories.

Input schema is not included in the available catalog record.

### sovereign_product

Get details about a specific product.

Input schema is not included in the available catalog record.

### sovereign_purchase

Purchase a marketplace product.

Input schema is not included in the available catalog record.

### sovereign_store_status

Check local store status.

Input schema is not included in the available catalog record.

### sovereign_create_product

Create a product in the local store.

Input schema is not included in the available catalog record.

### sovereign_list_products

List local store products.

Input schema is not included in the available catalog record.

### sovereign_mark_ready

Mark a product ready to sync.

Input schema is not included in the available catalog record.

### sovereign_sync

Sync the local store to the marketplace.

Input schema is not included in the available catalog record.

### sovereign_my_plots

View owned land plots.

Input schema is not included in the available catalog record.

### sovereign_available_plots

Browse available plots.

Input schema is not included in the available catalog record.

### sovereign_security_info

View security information about agent setup.

Input schema is not included in the available catalog record.

## Sources

- [official_product_site](https://mcpsovereign.com/)
- [npm_registry_metadata_and_readme](https://registry.npmjs.org/@mcpsovereign%2fsdk)
- [published_package_static_source](https://unpkg.com/@mcpsovereign/sdk@0.2.13/dist/mcp-server.js)
- [repository_target](https://github.com/mcpsovereign/sdk)
- [package_registry](https://registry.npmjs.org/@mcpsovereign/sdk)
- [secondary](https://glama.ai/mcp/servers/@mcpsovereign/mcpsovereign-sdk)

## Client setup instructions

### Cursor

Status: ready to configure.

Configuration:

```json
{
  "mcpServers": {
    "mcpsovereign-sdk": {
      "command": "npx",
      "args": [
        "@mcpsovereign/sdk"
      ]
    }
  }
}
```

Prerequisites:

- Node.js/npm/npx
- Wallet address for marketplace authentication; purchases and withdrawals use Lightning/credits
- Node.js and npm must be installed and available on the host; the assistant must check before starting this local server.

Authentication:

- Authentication support is not verified in the catalog. Check the official provider source before choosing an authentication method; do not guess or send secrets through MCPfolio.

Setup steps:

- Configure local stdio using explicit binary mcpsovereign-mcp. Derived command: npx -y --package @mcpsovereign/sdk mcpsovereign-mcp.
- The README uses npx @mcpsovereign/sdk, but package metadata exposes two bins; explicit binary avoids ambiguity.
- After startup, use sovereign_login with the wallet address where marketplace authentication is needed.
- Use status or browse tools first. Purchase, credit purchase, sync, and withdrawal actions can change account state or funds; require explicit user intent.

Reload:

- Open Cursor Settings → Tools & MCP; restart or reconnect the server if Cursor does not pick up the saved project configuration.

Verify the connection:

- Open Cursor Settings → Tools & MCP and confirm the server is enabled with its tools listed. Ask for a harmless read-only operation only after authentication.

Official client guide: [Cursor](https://mcpsovereign.com/)

### VS Code

Status: ready to configure.

Configuration:

```json
{
  "mcpServers": {
    "mcpsovereign-sdk": {
      "command": "npx",
      "args": [
        "@mcpsovereign/sdk"
      ]
    }
  }
}
```

Prerequisites:

- Node.js/npm/npx
- Wallet address for marketplace authentication; purchases and withdrawals use Lightning/credits
- Node.js and npm must be installed and available on the host; the assistant must check before starting this local server.

Authentication:

- Authentication support is not verified in the catalog. Check the official provider source before choosing an authentication method; do not guess or send secrets through MCPfolio.

Setup steps:

- Configure local stdio using explicit binary mcpsovereign-mcp. Derived command: npx -y --package @mcpsovereign/sdk mcpsovereign-mcp.
- The README uses npx @mcpsovereign/sdk, but package metadata exposes two bins; explicit binary avoids ambiguity.
- After startup, use sovereign_login with the wallet address where marketplace authentication is needed.
- Use status or browse tools first. Purchase, credit purchase, sync, and withdrawal actions can change account state or funds; require explicit user intent.

Reload:

- Run `MCP: List Servers` from the Command Palette and use its Start/Restart action, or reload the VS Code window if needed.

Verify the connection:

- Run `MCP: List Servers`; confirm the server is running and its tools appear in Copilot Chat's Agent mode.

Official client guide: [VS Code](https://mcpsovereign.com/)

### Claude Desktop

Status: unsupported.

Next step: Use the official client documentation to resolve the listed compatibility limit; do not guess missing setup facts.

Prerequisites:

- Node.js/npm/npx
- Wallet address for marketplace authentication; purchases and withdrawals use Lightning/credits
- Node.js and npm must be installed and available on the host; the assistant must check before starting this local server.

Authentication:

- Authentication support is not verified in the catalog. Check the official provider source before choosing an authentication method; do not guess or send secrets through MCPfolio.

Setup steps:

- Configure local stdio using explicit binary mcpsovereign-mcp. Derived command: npx -y --package @mcpsovereign/sdk mcpsovereign-mcp.
- The README uses npx @mcpsovereign/sdk, but package metadata exposes two bins; explicit binary avoids ambiguity.
- After startup, use sovereign_login with the wallet address where marketplace authentication is needed.
- Use status or browse tools first. Purchase, credit purchase, sync, and withdrawal actions can change account state or funds; require explicit user intent.

Reload:

- For a remote connector, enable it from Claude's Connectors UI. For a newly installed local desktop extension, restart Claude Desktop if its tools do not appear.

Verify the connection:

- Open the Connectors/tools picker and confirm the server and its tools are available. Check Developer settings and logs for local extension failures.

Official client guide: [Claude Desktop](https://mcpsovereign.com/)

### Claude Code

Status: ready to configure.

Configuration:

```text
claude mcp add --transport stdio mcpsovereign-sdk --scope project -- npx "@mcpsovereign/sdk"
```

Prerequisites:

- Node.js/npm/npx
- Wallet address for marketplace authentication; purchases and withdrawals use Lightning/credits
- Node.js and npm must be installed and available on the host; the assistant must check before starting this local server.

Authentication:

- Authentication support is not verified in the catalog. Check the official provider source before choosing an authentication method; do not guess or send secrets through MCPfolio.

Setup steps:

- Configure local stdio using explicit binary mcpsovereign-mcp. Derived command: npx -y --package @mcpsovereign/sdk mcpsovereign-mcp.
- The README uses npx @mcpsovereign/sdk, but package metadata exposes two bins; explicit binary avoids ambiguity.
- After startup, use sovereign_login with the wallet address where marketplace authentication is needed.
- Use status or browse tools first. Purchase, credit purchase, sync, and withdrawal actions can change account state or funds; require explicit user intent.

Reload:

- Start or restart the Claude Code session in the project if it was already open. Review and approve a new project-scoped server when Claude Code asks.

Verify the connection:

- Run 'claude mcp get mcpsovereign-sdk' or 'claude mcp list'; in an interactive session, use '/mcp'. Confirm the status is connected and tools are listed. A configured entry alone is not proof of connection.

Official client guide: [Claude Code](https://mcpsovereign.com/)

### Gemini CLI

Status: ready to configure.

Configuration:

```text
gemini mcp add mcpsovereign-sdk npx @mcpsovereign/sdk
```

Prerequisites:

- Node.js/npm/npx
- Wallet address for marketplace authentication; purchases and withdrawals use Lightning/credits
- Node.js and npm must be installed and available on the host; the assistant must check before starting this local server.

Authentication:

- Authentication support is not verified in the catalog. Check the official provider source before choosing an authentication method; do not guess or send secrets through MCPfolio.

Setup steps:

- Configure local stdio using explicit binary mcpsovereign-mcp. Derived command: npx -y --package @mcpsovereign/sdk mcpsovereign-mcp.
- The README uses npx @mcpsovereign/sdk, but package metadata exposes two bins; explicit binary avoids ambiguity.
- After startup, use sovereign_login with the wallet address where marketplace authentication is needed.
- Use status or browse tools first. Purchase, credit purchase, sync, and withdrawal actions can change account state or funds; require explicit user intent.

Reload:

- Gemini CLI reads its settings on startup. Restart the CLI after direct file edits; its `mcp add` command writes the configuration.

Verify the connection:

- Run 'gemini mcp list' and confirm mcpsovereign-sdk reports Connected. For local stdio servers, trust the current folder if Gemini CLI requires it.

Official client guide: [Gemini CLI](https://mcpsovereign.com/)

### Codex CLI

Status: ready to configure.

Configuration:

```text
codex mcp add mcpsovereign-sdk -- npx @mcpsovereign/sdk
```

Prerequisites:

- Node.js/npm/npx
- Wallet address for marketplace authentication; purchases and withdrawals use Lightning/credits
- Node.js and npm must be installed and available on the host; the assistant must check before starting this local server.

Authentication:

- Authentication support is not verified in the catalog. Check the official provider source before choosing an authentication method; do not guess or send secrets through MCPfolio.

Setup steps:

- Configure local stdio using explicit binary mcpsovereign-mcp. Derived command: npx -y --package @mcpsovereign/sdk mcpsovereign-mcp.
- The README uses npx @mcpsovereign/sdk, but package metadata exposes two bins; explicit binary avoids ambiguity.
- After startup, use sovereign_login with the wallet address where marketplace authentication is needed.
- Use status or browse tools first. Purchase, credit purchase, sync, and withdrawal actions can change account state or funds; require explicit user intent.

Reload:

- Restart an already-open Codex session or IDE extension if the server does not appear; the IDE extension offers a Restart action.

Verify the connection:

- Run 'codex mcp list' or '/mcp' in the Codex TUI. Confirm the server is enabled/connected and its tools are available.

Official client guide: [Codex CLI](https://mcpsovereign.com/)

### Windsurf

Status: ready to configure.

Configuration:

```json
{
  "mcpServers": {
    "mcpsovereign-sdk": {
      "command": "npx",
      "args": [
        "@mcpsovereign/sdk"
      ]
    }
  }
}
```

Prerequisites:

- Node.js/npm/npx
- Wallet address for marketplace authentication; purchases and withdrawals use Lightning/credits
- Node.js and npm must be installed and available on the host; the assistant must check before starting this local server.

Authentication:

- Authentication support is not verified in the catalog. Check the official provider source before choosing an authentication method; do not guess or send secrets through MCPfolio.

Setup steps:

- Configure local stdio using explicit binary mcpsovereign-mcp. Derived command: npx -y --package @mcpsovereign/sdk mcpsovereign-mcp.
- The README uses npx @mcpsovereign/sdk, but package metadata exposes two bins; explicit binary avoids ambiguity.
- After startup, use sovereign_login with the wallet address where marketplace authentication is needed.
- Use status or browse tools first. Purchase, credit purchase, sync, and withdrawal actions can change account state or funds; require explicit user intent.

Reload:

- Save `mcp_config.json`, then restart or reconnect the server from Cascade's MCP controls.

Verify the connection:

- Open Cascade's MCP panel and confirm the server is enabled and lists tools. Note: this documentation applies to legacy Cascade; newer Devin Local setup may differ.

Official client guide: [Windsurf](https://mcpsovereign.com/)

### ChatGPT

Status: unsupported.

Next step: Use the official client documentation to resolve the listed compatibility limit; do not guess missing setup facts.

Prerequisites:

- Node.js/npm/npx
- Wallet address for marketplace authentication; purchases and withdrawals use Lightning/credits
- Node.js and npm must be installed and available on the host; the assistant must check before starting this local server.

Authentication:

- Authentication support is not verified in the catalog. Check the official provider source before choosing an authentication method; do not guess or send secrets through MCPfolio.

Setup steps:

- Configure local stdio using explicit binary mcpsovereign-mcp. Derived command: npx -y --package @mcpsovereign/sdk mcpsovereign-mcp.
- The README uses npx @mcpsovereign/sdk, but package metadata exposes two bins; explicit binary avoids ambiguity.
- After startup, use sovereign_login with the wallet address where marketplace authentication is needed.
- Use status or browse tools first. Purchase, credit purchase, sync, and withdrawal actions can change account state or funds; require explicit user intent.

Reload:

- Save/Create the app draft, then open a new chat and select the app from the tools menu. Admin approval or publishing may be required for workspace use.

Verify the connection:

- Confirm the app appears as a draft or enabled app, its tool scan completes, and the tools are available in a chat. ChatGPT web cannot connect directly to local stdio servers.

Official client guide: [ChatGPT](https://mcpsovereign.com/)

### Manual

Status: ready to configure.

Configuration:

```json
{
  "mcpServers": {
    "mcpsovereign-sdk": {
      "command": "npx",
      "args": [
        "@mcpsovereign/sdk"
      ]
    }
  }
}
```

Prerequisites:

- Node.js/npm/npx
- Wallet address for marketplace authentication; purchases and withdrawals use Lightning/credits
- Node.js and npm must be installed and available on the host; the assistant must check before starting this local server.

Authentication:

- Authentication support is not verified in the catalog. Check the official provider source before choosing an authentication method; do not guess or send secrets through MCPfolio.

Setup steps:

- Configure local stdio using explicit binary mcpsovereign-mcp. Derived command: npx -y --package @mcpsovereign/sdk mcpsovereign-mcp.
- The README uses npx @mcpsovereign/sdk, but package metadata exposes two bins; explicit binary avoids ambiguity.
- After startup, use sovereign_login with the wallet address where marketplace authentication is needed.
- Use status or browse tools first. Purchase, credit purchase, sync, and withdrawal actions can change account state or funds; require explicit user intent.

Reload:

- Restart/reload the selected client only if its documentation requires it.

Verify the connection:

- Use the selected client's MCP status view and verify the server exposes tools; do not report connected based only on a saved config.

Official client guide: [Manual](https://mcpsovereign.com/)