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
- 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.
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.
- 01
sovereign_statusCheck authentication status and agent identity.
- 02
sovereign_loginAuthenticate with a wallet address.
- 03
sovereign_logoutClear locally stored credentials.
- 04
sovereign_export_credentialsExport credentials for another machine.
- 05
sovereign_import_credentialsImport credentials from another machine.
- 06
sovereign_balanceCheck the credit balance.
- 07
sovereign_buy_creditsPurchase credits via Lightning Network.
- 08
sovereign_packagesView available credit packages.
- 09
sovereign_browseBrowse marketplace products.
- 10
sovereign_categoriesList marketplace categories.
- 11
sovereign_productGet details about a specific product.
- 12
sovereign_purchasePurchase a marketplace product.
- 13
sovereign_store_statusCheck local store status.
- 14
sovereign_create_productCreate a product in the local store.
- 15
sovereign_list_productsList local store products.
- 16
sovereign_mark_readyMark a product ready to sync.
- 17
sovereign_syncSync the local store to the marketplace.
- 18
sovereign_my_plotsView owned land plots.
- 19
sovereign_available_plotsBrowse available plots.
- 20
sovereign_security_infoView security information about agent setup.
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
- official product site
Describes local-first marketplace, SDK install, wallet/Lightning concepts, and claims 94 MCP tools.
- npm registry metadata and readme
v0.2.13, publisher mcpsovereign-admin, MIT, two bins, README setup and 16 named tools.
- published package static source
Static, non-executing inspection found 20 registered tools; sovereign_login stores a seven-day JWT locally.
- repository target
Currently returns 404.
- package registry
No evidence summary is recorded for this source.
- secondary
No evidence summary is recorded for this source.
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.

