Metadata-Version: 2.4
Name: latinum-wallet-mcp
Version: 0.0.33
Summary: Latinum Wallet MCP Server
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp
Requires-Dist: google-adk
Requires-Dist: solana
Requires-Dist: solders
Requires-Dist: base58
Requires-Dist: python-dotenv
Requires-Dist: resend
Requires-Dist: supabase
Requires-Dist: keyring
Requires-Dist: deprecated

# 🔐 Latinum Wallet MCP

[https://latinum.ai](https://latinum.ai)   
[Latinum Tutorial](https://latinum.ai/article/latinum-wallet)

A **Model Context Protocol (MCP)** server that enables AI agents (like Claude or Cursor) to pay for services through HTTP 402 requests and MCP tools.

If you have questions or need help, contact us at [dennj@latinum.ai](mailto:dennj@latinum.ai).

## 📦 Installation

Install the package via `pip`:

```bash
pip install latinum-wallet-mcp
hash -r
latinum-wallet-mcp
```

You will get something like:

```
No key found. Generating new wallet...
Requesting airdrop of 10000000 lamports...

Wallet Information
Public Key: A4k42FWKurVAyoNJTLxuQpJehKBk52MhZCHSFrTsqzWP
Balance: 10000000 lamports (0.010000000 SOL)
Recent Transactions:
No recent transactions found.
```

Confirm the installation path:

```bash
which latinum-wallet-mcp
```

## 🖥️ Claude Desktop Integration

To use the Latinum Wallet MCP with **Claude Desktop**, modify the configuration file:

```bash
~/Library/Application Support/Claude/claude_desktop_config.json
```

Add the following configuration:

```json
{
  "mcpServers": {
    "latinum_wallet_mcp": {
      "command": "/Users/YOUR_USERNAME/.local/bin/latinum-wallet-mcp"
    }
  }
}
```

> 🛠 Where the `command:` path should match the output of `which latinum-wallet-mcp`.

✅ Test your setup by following our tutorial: [Latinum Wallet Integration Guide](https://latinum.ai/articles/latinum-wallet)

# 📋 Run from Source

```bash
python3 -m venv .venv && source .venv/bin/activate
pip install --upgrade pip
pip install --upgrade --upgrade-strategy eager -r requirements.txt
python3 -m latinum_wallet_mcp.server_stdio
```

You will get something like:

```
Loaded existing private key from keyring.

Wallet Information
Public Key: FkaedGoNxZ4Kx7x9H9yuUZXKXZ5DbQo5KxRj9BgTsYPE
Balance: 9979801 lamports (0.009979801 SOL)
Recent Transactions:
https://explorer.solana.com/tx/3MHjT3tEuGUj58G3BYbiWqFqGDaYvwfRnCVrtwC8ZPCKkpGmyhXNimnzJRrWLUnSYMaCaxJMrRXx6Czc9nJcEg7J?cluster=devnet
```

To install your local build as a CLI for testing with Claude:
```bash
pip install --editable .
```

# 📑 PyPI Publishing

```bash
python3 -m venv .venv && source .venv/bin/activate
pip install --upgrade pip setuptools wheel
pip install -r requirements.txt
rm -rf dist/ build/ *.egg-info
python3 -m build
python3 -m twine upload dist/*
```

See the output here: https://pypi.org/project/latinum-wallet-mcp/

---

Let us know if you'd like to contribute, suggest improvements, or report issues.

**Join our community:** [Telegram Group](https://t.me/LatinumAgenticCommerce)
