razorpay-mcp-server: Instructions file for Codex

Agent Instructions

This file provides instructions for AI coding agents working on this repository.

Project Overview

This is a Go MCP (Model Context Protocol) server that wraps Razorpay APIs. Tools live in pkg/razorpay/, are registered in pkg/razorpay/tools.go, and tested alongside in *_test.go files.

Key Commands

make test    # Run all tests
make fmt     # Format code
make lint    # Run golangci-lint
make build   # Build the binary

Contributing

See CONTRIBUTING.md for branch naming (username/feature), commit format ([type]: description), and PR process.

Code Style

• 80-char line length max (lll linter)
• goimports with local prefix github.com/razorpay/razorpay-mcp-server
• Full linter config in .golangci.yaml

---

Razorpay MCP Tool Generator

Generate complete MCP tool implementations from Razorpay API docs, curl commands, or request/response examples.

Input Formats

The user may provide any of:

1. Razorpay docs URL — https://razorpay.com/docs/api/...
2. curl command — extract method, path, headers, body, and response
3. Request/response JSON — raw payload and expected response
4. SDK function signature — Go SDK function to call

If the tool name is not provided or cannot be inferred, ask the user before proceeding.

Workflow

Task Progress:
- [ ] Step 1: Parse input and extract API contract
- [ ] Step 2: Determine tool name and resource file
- [ ] Step 3: Implement tool function
- [ ] Step 4: Register tool in tools.go
- [ ] Step 5: Write unit tests
- [ ] Step 6: Update README.md Available Tools table
- [ ] Step 7: Run linter — fix errors
- [ ] Step 8: Run tests — fix errors
- [ ] Step 9: Create branch, commit, and open PR (if gh available)

Step 1: Parse Input

From docs URL: Fetch the page and extract endpoint path, HTTP method, required/optional params with types and descriptions, and example response.

From curl: Parse the method (-X), URL path, headers (-H), request body (-d), and note the response if provided.