@sardis/mcp-server 0.2.6 → 1.0.0

package/CHANGELOG.md

@@ -5,6 +5,15 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.7] - 2026-02-13
+
+### Changed
+
+- Synchronized package/server/catalog version metadata to `0.2.7`
+- Updated embedded MCP tool catalog to match current registered tool set
+- Refreshed CLI/help copy to reflect current tool coverage and canonical docs/GitHub URLs
+- Updated tool category mapping to include newer wallet, sandbox, approval, spending, and group tools
+
 ## [0.1.0] - 2025-01-27
 
 ### Added
@@ -66,4 +75,5 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Risk scoring for each payment request
 - Human-in-the-loop approval workflows
 
-[0.1.0]: https://github.com/sardis-network/sardis/releases/tag/mcp-server-v0.1.0
+[0.2.7]: https://github.com/EfeDurmaz16/sardis/releases/tag/mcp-server-v0.2.7
+[0.1.0]: https://github.com/EfeDurmaz16/sardis/releases/tag/mcp-server-v0.1.0

package/CLAUDE_DESKTOP_CONFIG.md

@@ -151,30 +151,21 @@ After configuration, restart Claude Desktop. You should see Sardis tools availab
 2. Check your wallet ID exists
 3. Ensure sufficient balance for operations
 
-## Available Tools (36)
+## Available Tools (50+)
 
-After configuration, Claude will have access to:
+After configuration, Claude gets access to wallet, payment, policy, hold,
+card, fiat, approval, analytics, group-governance, and sandbox tools.
 
-**Wallet**: sardis_get_wallet, sardis_get_balance, sardis_create_wallet, sardis_update_wallet_policy, sardis_list_wallets
+To inspect the exact current tool catalog in your environment, run:
 
-**Payment**: sardis_pay, sardis_get_transaction, sardis_list_transactions
-
-**Policy**: sardis_check_policy, sardis_validate_limits, sardis_check_compliance
-
-**Hold**: sardis_create_hold, sardis_capture_hold, sardis_void_hold, sardis_get_hold, sardis_list_holds, sardis_extend_hold
-
-**Agent**: sardis_create_agent, sardis_get_agent, sardis_list_agents, sardis_update_agent
-
-**Card**: sardis_issue_card, sardis_get_card, sardis_list_cards, sardis_freeze_card, sardis_unfreeze_card, sardis_cancel_card
-
-**Fiat**: sardis_fund_wallet, sardis_withdraw_to_bank, sardis_get_funding_status, sardis_get_withdrawal_status
-
-**Approval**: sardis_request_approval, sardis_get_approval_status
+```bash
+npx @sardis/mcp-server start
+```
 
-**Analytics**: sardis_get_spending_summary, sardis_get_spending_by_vendor, sardis_get_spending_by_category
+Then query the `sardis://tools` MCP resource from your client.
 
 ## Support
 
-- Documentation: https://docs.sardis.sh
-- GitHub Issues: https://github.com/sardis-network/sardis/issues
+- Documentation: https://sardis.sh/docs
+- GitHub Issues: https://github.com/EfeDurmaz16/sardis/issues
 - Email: support@sardis.sh

package/README.md

@@ -4,340 +4,303 @@
 [![npm downloads](https://img.shields.io/npm/dm/@sardis/mcp-server.svg)](https://www.npmjs.com/package/@sardis/mcp-server)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-> Model Context Protocol (MCP) server for Sardis - Enable AI agents to execute secure payments with Financial Hallucination Prevention
+**Payment tools for AI agents — works with Claude, ChatGPT, Cursor, VS Code, and any MCP-compatible client.**
 
-## Table of Contents
+Enable AI agents to execute secure payments, manage wallets, and enforce spending policies through the Model Context Protocol. Non-custodial, policy-enforced, and audit-ready.
 
-- [Quick Start](#quick-start)
-- [What is this?](#what-is-this)
-- [Installation](#installation)
-- [Available Tools](#available-tools-36-total)
-- [Policy Engine](#policy-engine)
-- [Example Session](#example-session)
-- [Environment Variables](#environment-variables)
-- [Simulated Mode](#simulated-mode)
-- [API Reference](#api-reference)
-- [License](#license)
+---
 
-## Quick Start
-
-```bash
-npx @sardis/mcp-server start
-```
-
-## What is this?
-
-Sardis MCP Server allows AI agents (Claude, Cursor, etc.) to execute payments through your Sardis wallet using the Model Context Protocol. It provides **Financial Hallucination Prevention** through natural language spending policies.
-
-## Installation
-
-### Option 1: npx (Recommended)
-
-No installation required - run directly:
-
-```bash
-npx @sardis/mcp-server start
-```
-
-### Option 2: Global Install
-
-```bash
-npm install -g @sardis/mcp-server
-sardis-mcp start
-```
-
-### Option 3: Local Install
-
-```bash
-npm install @sardis/mcp-server
-npx sardis-mcp start
-```
-
-## Configuration
+## Quick Start (30 seconds)
 
 ### Claude Desktop
 
-Add to your Claude Desktop configuration file:
-
 **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
 **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
 **Linux**: `~/.config/Claude/claude_desktop_config.json`
 
-#### Minimal Configuration (Simulated Mode)
-
 ```json
 {
   "mcpServers": {
     "sardis": {
       "command": "npx",
-      "args": ["@sardis/mcp-server", "start"]
+      "args": ["-y", "@sardis/mcp-server"],
+      "env": {
+        "SARDIS_API_KEY": "sk_live_your_api_key_here"
+      }
     }
   }
 }
 ```
 
-#### Production Configuration
+### Cursor
+
+`.cursor/mcp.json`:
 
 ```json
 {
   "mcpServers": {
     "sardis": {
       "command": "npx",
-      "args": ["@sardis/mcp-server", "start"],
+      "args": ["-y", "@sardis/mcp-server"],
       "env": {
-        "SARDIS_API_KEY": "sk_live_your_api_key_here",
-        "SARDIS_WALLET_ID": "wal_your_wallet_id",
-        "SARDIS_MODE": "live"
+        "SARDIS_API_KEY": "sk_live_your_api_key_here"
       }
     }
   }
 }
 ```
 
-### Cursor
+### Windsurf
 
-Add to your Cursor MCP settings (`.cursor/mcp.json` or Cursor settings):
-
-#### Minimal Configuration
+`.windsurf/mcp.json`:
 
 ```json
 {
   "mcpServers": {
     "sardis": {
       "command": "npx",
-      "args": ["@sardis/mcp-server", "start"]
+      "args": ["-y", "@sardis/mcp-server"],
+      "env": {
+        "SARDIS_API_KEY": "sk_live_your_api_key_here"
+      }
     }
   }
 }
 ```
 
-#### Production Configuration
+### VS Code
+
+Install the [MCP Extension](https://marketplace.visualstudio.com/items?itemName=modelcontextprotocol.mcp) and add to settings:
 
 ```json
 {
-  "mcpServers": {
+  "mcp.servers": {
     "sardis": {
       "command": "npx",
-      "args": ["@sardis/mcp-server", "start"],
+      "args": ["-y", "@sardis/mcp-server"],
       "env": {
-        "SARDIS_API_KEY": "sk_live_your_api_key_here",
-        "SARDIS_WALLET_ID": "wal_your_wallet_id",
-        "SARDIS_MODE": "live"
+        "SARDIS_API_KEY": "sk_live_your_api_key_here"
       }
     }
   }
 }
 ```
 
-### Other MCP Clients
+### Claude Code
 
-For any MCP-compatible client, use:
+```bash
+claude mcp add sardis -- npx -y @sardis/mcp-server
+```
+
+Then set your API key:
+
+```bash
+export SARDIS_API_KEY=sk_live_your_api_key_here
+```
 
-- **Command**: `npx`
-- **Arguments**: `["@sardis/mcp-server", "start"]`
-- **Transport**: `stdio`
+### ChatGPT
 
-## Available Tools (36 total)
+1. Open ChatGPT Settings
+2. Navigate to **MCP Servers**
+3. Click **Add Custom**
+4. Enter:
+   - **Name**: `sardis`
+   - **Command**: `npx -y @sardis/mcp-server`
+   - **Environment Variable**: `SARDIS_API_KEY=sk_live_your_api_key_here`
 
-### Wallet Tools (5)
+---
+
+## Available Tools
+
+### Payments
 
 | Tool | Description |
 |------|-------------|
-| `sardis_get_wallet` | Get wallet details and configuration |
-| `sardis_get_balance` | Get current wallet balance and spending limits |
-| `sardis_create_wallet` | Create a new MPC wallet with optional spending policy |
-| `sardis_update_wallet_policy` | Update the spending policy for a wallet |
-| `sardis_list_wallets` | List all wallets, optionally filtered by agent or status |
+| `sardis_pay` | Execute a payment to a merchant or wallet address |
+| `sardis_get_transaction` | Retrieve details of a specific transaction |
+| `sardis_list_transactions` | List recent transactions with filters |
 
-### Payment Tools (3)
+### Wallets
 
 | Tool | Description |
 |------|-------------|
-| `sardis_pay` | Execute a secure payment with policy validation |
-| `sardis_get_transaction` | Get transaction status and details |
-| `sardis_list_transactions` | List recent transactions for a wallet |
+| `sardis_create_wallet` | Create a new non-custodial MPC wallet |
+| `sardis_get_balance` | Get wallet balance across chains and tokens |
+| `sardis_fund_wallet` | Fund wallet via on-ramp or transfer |
 
-### Policy Tools (3)
+### Cards
 
 | Tool | Description |
 |------|-------------|
-| `sardis_check_policy` | Check if a payment would be allowed before executing |
-| `sardis_validate_limits` | Validate spending against daily/monthly limits |
-| `sardis_check_compliance` | Check vendor against compliance rules |
+| `sardis_issue_card` | Issue a virtual card for an agent |
+| `sardis_create_card` | Create a virtual card with spending limits |
+| `sardis_freeze_card` | Temporarily freeze a card |
+| `sardis_cancel_card` | Permanently cancel a card |
 
-### Hold Tools (6)
+### Policy
 
 | Tool | Description |
 |------|-------------|
-| `sardis_create_hold` | Create a pre-authorization hold on funds |
-| `sardis_capture_hold` | Capture a previously created hold |
-| `sardis_void_hold` | Void/cancel a hold without capturing |
-| `sardis_get_hold` | Get hold status and details |
-| `sardis_list_holds` | List active holds for a wallet |
-| `sardis_extend_hold` | Extend the expiration of a hold |
+| `sardis_check_policy` | Validate a transaction against spending policies |
+| `sardis_validate_limits` | Check if transaction is within limits |
+| `sardis_get_policies` | List all active spending policies |
 
-### Agent Tools (4)
+### Holds
 
 | Tool | Description |
 |------|-------------|
-| `sardis_create_agent` | Create a new AI agent with identity |
-| `sardis_get_agent` | Get agent details and capabilities |
-| `sardis_list_agents` | List all agents in the organization |
-| `sardis_update_agent` | Update agent configuration |
+| `sardis_create_hold` | Create a payment hold (authorize without capture) |
+| `sardis_capture_hold` | Capture a previously authorized hold |
+| `sardis_release_hold` | Release a hold without capturing |
+| `sardis_void_hold` | Void an authorization |
 
-### Card Tools (6)
+### Approvals
 
 | Tool | Description |
 |------|-------------|
-| `sardis_issue_card` | Issue a virtual card linked to a wallet |
-| `sardis_get_card` | Get virtual card details (masked) |
-| `sardis_list_cards` | List all virtual cards for a wallet |
-| `sardis_freeze_card` | Temporarily freeze a virtual card |
-| `sardis_unfreeze_card` | Unfreeze a previously frozen card |
-| `sardis_cancel_card` | Permanently cancel a virtual card |
+| `sardis_request_approval` | Request human approval for a transaction |
+| `sardis_check_approval` | Check status of a pending approval request |
+| `sardis_list_pending_approvals` | List all pending approval requests |
 
-### Fiat Tools (4)
+### Analytics
 
 | Tool | Description |
 |------|-------------|
-| `sardis_fund_wallet` | Fund a wallet from bank account, wire, or card |
-| `sardis_withdraw_to_bank` | Withdraw funds to a bank account |
-| `sardis_get_funding_status` | Check status of a funding transfer |
-| `sardis_get_withdrawal_status` | Check status of a withdrawal |
+| `sardis_get_spending_summary` | Get spending summary for a time period |
+| `sardis_get_spending_trends` | Analyze spending trends and patterns |
 
-### Approval Tools (2)
+### Groups
 
 | Tool | Description |
 |------|-------------|
-| `sardis_request_approval` | Request human approval for payments exceeding limits |
-| `sardis_get_approval_status` | Check status of a pending approval request |
+| `sardis_create_group` | Create an agent group with shared budget |
+| `sardis_add_agent_to_group` | Add an agent to a spending group |
+| `sardis_get_group_spending` | Get spending summary for a group |
 
-### Spending Analytics Tools (3)
+### Fiat
 
 | Tool | Description |
 |------|-------------|
-| `sardis_get_spending_summary` | Get spending summary with totals and limits |
-| `sardis_get_spending_by_vendor` | Get spending breakdown by vendor |
-| `sardis_get_spending_by_category` | Get spending breakdown by category |
+| `sardis_onramp` | Convert fiat to crypto via on-ramp |
+| `sardis_offramp` | Convert crypto to fiat via off-ramp |
+| `sardis_fiat_balance` | Check fiat balance in connected accounts |
+
+### Sandbox
 
-## Policy Engine
+| Tool | Description |
+|------|-------------|
+| `sardis_sandbox_*` | Sandbox tools for testing (no API key needed) |
 
-The server validates all payments against your configured spending policy:
+---
 
-- **Allowed Categories**: SaaS, DevTools, Cloud, API
-- **Blocked Merchants**: Configurable blocklist
-- **Transaction Limits**: Max per transaction and daily limits
-- **Risk Scoring**: Each request gets a risk score
-- **Approval Workflows**: Human-in-the-loop for high-value transactions
+## Demo Mode
 
-## Example Session
+Try Sardis without an API key using sandbox tools:
 
+```bash
+npx @sardis/mcp-server --demo
 ```
-Agent: I need to pay $20 for OpenAI API credits
 
-[sardis_pay] vendor="OpenAI", amount=20, purpose="API Credits"
+Sandbox tools include simulated payments, wallet creation, and policy validation. Perfect for testing integrations before going live.
 
-Result: {
-  "success": true,
-  "status": "APPROVED",
-  "card": {
-    "number": "4242 **** **** 9999",
-    "cvv": "847",
-    "expiry": "12/26"
-  }
-}
+---
 
-Agent: Can I buy a $500 Amazon gift card?
+## What Can You Do?
 
-[sardis_pay] vendor="Amazon", amount=500
+Example prompts to try with your AI agent:
 
-Result: {
-  "success": false,
-  "status": "BLOCKED",
-  "error": "POLICY_VIOLATION",
-  "message": "Merchant \"Amazon\" is not in the approved vendor list",
-  "prevention": "Financial Hallucination PREVENTED"
-}
+**Wallet Management**
+- "Check my agent's wallet balance"
+- "Create a new wallet for my procurement agent"
+- "What's my USDC balance on Base?"
 
-Agent: What's my spending this month?
+**Payments**
+- "Pay $50 USDC to merchant@example.com on Base"
+- "Send 100 USDC to 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
+- "Show me my last 10 transactions"
 
-[sardis_get_spending_summary] period="month"
+**Policy Enforcement**
+- "Create a spending policy: max $500/day for API services"
+- "Can I spend $1000 on AWS right now?"
+- "What are my current spending limits?"
 
-Result: {
-  "total_spent": "450.00",
-  "transaction_count": 12,
-  "remaining_daily_limit": "50.00",
-  "remaining_monthly_limit": "550.00",
-  "top_vendor": "OpenAI"
-}
-```
+**Virtual Cards**
+- "Issue a virtual card for my procurement agent"
+- "Create a card with a $200 monthly limit for SaaS subscriptions"
+- "Freeze card ending in 1234"
 
-## Environment Variables
+**Analytics**
+- "Show spending summary for the last 30 days"
+- "What are my top 5 vendors this month?"
+- "Analyze spending trends for Q1"
 
-| Variable | Required | Default | Description |
-|----------|----------|---------|-------------|
-| `SARDIS_API_KEY` | No | - | Your Sardis API key. Get one at [sardis.sh](https://sardis.sh) |
-| `SARDIS_WALLET_ID` | No | - | Default wallet ID for operations |
-| `SARDIS_AGENT_ID` | No | - | Agent ID for this MCP connection |
-| `SARDIS_MODE` | No | `simulated` | `live` for real transactions, `simulated` for testing |
-| `SARDIS_API_URL` | No | `https://api.sardis.sh` | API endpoint (for enterprise/self-hosted) |
+**Approvals**
+- "Request approval for a $2500 payment to Stripe"
+- "Check status of pending approval requests"
+- "List all transactions waiting for approval"
 
-### Getting Your API Key
+---
 
-1. Sign up at [sardis.sh](https://sardis.sh)
-2. Go to Settings > API Keys
-3. Create a new API key with appropriate permissions
-4. Add it to your MCP configuration
+## Security
 
-## Simulated Mode
+### Non-Custodial Architecture
 
-When running without an API key, the server operates in simulated mode with:
-- Mock wallet with $1000 balance
-- Simulated transactions that don't execute on-chain
-- Full policy validation to test your rules
-- Realistic response formats
+Sardis uses Turnkey MPC (Multi-Party Computation) for key management. Private keys are never exposed or stored—they exist only as distributed key shares across secure enclaves.
 
-## API Reference
+### Policy Enforcement
 
-### Tools Schema
+Every transaction is validated against:
+- **Spending limits** (per-transaction, daily, monthly)
+- **Allowed categories** (SaaS, DevTools, Cloud, API, etc.)
+- **Blocked merchants** (configurable blocklist)
+- **Risk scoring** (KYA trust scoring for agents)
 
-Each tool follows the MCP tool specification:
+### KYA (Know Your Agent) Trust Scoring
 
-```typescript
-interface Tool {
-  name: string;
-  description: string;
-  inputSchema: JSONSchema;
-}
-```
+Agents are assigned trust scores based on:
+- Transaction history
+- Policy compliance rate
+- Approval patterns
+- Anomaly detection
 
-### Common Parameters
+### Audit Trail
 
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `wallet_id` | `string` | The wallet ID to operate on |
-| `amount` | `string` | Amount in USD (e.g., "100.00") |
-| `vendor` | `string` | Merchant/vendor name |
-| `purpose` | `string` | Description of the payment purpose |
+All transactions are logged to an append-only ledger for:
+- Compliance reporting
+- Dispute resolution
+- Forensic analysis
+- Regulatory audits
 
-### Response Format
+---
 
-All tools return responses in this format:
+## Environment Variables
 
-```typescript
-interface ToolResponse {
-  success: boolean;
-  status: 'APPROVED' | 'BLOCKED' | 'PENDING' | 'ERROR';
-  data?: Record<string, unknown>;
-  error?: string;
-  message?: string;
-}
-```
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `SARDIS_API_KEY` | No | - | Your Sardis API key ([get one](https://sardis.sh)) |
+| `SARDIS_WALLET_ID` | No | - | Default wallet ID for operations |
+| `SARDIS_AGENT_ID` | No | - | Agent ID for this MCP connection |
+| `SARDIS_MODE` | No | `sandbox` | `live` for real transactions, `sandbox` for testing |
+| `SARDIS_API_URL` | No | `https://api.sardis.sh` | API endpoint (for enterprise/self-hosted) |
+
+---
+
+## Links
+
+- **Website**: [sardis.sh](https://sardis.sh)
+- **Documentation**: [docs.sardis.sh](https://docs.sardis.sh)
+- **GitHub**: [github.com/EfeDurmaz16/sardis](https://github.com/EfeDurmaz16/sardis)
+- **Discord**: [discord.gg/XMA9JwDJ](https://discord.gg/XMA9JwDJ)
+- **Support**: support@sardis.sh
+
+---
 
 ## Requirements
 
 - Node.js 18.0.0 or higher
-- Claude Desktop, Cursor, or any MCP-compatible client
+- MCP-compatible client (Claude Desktop, Cursor, VS Code, etc.)
+
+---
 
 ## Troubleshooting
 
@@ -347,29 +310,24 @@ interface ToolResponse {
 2. Clear npx cache: `npx clear-npx-cache`
 3. Try global install: `npm install -g @sardis/mcp-server`
 
-### Tools not appearing in Claude
+### Tools not appearing
 
-1. Restart Claude Desktop after configuration changes
-2. Check the configuration file path is correct for your OS
-3. Verify JSON syntax is valid
+1. Restart your MCP client after configuration changes
+2. Verify JSON syntax in config file
+3. Check file path is correct for your OS
 
 ### API errors
 
-1. Check your API key is valid
+1. Verify API key is valid at [sardis.sh/settings/api-keys](https://sardis.sh/settings/api-keys)
 2. Ensure `SARDIS_MODE` is set to `live` for production
-3. Verify wallet ID exists in your account
-
-## Support
+3. Check wallet ID exists in your account
 
-- [Documentation](https://docs.sardis.sh)
-- [GitHub Issues](https://github.com/sardis-network/sardis/issues)
-- [Discord Community](https://discord.gg/sardis)
-- Email: support@sardis.sh
-
-## Contributing
-
-See [CONTRIBUTING.md](../../CONTRIBUTING.md) for guidelines.
+---
 
 ## License
 
 MIT - see [LICENSE](./LICENSE) for details.
+
+---
+
+**Built with the Model Context Protocol (MCP)** — enabling AI agents to safely interact with external tools and services.

package/dist/api.d.ts

@@ -6,7 +6,7 @@
 /**
  * Make an API request to Sardis
  */
-export declare function apiRequest<T>(method: string, path: string, body?: unknown): Promise<T>;
+export declare function apiRequest<T>(method: string, path: string, body?: unknown, extraHeaders?: Record<string, string>): Promise<T>;
 /**
  * Generate unique mandate ID
  *

package/dist/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,GACb,OAAO,CAAC,CAAC,CAAC,CAsBZ;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAS1C;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBnE"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;GAEG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,OAAO,CAAC,CAAC,CAAC,CAuBZ;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAS1C;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBnE"}

package/dist/api.js

@@ -4,10 +4,11 @@
  * Handles all API communication with the Sardis backend.
  */
 import { getConfig } from './config.js';
+import { MCP_SERVER_VERSION } from './version.js';
 /**
  * Make an API request to Sardis
  */
-export async function apiRequest(method, path, body) {
+export async function apiRequest(method, path, body, extraHeaders) {
     const config = getConfig();
     const url = `${config.apiUrl}${path.startsWith('/') ? path : '/' + path}`;
     const paymentIdentity = process.env.SARDIS_PAYMENT_IDENTITY;
@@ -16,8 +17,9 @@ export async function apiRequest(method, path, body) {
         headers: {
             'X-API-Key': config.apiKey,
             'Content-Type': 'application/json',
-            'User-Agent': 'sardis-mcp-server/0.1.0',
+            'User-Agent': `sardis-mcp-server/${MCP_SERVER_VERSION}`,
             ...(paymentIdentity ? { 'X-Sardis-Payment-Identity': paymentIdentity } : {}),
+            ...(extraHeaders || {}),
         },
         body: body ? JSON.stringify(body) : undefined,
     });