return-billing-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_TODAY | No | The date to use as 'today' for return eligibility calculations, in YYYY-MM-DD format. If not set, the actual system time is used. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| lookup_orderA | ユーザーID（メールアドレス）から、そのユーザーの注文一覧（商品名・数量・注文日・請求ステータス）を取得する。問い合わせ対応の最初のステップとして、ユーザー本人確認を側ねて呼び出す。 |
| check_return_eligibilityA | 注文IDを指定し、注文日から1ヶ月以内かどうかに基づいて返品可能かどうかを判定する。返品期限超過・返品済みの場合も「エラー」ではなく eligible=false の正常応答として返す。 |
| process_returnA | check_return_eligibility で返品可能と判定された注文について、返品理由を受け取り返品処理を確定する。処理完了後、ユーザーの登録メールアドレス宛てに返品受付通知メールを送信する（本サンプルでは送信をシミュレートする）。返品不可の注文に対して呼び出された場合は RETURN_NOT_ELIGIBLE エラーを返す。 |
| get_billing_statusA | ユーザーID（メールアドレス）から、そのユーザーの全注文の請求ステータス（未払い/支払い済み）一覧を取得する。未払いの注文には振込先情報（payment_instructions）が付与される。 |
| escalate_to_humanA | 返品にも請求にも該当しない問い合わせについて、有人オペレーターとの会話セッションを管理する。ユーザーの発言1回ごとに呼び出すこと。ターン数をサーバー側で管理し、5ターンで終了確認、10ターンで強制終了（別問い合わせの起票を依頼）という状態を status フィールドで返す。オペレーターの回答文自体はこのツールでは生成しないため、呼び出し側のエージェントが一般的なオペレーターとして応答内容を作成すること。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
Each tool has a generally distinct purpose, but lookup_order and get_billing_status both return order/billing information and could be confused. The descriptions clarify that lookup_order is for order details while get_billing_status focuses on billing status and payment instructions, but some overlap remains.
All tool names follow a consistent verb_noun pattern with snake_case (lookup_order, check_return_eligibility, process_return, get_billing_status, escalate_to_human). The verbs vary but the pattern is uniform, making it easy to predict tool names.
Five tools is well-scoped for a return/billing MCP server, covering the main customer service actions without unnecessary bloat. Each tool earns its place, and the count is within the ideal 3-15 range.
The tool surface covers the core return and billing workflows: order lookup, eligibility check, return processing, billing status, and escalation. Minor gaps exist, such as no tool to view or update a return after processing, but the main user journey is complete.