# 🌐 Shothik MCP Server (`@shothik/mcp-server`)

> **Universal Model Context Protocol (MCP) Server** providing enterprise tools for Posthuman blockchain validators, South Asian demography operations (bKash, Steadfast, NBR VAT), episodic semantic memory, and isolated sandbox code execution.

Compatible with **Claude Desktop**, **Cursor IDE**, **Antigravity**, **Goose**, **Cline**, and any MCP client.

---

## ⚡ Quick Start

### 1. Run via `npx` (No Installation Required)

```bash
npx -y @shothik/mcp-server
```

---

## 🔌 Client Integration Configurations

### 🤖 Claude Desktop Configuration

Add the following to your `claude_desktop_config.json`:

* **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
* **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "shothik": {
      "command": "npx",
      "args": ["-y", "@shothik/mcp-server"]
    }
  }
}
```

### 💻 Cursor IDE Configuration

In Cursor Settings ➔ **Features** ➔ **MCP Servers** ➔ **Add New MCP Server**:
* **Name**: `shothik`
* **Type**: `command`
* **Command**: `npx -y @shothik/mcp-server`

---

## 🛠️ Available MCP Tools

| Tool Name | Parameters | Description |
| :--- | :--- | :--- |
| `celestia_status` | `network` | Query Celestia validator bonding state & DA bridge sync status. |
| `monad_metrics` | `nodeEndpoint` | Monitor Monad high-throughput validator execution & TPS. |
| `oraichain_oracle_health`| `contractAddress` | Verify Oraichain AI oracle signing uptime and CosmWasm state. |
| `verify_bkash_trx` | `trxId`, `expectedAmount` | Validate 10-char bKash TrxID format, fees, and settlement status. |
| `book_steadfast_parcel`| `recipientName`, `recipientPhone`, `recipientAddress`, `codAmount` | Instant automated booking with Steadfast Courier Bangladesh. |
| `generate_mushak_6_3` | `buyerName`, `itemDescription`, `itemValueExcludingVat` | Generate statutory Bangladesh NBR Mushak-6.3 VAT tax invoices. |
| `execute_sandbox_code` | `language`, `code` | Safe JS/Python sandboxed execution with timeout and security guards. |
| `semantic_memorize` | `key`, `content`, `category` | Persist episodic facts, user preferences, and architectural decisions. |
| `semantic_recall` | `query` | Retrieve relevant semantic memory snippets. |

---

## 🧪 Development & Testing

```bash
# Clone the repository
git clone https://github.com/ahsanhab919-ux/shothik-mcp.git
cd shothik-mcp

# Install dependencies
pnpm install

# Run unit tests
pnpm test

# Build TypeScript
pnpm build
```

---

## 📜 License
MIT © [Ahsan Habib](https://github.com/ahsanhab919-ux)