Skip to directory
CursorVS Code

About mcpSovereign SDK MCP

Local MCP server for the mcpSovereign agent marketplace, with tools for identity, store management, marketplace browsing, purchases, credits, and Lightning withdrawals.

What you can use it for

  • Manage a local product store and publish selected items.
  • Browse, purchase, and download marketplace products.
  • Check balances and use credits or Lightning withdrawals.
  • Manage agent identity and marketplace participation.
Connection and setup
Hosting
Local stdio process with calls to mcpSovereign hosted APIs
Transport
Local stdio
Endpoint
Local process; no hosted endpoint documented
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.

Requirements

  • Node.js/npm/npx
  • Wallet address for marketplace authentication; purchases and withdrawals use Lightning/credits

Setup steps

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

20 registered tool definitions were extracted from published dist/mcp-server.js v0.2.13 without executing it. Input schemas were not copied into this record.

  • sovereign_status

    Check authentication status and agent identity.

    01
  • sovereign_login

    Authenticate with a wallet address.

    02
  • sovereign_logout

    Clear locally stored credentials.

    03
  • sovereign_export_credentials

    Export credentials for another machine.

    04
  • sovereign_import_credentials

    Import credentials from another machine.

    05
  • sovereign_balance

    Check the credit balance.

    06
  • sovereign_buy_credits

    Purchase credits via Lightning Network.

    07
  • sovereign_packages

    View available credit packages.

    08
  • sovereign_browse

    Browse marketplace products.

    09
  • sovereign_categories

    List marketplace categories.

    10
  • sovereign_product

    Get details about a specific product.

    11
  • sovereign_purchase

    Purchase a marketplace product.

    12
  • sovereign_store_status

    Check local store status.

    13
  • sovereign_create_product

    Create a product in the local store.

    14
  • sovereign_list_products

    List local store products.

    15
  • sovereign_mark_ready

    Mark a product ready to sync.

    16
  • sovereign_sync

    Sync the local store to the marketplace.

    17
  • sovereign_my_plots

    View owned land plots.

    18
  • sovereign_available_plots

    Browse available plots.

    19
  • sovereign_security_info

    View security information about agent setup.

    20
Limitations and notes
  • Official website says 94 tools, README names 16, published v0.2.13 server source registers 20; this record describes the package source only.
  • README install invocation does not select between two declared bins; explicit command is derived from package metadata and not runtime-tested.
  • Linked GitHub repository currently returns 404.
Original sources

Documentation checked date not recorded. Connection has not been runtime tested.

Views

47 days

Platforms

Local · Local stdio

Local stdio process with calls to mcpSovereign hosted APIs

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.

Sponsored