How yigitkonur/mcp-parasut works
This monorepo provides a typed Paraşüt REST API SDK and an MCP server that exposes accounting operations to AI clients. The main workflow is an MCP client calling a registered tool; the server dispatches it to a domain handler, which uses the shared SDK client to access Paraşüt and formats a response. The SDK also serves direct Node.js callers. The graph includes the documented HTTP/OAuth server mode and major accounting domains. Some relationships and capabilities are based on README or source-index references; unsampled tool implementations are not assumed to call specific SDK resources.
Main entry points: ParasutClient.ts Paraşüt SDK client · index.ts Tool registry · server.ts MCP server entry · client.ts SDK client singleton
Components 32
MCP server
- MCP server entry
packages/parasut-mcp-server/src/server.ts - HTTP transport server
packages/parasut-mcp-server/src/http.ts - Server configuration
packages/parasut-mcp-server/src/config.ts - Tool registry
packages/parasut-mcp-server/src/tools/index.ts - SDK client singleton
packages/parasut-mcp-server/src/client.ts - Tool responses and errors
packages/parasut-mcp-server/src/utils/response.ts
SDK runtime
- Paraşüt SDK client
packages/parasut-node-sdk/src/client/ParasutClient.ts - HTTP transport
packages/parasut-node-sdk/src/client/HttpTransport.ts - Query builder
packages/parasut-node-sdk/src/client/QueryBuilder.ts - Rate limiter
packages/parasut-node-sdk/src/client/RateLimiter.ts - Retry handler
packages/parasut-node-sdk/src/client/RetryHandler.ts - Resource CRUD base
packages/parasut-node-sdk/src/resources/BaseResource.ts - Async job tracking
packages/parasut-node-sdk/src/resources/trackableJobs.ts - SDK error types
packages/parasut-node-sdk/src/client/errors.ts
Accounting domains
- Contact tools
packages/parasut-mcp-server/src/tools/contacts.ts - Sales invoice tools
packages/parasut-mcp-server/src/tools/invoices.ts - Purchase bill tools
packages/parasut-mcp-server/src/tools/bills.ts - E-document tools
packages/parasut-mcp-server/src/tools/edocuments.ts - Financial tools
packages/parasut-mcp-server/src/tools/financial.ts - Inventory tools
packages/parasut-mcp-server/src/tools/inventory.ts - Product tools
packages/parasut-mcp-server/src/tools/products.ts - Organization tools
packages/parasut-mcp-server/src/tools/organization.ts - Sales resources
packages/parasut-node-sdk/src/resources/salesInvoices.ts - Purchase resources
packages/parasut-node-sdk/src/resources/purchaseBills.ts - Contact resources
packages/parasut-node-sdk/src/resources/contacts.ts - Products and inventory
packages/parasut-node-sdk/src/resources/products.ts - E-document resources
packages/parasut-node-sdk/src/resources/eInvoices.ts - Financial resources
packages/parasut-node-sdk/src/resources/transactions.ts
Authentication and delivery
- OAuth endpoints
packages/parasut-mcp-server/src/oauth.ts - OAuth manager
packages/parasut-node-sdk/src/client/OAuth.ts
Other components
- MCP client
- Paraşüt API
Connections 40
- MCP client → MCP server entry: calls tools
packages/parasut-mcp-server/src/server.ts - MCP server entry → Server configuration: loads config
packages/parasut-mcp-server/src/server.ts - MCP server entry → SDK client singleton: initializes client
packages/parasut-mcp-server/src/server.ts - MCP server entry → Tool registry: dispatches calls
packages/parasut-mcp-server/src/server.ts - MCP server entry → HTTP transport server: starts HTTP mode
packages/parasut-mcp-server/src/server.ts - MCP client → HTTP transport server: uses HTTP mode
- HTTP transport server → Server configuration: loads config
packages/parasut-mcp-server/src/http.ts - HTTP transport server → OAuth endpoints: uses OAuth routes
packages/parasut-mcp-server/src/http.ts - Tool registry → Contact tools: dispatches tools
packages/parasut-mcp-server/src/tools/index.ts - Tool registry → Sales invoice tools: dispatches tools
packages/parasut-mcp-server/src/tools/index.ts - Tool registry → Purchase bill tools: dispatches tools
packages/parasut-mcp-server/src/tools/index.ts - Tool registry → E-document tools: dispatches tools
packages/parasut-mcp-server/src/tools/index.ts - Tool registry → Financial tools: dispatches tools
packages/parasut-mcp-server/src/tools/index.ts - Tool registry → Inventory tools: dispatches tools
packages/parasut-mcp-server/src/tools/index.ts - Tool registry → Product tools: dispatches tools
packages/parasut-mcp-server/src/tools/index.ts - Tool registry → Organization tools: dispatches tools
packages/parasut-mcp-server/src/tools/index.ts - SDK client singleton → Paraşüt SDK client: creates SDK client
packages/parasut-mcp-server/src/client.ts - Contact tools → SDK client singleton: uses shared client
packages/parasut-mcp-server/src/tools/contacts.ts - Sales invoice tools → SDK client singleton: uses shared client
packages/parasut-mcp-server/src/tools/invoices.ts - E-document tools → SDK client singleton: uses shared client
packages/parasut-mcp-server/src/tools/edocuments.ts - Contact tools → Tool responses and errors: formats responses
packages/parasut-mcp-server/src/tools/contacts.ts - Sales invoice tools → Tool responses and errors: formats responses
packages/parasut-mcp-server/src/tools/invoices.ts - E-document tools → Tool responses and errors: formats responses
packages/parasut-mcp-server/src/tools/edocuments.ts - Paraşüt SDK client → OAuth manager: manages authentication
packages/parasut-node-sdk/src/client/ParasutClient.ts - Paraşüt SDK client → HTTP transport: sends API requests
packages/parasut-node-sdk/src/client/ParasutClient.ts - Paraşüt SDK client → Rate limiter: limits requests
packages/parasut-node-sdk/src/client/ParasutClient.ts - Paraşüt SDK client → Retry handler: retries requests
packages/parasut-node-sdk/src/client/ParasutClient.ts - Paraşüt SDK client → Sales resources: exposes resources
packages/parasut-node-sdk/src/client/ParasutClient.ts - Paraşüt SDK client → Purchase resources: exposes resources
packages/parasut-node-sdk/src/client/ParasutClient.ts - Paraşüt SDK client → Contact resources: exposes resources
packages/parasut-node-sdk/src/client/ParasutClient.ts - Paraşüt SDK client → Products and inventory: exposes resources
packages/parasut-node-sdk/src/client/ParasutClient.ts - Paraşüt SDK client → E-document resources: exposes resources
packages/parasut-node-sdk/src/client/ParasutClient.ts - Paraşüt SDK client → Async job tracking: exposes job tracking
packages/parasut-node-sdk/src/client/ParasutClient.ts - Paraşüt SDK client → Financial resources: exposes resources
packages/parasut-node-sdk/src/client/ParasutClient.ts - Resource CRUD base → HTTP transport: sends CRUD requests
packages/parasut-node-sdk/src/resources/BaseResource.ts - Resource CRUD base → Query builder: builds queries
packages/parasut-node-sdk/src/resources/BaseResource.ts - Async job tracking → HTTP transport: polls job status
packages/parasut-node-sdk/src/resources/trackableJobs.ts - HTTP transport → SDK error types: creates API errors
packages/parasut-node-sdk/src/client/HttpTransport.ts - Paraşüt API → HTTP transport: serves REST API
- OAuth manager → Paraşüt API: authenticates requests