# razorpay/razorpay-mcp-server architecture

> Architecture diagram of the GitHub repository razorpay/razorpay-mcp-server, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/razorpay/razorpay-mcp-server
- Repository: https://github.com/razorpay/razorpay-mcp-server

## Overview

##### Project type and purpose
- This is a Go-based backend microservice (“Razorpay MCP Server”) implementing the Model Context Protocol (MCP).
- Purpose: expose a set of “tools” (fetch_payment, create_order, etc.) over the MCP protocol (stdio/JSON-RPC transport) that in turn call Razorpay’s REST APIs.
- It is intended to be run as a Docker container or a standalone binary and plugged into AI agents (Claude Desktop, VS Code) as an MCP server.

##### File structure
- cmd/razorpay-mcp-server
- main.go: application entrypoint, parses flags/env, wires up server
- stdio.go: configures the MCP transport over STDIO
- pkg/mcpgo
- server.go: orchestrates the MCP protocol, request routing
- transport.go: defines transport interfaces (stdio, future HTTP, etc.)
- tool.go: common abstractions for registering tools
- pkg/razorpay
- server.go: high-level Razorpay client setup (credentials, HTTP client)
- orders.go, payments.go, refunds.go, payment_links.go: wrappers around specific REST endpoints
- mock/: in-code test server for unit tests
- pkg/log: centralized logging wrapper
- cmd, pkg directories follow a clear separation of concerns (entrypoint vs. business logic vs. transport vs. external integration)
- Top-level config files: Dockerfile, Makefile, goreleaser.yaml, CI workflows, and Go module files

##### README for additional insights
- Reinforces that this is an MCP server exposing Razorpay APIs as “tools.”
- Describes usage in Docker, direct Go build, and integration into Claude Desktop or VS Code.
- Calls out required environment variables, flags, and optional config (LOG_FILE, TOOLSETS, READ_ONLY).

##### Summary
- Layers: Entry/CMD, Transport, Core, Tools, External API, Logging.
- Config/flags as input parameters into the container.
- Break monolithic views into separate logical components so that each package’s role is clear.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External MCP Client
    MCPClient["MCP Client (e.g., Claude Desktop, VS Code)"]:::external

    %% Server Boundary
    subgraph "Razorpay MCP Server (Docker)"
        direction TB

        %% CLI Layer
        CLI_main["CLI: main.go"]:::internal
        CLI_stdio["CLI: stdio.go"]:::internal

        %% Transport Layer
        Transport["MCP Transport\n(stdio, transport)"]:::internal

        %% Core Server
        CoreServer["MCP Core Server\n(server.go)"]:::internal
        ToolLogic["Tool Abstraction\n(tool.go)"]:::internal

        %% Tool Registry
        Toolsets["Tool Registry / Toolsets"]:::internal

        %% Razorpay Client Library
        subgraph "Razorpay Client Library"
            direction TB
            RP_server["server.go"]:::internal
            RP_orders["orders.go"]:::internal
            RP_payments["payments.go"]:::internal
            RP_refunds["refunds.go"]:::internal
            RP_links["payment_links.go"]:::internal
            RP_tools["tools.go"]:::internal
            RP_params["tools_params.go"]:::internal
            RP_mock["mock/server.go"]:::test
        end

        %% Logging Module
        Logging["Logging Module\n(log.go)"]:::internal
    end

    %% External Razorpay API
    RazorAPI["Razorpay REST API"]:::external

    %% Configuration Files (Deployment)
    Config["Config & Deployment\n(Dockerfile, Makefile,\ngoreleaser.yaml,\n.github/workflows, go.mod)"]:::external

    %% Dependencies / Data Flows
    MCPClient -->|"stdin/stdout\nJSON-RPC"| CLI_main
    CLI_main --> CLI_stdio
    CLI_stdio -->|JSON-RPC| Transport
    Transport -->|Route requests| CoreServer
    CoreServer --> ToolLogic
    ToolLogic --> Toolsets
    Toolsets --> RP_server
    RP_server --> RP_orders
    RP_server --> RP_payments
    RP_server --> RP_refunds
    RP_server --> RP_links
    RP_server --> RP_tools
    RP_server --> RP_params
    RP_server --> RP_mock
    RP_server -->|"HTTP Calls"| RazorAPI
    RazorAPI -->|HTTP Responses| RP_server
    RP_server --> CoreServer
    CoreServer --> Transport
    Transport --> MCPClient

    %% Logging flows
    CLI_main --> Logging
    Transport --> Logging
    CoreServer --> Logging
    ToolLogic --> Logging
    RP_server --> Logging

    %% Config entry
    Config --> CLI_main

    %% Click Events
    click CLI_main "https://github.com/razorpay/razorpay-mcp-server/blob/main/cmd/razorpay-mcp-server/main.go"
    click CLI_stdio "https://github.com/razorpay/razorpay-mcp-server/blob/main/cmd/razorpay-mcp-server/stdio.go"
    click Transport "https://github.com/razorpay/razorpay-mcp-server/blob/main/pkg/mcpgo/stdio.go"
    click Transport "https://github.com/razorpay/razorpay-mcp-server/blob/main/pkg/mcpgo/transport.go"
    click CoreServer "https://github.com/razorpay/razorpay-mcp-server/blob/main/pkg/mcpgo/server.go"
    click ToolLogic "https://github.com/razorpay/razorpay-mcp-server/blob/main/pkg/mcpgo/tool.go"
    click Toolsets "https://github.com/razorpay/razorpay-mcp-server/blob/main/pkg/toolsets/toolsets.go"
    click RP_server "https://github.com/razorpay/razorpay-mcp-server/blob/main/pkg/razorpay/server.go"
    click RP_orders "https://github.com/razorpay/razorpay-mcp-server/blob/main/pkg/razorpay/orders.go"
    click RP_payments "https://github.com/razorpay/razorpay-mcp-server/blob/main/pkg/razorpay/payments.go"
    click RP_refunds "https://github.com/razorpay/razorpay-mcp-server/blob/main/pkg/razorpay/refunds.go"
    click RP_links "https://github.com/razorpay/razorpay-mcp-server/blob/main/pkg/razorpay/payment_links.go"
    click RP_tools "https://github.com/razorpay/razorpay-mcp-server/blob/main/pkg/razorpay/tools.go"
    click RP_params "https://github.com/razorpay/razorpay-mcp-server/blob/main/pkg/razorpay/tools_params.go"
    click RP_mock "https://github.com/razorpay/razorpay-mcp-server/blob/main/pkg/razorpay/mock/server.go"
    click Logging "https://github.com/razorpay/razorpay-mcp-server/blob/main/pkg/log/log.go"

    %% Styles
    classDef internal fill:#add8e6,stroke:#000,stroke-width:1px
    classDef external fill:#90ee90,stroke:#000,stroke-width:1px
    classDef test fill:#f9f,stroke-dasharray: 5 5,stroke:#000,stroke-width:1px
```
