parasut-node-sdk-mcp 1.0.0

package/packages/parasut-mcp-server/README.md

@@ -0,0 +1,312 @@
+# @yigitkonur/parasut-mcp-server
+
+[![npm version](https://img.shields.io/npm/v/@yigitkonur/parasut-mcp-server.svg)](https://www.npmjs.com/package/@yigitkonur/parasut-mcp-server)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue.svg)](https://www.typescriptlang.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+> **UNOFFICIAL** MCP (Model Context Protocol) Server for the [Paraşüt](https://www.parasut.com/) API.
+>
+> **Not affiliated with Paraşüt.** This is a community-maintained project.
+
+Use Claude AI to manage your Turkish accounting - invoices, contacts, products, e-fatura, and financial operations through natural conversation.
+
+## Features
+
+- **34 AI-Optimized Tools** - Intent-first design, not 1:1 API mapping
+- **Confirmation Patterns** - Preview mode before executing financial operations
+- **Double Confirmation** - Extra safety for irreversible e-invoice submissions to GİB
+- **Smart Responses** - Every response includes next-step guidance
+- **Error Recovery** - Helpful error messages with fix instructions
+- **Turkish E-Invoicing** - Full support for e-Fatura, e-Arşiv, e-SMM
+
+## Installation
+
+### Global Install (Recommended)
+
+```bash
+npm install -g @yigitkonur/parasut-mcp-server
+```
+
+### Or use with npx
+
+```bash
+npx @yigitkonur/parasut-mcp-server
+```
+
+## Configuration
+
+### Environment Variables
+
+```bash
+# Required
+PARASUT_COMPANY_ID=123456
+PARASUT_CLIENT_ID=your-client-id
+PARASUT_CLIENT_SECRET=your-client-secret
+PARASUT_USERNAME=your-username
+PARASUT_PASSWORD=your-password
+
+# Optional
+PARASUT_BASE_URL=https://api.parasut.com/v4
+DEBUG=true
+```
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "parasut": {
+      "command": "parasut-mcp",
+      "env": {
+        "PARASUT_COMPANY_ID": "123456",
+        "PARASUT_CLIENT_ID": "your-client-id",
+        "PARASUT_CLIENT_SECRET": "your-client-secret",
+        "PARASUT_USERNAME": "your-username",
+        "PARASUT_PASSWORD": "your-password"
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+Add to your MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "parasut": {
+      "command": "npx",
+      "args": ["@yigitkonur/parasut-mcp-server"],
+      "env": {
+        "PARASUT_COMPANY_ID": "123456",
+        "PARASUT_CLIENT_ID": "your-client-id",
+        "PARASUT_CLIENT_SECRET": "your-client-secret",
+        "PARASUT_USERNAME": "your-username",
+        "PARASUT_PASSWORD": "your-password"
+      }
+    }
+  }
+}
+```
+
+## Available Tools (34 total)
+
+### Contacts (4 tools)
+
+| Tool | Description |
+|------|-------------|
+| `search_contacts` | Search customers/suppliers by name, email, or tax number |
+| `get_contact` | Get detailed contact information with balance |
+| `create_contact` | Create a new customer or supplier |
+| `update_contact` | Update contact information |
+
+### Sales Invoices (7 tools)
+
+| Tool | Description |
+|------|-------------|
+| `search_invoices` | Search invoices by customer, date, or status |
+| `get_invoice` | Get invoice details with line items and payments |
+| `create_invoice` | Create a new sales invoice (requires confirmation) |
+| `cancel_invoice` | Cancel an invoice (requires confirmation) |
+| `recover_invoice` | Recover a cancelled invoice |
+| `invoice_pdf` | Generate PDF for an invoice |
+| `record_invoice_payment` | Record payment received (requires confirmation) |
+
+### Purchase Bills (4 tools)
+
+| Tool | Description |
+|------|-------------|
+| `search_bills` | Search purchase bills/expenses |
+| `get_bill` | Get bill details |
+| `create_bill` | Create a new purchase bill (requires confirmation) |
+| `record_bill_payment` | Record payment to supplier (requires confirmation) |
+
+### Products (4 tools)
+
+| Tool | Description |
+|------|-------------|
+| `search_products` | Search products and services |
+| `get_product` | Get product details with inventory |
+| `create_product` | Create a new product |
+| `update_product` | Update product information |
+
+### E-Documents (4 tools)
+
+| Tool | Description |
+|------|-------------|
+| `check_einvoice_inbox` | Check if contact is e-invoice registered |
+| `send_einvoice` | Send invoice as e-Fatura (DOUBLE confirmation - irreversible!) |
+| `send_earchive` | Send invoice as e-Arşiv (DOUBLE confirmation - irreversible!) |
+| `send_esmm` | Send invoice as e-SMM (DOUBLE confirmation - irreversible!) |
+
+### Financial (4 tools)
+
+| Tool | Description |
+|------|-------------|
+| `list_accounts` | List bank/cash accounts with balances |
+| `search_transactions` | Search financial transactions |
+| `create_bank_fee` | Record a bank fee (requires confirmation) |
+| `get_financial_summary` | Get receivables/payables overview |
+
+### Inventory (2 tools)
+
+| Tool | Description |
+|------|-------------|
+| `get_stock_levels` | Get current inventory levels |
+| `search_stock_movements` | Search stock movement history |
+
+### Organization (5 tools)
+
+| Tool | Description |
+|------|-------------|
+| `list_categories` | List item categories |
+| `list_tags` | List tags for organization |
+| `list_employees` | List employees |
+| `create_salary` | Record salary payment (requires confirmation) |
+| `create_tax` | Record tax payment (requires confirmation) |
+
+## Safety Features
+
+### Confirmation Pattern
+
+Financial operations require explicit confirmation:
+
+```
+User: Create an invoice for 5000 TL to Acme Corp
+
+Claude: I'll create this invoice. Here's the preview:
+- Customer: Acme Corp
+- Amount: 5000 TL
+- Net: 5000 TL, VAT: 1000 TL, Total: 6000 TL
+
+⚠️ Call again with confirm=true to proceed.
+
+User: Yes, confirm it
+
+Claude: [Executes with confirm=true]
+✅ Invoice #INV-2024-001 created successfully.
+```
+
+### Double Confirmation for E-Documents
+
+E-invoices submitted to GİB (Turkish Tax Authority) are **irreversible**:
+
+```
+User: Send invoice #123 as e-fatura
+
+Claude: ⚠️🚨 IRREVERSIBLE OPERATION 🚨⚠️
+
+This will submit to GİB (Tax Authority) and CANNOT be undone!
+
+To proceed, you must:
+1. Set confirm=true
+2. Set i_understand_this_is_irreversible="YES"
+
+User: I understand, proceed with both confirmations
+
+Claude: [Executes with both confirmations]
+✅ E-invoice submitted to GİB successfully.
+```
+
+## Example Conversations
+
+### Create and Send Invoice
+
+```
+User: Create an invoice for 10,000 TL consulting services to ABC Company,
+      then send it as e-fatura
+
+Claude: I'll help you with that. Let me:
+1. Search for ABC Company
+2. Create the invoice
+3. Check if they're e-invoice registered
+4. Send as e-fatura
+
+[Executes step by step with confirmations]
+```
+
+### Financial Overview
+
+```
+User: What's our current financial position?
+
+Claude: [Uses get_financial_summary]
+
+Financial Summary:
+- Receivables: 125,000 TL (15 open invoices)
+- Payables: 45,000 TL (8 open bills)
+- Net Position: +80,000 TL
+
+Bank Accounts:
+- İş Bankası: 50,000 TL
+- Garanti: 32,000 TL
+```
+
+### Record Payments
+
+```
+User: Record that ABC Company paid 5000 TL for invoice #456
+
+Claude: [Uses record_invoice_payment with preview]
+
+Preview:
+- Invoice: #456
+- Customer: ABC Company
+- Current remaining: 10,000 TL
+- Payment: 5,000 TL
+- New remaining: 5,000 TL
+
+⚠️ Confirm to proceed...
+```
+
+## Design Philosophy
+
+1. **Task-Shaped Tools** - Tools designed around user tasks, not API endpoints
+2. **Under 40 Tools** - Well under the cognitive limit for AI tool selection
+3. **Guided Responses** - Every response includes relevant next steps
+4. **Error Recovery** - Errors explain what went wrong and how to fix it
+5. **Safety First** - Confirmation patterns prevent accidental financial changes
+
+## Development
+
+```bash
+# Clone the repository
+git clone https://github.com/yigitkonur/parasut-node-sdk-mcp.git
+cd parasut-node-sdk-mcp
+
+# Install dependencies
+npm install
+
+# Build
+npm run build:mcp
+
+# Run locally
+npm run start --workspace=@yigitkonur/parasut-mcp-server
+
+# Type check
+npm run typecheck
+```
+
+## Disclaimer
+
+**This is an UNOFFICIAL project.**
+
+- Not affiliated with, endorsed by, or connected to Paraşüt
+- Paraşüt is a trademark of Paraşüt Bilgi Teknolojileri A.Ş.
+- Use at your own risk
+- E-documents submitted to GİB are legally binding and irreversible
+
+## License
+
+MIT © [Yigit Konur](https://github.com/yigitkonur)
+
+## Links
+
+- [GitHub Repository](https://github.com/yigitkonur/parasut-node-sdk-mcp)
+- [SDK Package](https://www.npmjs.com/package/@yigitkonur/parasut-node-sdk)
+- [Paraşüt API Documentation](https://apidocs.parasut.com/)
+- [MCP Protocol](https://modelcontextprotocol.io/)

package/packages/parasut-mcp-server/dist/client.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Paraşüt SDK Client
+ *
+ * Singleton client for the Paraşüt API.
+ * Initialized once at server startup and reused for all tool calls.
+ */
+import { ParasutClient } from '@yigitkonur/parasut-node-sdk';
+import type { ParasutConfig } from './config.js';
+/**
+ * Initializes the Paraşüt client singleton.
+ * Must be called once at server startup with valid configuration.
+ */
+export declare function initializeClient(config: ParasutConfig): ParasutClient;
+/**
+ * Gets the Paraşüt client singleton.
+ * Throws if client has not been initialized.
+ */
+export declare function getClient(): ParasutClient;
+/**
+ * Resets the client singleton.
+ * Primarily used for testing.
+ */
+export declare function resetClient(): void;
+//# sourceMappingURL=client.d.ts.map

package/packages/parasut-mcp-server/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAiBrE;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,aAAa,CAOzC;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC"}

package/packages/parasut-mcp-server/dist/client.js

@@ -0,0 +1,46 @@
+/**
+ * Paraşüt SDK Client
+ *
+ * Singleton client for the Paraşüt API.
+ * Initialized once at server startup and reused for all tool calls.
+ */
+import { ParasutClient } from '@yigitkonur/parasut-node-sdk';
+let client = null;
+/**
+ * Initializes the Paraşüt client singleton.
+ * Must be called once at server startup with valid configuration.
+ */
+export function initializeClient(config) {
+    if (client) {
+        return client;
+    }
+    client = new ParasutClient({
+        companyId: config.companyId,
+        credentials: {
+            clientId: config.clientId,
+            clientSecret: config.clientSecret,
+            username: config.username,
+            password: config.password,
+        },
+        ...(config.baseUrl !== undefined && { baseUrl: config.baseUrl }),
+    });
+    return client;
+}
+/**
+ * Gets the Paraşüt client singleton.
+ * Throws if client has not been initialized.
+ */
+export function getClient() {
+    if (!client) {
+        throw new Error('Paraşüt client not initialized. Call initializeClient() first.');
+    }
+    return client;
+}
+/**
+ * Resets the client singleton.
+ * Primarily used for testing.
+ */
+export function resetClient() {
+    client = null;
+}
+//# sourceMappingURL=client.js.map

package/packages/parasut-mcp-server/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAG7D,IAAI,MAAM,GAAyB,IAAI,CAAC;AAExC;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAqB;IACpD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,GAAG,IAAI,aAAa,CAAC;QACzB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,WAAW,EAAE;YACX,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B;QACD,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;KACjE,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,GAAG,IAAI,CAAC;AAChB,CAAC"}

package/packages/parasut-mcp-server/dist/config.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Configuration
+ *
+ * Loads configuration from environment variables.
+ * All Paraşüt credentials must be provided via environment.
+ */
+export interface ParasutConfig {
+    companyId: number;
+    clientId: string;
+    clientSecret: string;
+    username: string;
+    password: string;
+    baseUrl?: string;
+}
+export interface ServerConfig {
+    parasut: ParasutConfig;
+    debug: boolean;
+}
+/**
+ * Loads configuration from environment variables.
+ *
+ * Required environment variables:
+ * - PARASUT_COMPANY_ID: Your Paraşüt company ID (firma ID)
+ * - PARASUT_CLIENT_ID: OAuth client ID
+ * - PARASUT_CLIENT_SECRET: OAuth client secret
+ * - PARASUT_USERNAME: Your Paraşüt username (email)
+ * - PARASUT_PASSWORD: Your Paraşüt password
+ *
+ * Optional:
+ * - PARASUT_BASE_URL: API base URL (default: https://api.parasut.com/v4)
+ * - DEBUG: Enable debug logging (default: false)
+ */
+export declare function loadConfig(): ServerConfig;
+/**
+ * Validates that all required configuration is present.
+ * Call this early to fail fast on missing config.
+ */
+export declare function validateConfig(config: ServerConfig): void;
+//# sourceMappingURL=config.d.ts.map

package/packages/parasut-mcp-server/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;CAChB;AAwBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,IAAI,YAAY,CAazC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAsBzD"}

package/packages/parasut-mcp-server/dist/config.js

@@ -0,0 +1,74 @@
+/**
+ * Configuration
+ *
+ * Loads configuration from environment variables.
+ * All Paraşüt credentials must be provided via environment.
+ */
+function getEnv(name, required = false) {
+    const value = process.env[name];
+    if (required && !value) {
+        throw new Error(`Missing required environment variable: ${name}`);
+    }
+    return value;
+}
+function getEnvInt(name, required = false) {
+    const value = getEnv(name, required);
+    if (value === undefined)
+        return undefined;
+    const parsed = parseInt(value, 10);
+    if (isNaN(parsed)) {
+        throw new Error(`Environment variable ${name} must be a valid integer`);
+    }
+    return parsed;
+}
+/**
+ * Loads configuration from environment variables.
+ *
+ * Required environment variables:
+ * - PARASUT_COMPANY_ID: Your Paraşüt company ID (firma ID)
+ * - PARASUT_CLIENT_ID: OAuth client ID
+ * - PARASUT_CLIENT_SECRET: OAuth client secret
+ * - PARASUT_USERNAME: Your Paraşüt username (email)
+ * - PARASUT_PASSWORD: Your Paraşüt password
+ *
+ * Optional:
+ * - PARASUT_BASE_URL: API base URL (default: https://api.parasut.com/v4)
+ * - DEBUG: Enable debug logging (default: false)
+ */
+export function loadConfig() {
+    const baseUrl = getEnv('PARASUT_BASE_URL');
+    return {
+        parasut: {
+            companyId: getEnvInt('PARASUT_COMPANY_ID', true),
+            clientId: getEnv('PARASUT_CLIENT_ID', true),
+            clientSecret: getEnv('PARASUT_CLIENT_SECRET', true),
+            username: getEnv('PARASUT_USERNAME', true),
+            password: getEnv('PARASUT_PASSWORD', true),
+            ...(baseUrl !== undefined && { baseUrl }),
+        },
+        debug: getEnv('DEBUG') === 'true',
+    };
+}
+/**
+ * Validates that all required configuration is present.
+ * Call this early to fail fast on missing config.
+ */
+export function validateConfig(config) {
+    const { parasut } = config;
+    if (parasut.companyId <= 0) {
+        throw new Error('PARASUT_COMPANY_ID must be a positive integer');
+    }
+    if (!parasut.clientId.trim()) {
+        throw new Error('PARASUT_CLIENT_ID cannot be empty');
+    }
+    if (!parasut.clientSecret.trim()) {
+        throw new Error('PARASUT_CLIENT_SECRET cannot be empty');
+    }
+    if (!parasut.username.trim()) {
+        throw new Error('PARASUT_USERNAME cannot be empty');
+    }
+    if (!parasut.password.trim()) {
+        throw new Error('PARASUT_PASSWORD cannot be empty');
+    }
+}
+//# sourceMappingURL=config.js.map

package/packages/parasut-mcp-server/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,SAAS,MAAM,CAAC,IAAY,EAAE,QAAQ,GAAG,KAAK;IAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,0CAA0C,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAID,SAAS,SAAS,CAAC,IAAY,EAAE,QAAQ,GAAG,KAAK;IAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,QAAgB,CAAC,CAAC;IAC7C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACnC,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,0BAA0B,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,OAAO,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAC3C,OAAO;QACL,OAAO,EAAE;YACP,SAAS,EAAE,SAAS,CAAC,oBAAoB,EAAE,IAAI,CAAC;YAChD,QAAQ,EAAE,MAAM,CAAC,mBAAmB,EAAE,IAAI,CAAC;YAC3C,YAAY,EAAE,MAAM,CAAC,uBAAuB,EAAE,IAAI,CAAC;YACnD,QAAQ,EAAE,MAAM,CAAC,kBAAkB,EAAE,IAAI,CAAC;YAC1C,QAAQ,EAAE,MAAM,CAAC,kBAAkB,EAAE,IAAI,CAAC;YAC1C,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,CAAC;SAC1C;QACD,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,MAAM;KAClC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAoB;IACjD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAE3B,IAAI,OAAO,CAAC,SAAS,IAAI,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;AACH,CAAC"}

package/packages/parasut-mcp-server/dist/index.d.ts

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+/**
+ * Paraşüt MCP Server
+ *
+ * Model Context Protocol server for Paraşüt API.
+ * Provides AI-friendly tools for Turkish accounting and invoicing.
+ *
+ * Usage:
+ *   npx @parasut/mcp-server
+ *
+ * Environment Variables:
+ *   PARASUT_COMPANY_ID    - Your company ID (required)
+ *   PARASUT_CLIENT_ID     - OAuth client ID (required)
+ *   PARASUT_CLIENT_SECRET - OAuth client secret (required)
+ *   PARASUT_USERNAME      - Your username (required)
+ *   PARASUT_PASSWORD      - Your password (required)
+ *   PARASUT_BASE_URL      - API base URL (optional)
+ *   DEBUG                 - Enable debug logging (optional)
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/packages/parasut-mcp-server/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;GAiBG"}

package/packages/parasut-mcp-server/dist/index.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+/**
+ * Paraşüt MCP Server
+ *
+ * Model Context Protocol server for Paraşüt API.
+ * Provides AI-friendly tools for Turkish accounting and invoicing.
+ *
+ * Usage:
+ *   npx @parasut/mcp-server
+ *
+ * Environment Variables:
+ *   PARASUT_COMPANY_ID    - Your company ID (required)
+ *   PARASUT_CLIENT_ID     - OAuth client ID (required)
+ *   PARASUT_CLIENT_SECRET - OAuth client secret (required)
+ *   PARASUT_USERNAME      - Your username (required)
+ *   PARASUT_PASSWORD      - Your password (required)
+ *   PARASUT_BASE_URL      - API base URL (optional)
+ *   DEBUG                 - Enable debug logging (optional)
+ */
+import { startServer } from './server.js';
+// Start the server
+startServer().catch((error) => {
+    console.error('Failed to start Paraşüt MCP server:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/packages/parasut-mcp-server/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,mBAAmB;AACnB,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC5B,OAAO,CAAC,KAAK,CAAC,qCAAqC,EAAE,KAAK,CAAC,CAAC;IAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/packages/parasut-mcp-server/dist/server.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Paraşüt MCP Server
+ *
+ * Model Context Protocol server for Paraşüt API.
+ * Provides tools for Turkish accounting and invoicing operations.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { type ServerConfig } from './config.js';
+/**
+ * Creates and configures the MCP server.
+ */
+export declare function createServer(config: ServerConfig): Server;
+/**
+ * Starts the MCP server with stdio transport.
+ */
+export declare function startServer(): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/packages/parasut-mcp-server/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAQnE,OAAO,EAA8B,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAQ5E;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA8BzD;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAiBjD"}

package/packages/parasut-mcp-server/dist/server.js

@@ -0,0 +1,61 @@
+/**
+ * Paraşüt MCP Server
+ *
+ * Model Context Protocol server for Paraşüt API.
+ * Provides tools for Turkish accounting and invoicing operations.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { loadConfig, validateConfig } from './config.js';
+import { initializeClient } from './client.js';
+import { getAllTools, handleToolCall } from './tools/index.js';
+// Server metadata
+const SERVER_NAME = 'parasut-mcp-server';
+const SERVER_VERSION = '1.0.0';
+/**
+ * Creates and configures the MCP server.
+ */
+export function createServer(config) {
+    // Initialize SDK client
+    initializeClient(config.parasut);
+    // Create MCP server
+    const server = new Server({
+        name: SERVER_NAME,
+        version: SERVER_VERSION,
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // Handle tool listing
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        const tools = getAllTools();
+        return { tools };
+    });
+    // Handle tool calls
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        return handleToolCall(name, args ?? {});
+    });
+    return server;
+}
+/**
+ * Starts the MCP server with stdio transport.
+ */
+export async function startServer() {
+    // Load and validate configuration
+    const config = loadConfig();
+    validateConfig(config);
+    // Create server
+    const server = createServer(config);
+    // Connect to stdio transport
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Log to stderr (stdout is reserved for MCP protocol)
+    if (config.debug) {
+        console.error(`${SERVER_NAME} v${SERVER_VERSION} started`);
+        console.error(`Company ID: ${config.parasut.companyId}`);
+    }
+}
+//# sourceMappingURL=server.js.map

package/packages/parasut-mcp-server/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GAEvB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAqB,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE/D,kBAAkB;AAClB,MAAM,WAAW,GAAG,oBAAoB,CAAC;AACzC,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,wBAAwB;IACxB,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEjC,oBAAoB;IACpB,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;QACE,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,cAAc;KACxB,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;SACV;KACF,CACF,CAAC;IAEF,sBAAsB;IACtB,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,KAAK,GAAW,WAAW,EAAE,CAAC;QACpC,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,oBAAoB;IACpB,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QACjD,OAAO,cAAc,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,kCAAkC;IAClC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,cAAc,CAAC,MAAM,CAAC,CAAC;IAEvB,gBAAgB;IAChB,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAEpC,6BAA6B;IAC7B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,sDAAsD;IACtD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO,CAAC,KAAK,CAAC,GAAG,WAAW,KAAK,cAAc,UAAU,CAAC,CAAC;QAC3D,OAAO,CAAC,KAAK,CAAC,eAAe,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC"}

package/packages/parasut-mcp-server/dist/tools/bills.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Purchase Bill Tools
+ *
+ * Tools for managing expenses and purchase bills.
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { type ToolResponse } from '../utils/response.js';
+export declare const billTools: Tool[];
+export declare function handleSearchBills(args: unknown): Promise<ToolResponse>;
+export declare function handleGetBill(args: unknown): Promise<ToolResponse>;
+export declare function handleCreateBill(args: unknown): Promise<ToolResponse>;
+export declare function handleRecordBillPayment(args: unknown): Promise<ToolResponse>;
+//# sourceMappingURL=bills.d.ts.map

package/packages/parasut-mcp-server/dist/tools/bills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bills.d.ts","sourceRoot":"","sources":["../../src/tools/bills.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE/D,OAAO,EAKL,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAiD9B,eAAO,MAAM,SAAS,EAAE,IAAI,EAsJ3B,CAAC;AAMF,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CA2B5E;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CA6BxE;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CA4E3E;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAyDlF"}