Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion content/menuItems.json

Large diffs are not rendered by default.

44 changes: 1 addition & 43 deletions content/payments/billpay/mcp/integration-guide.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ order: 1
visible_in_sidebar: true
---

## MCP for Bill Payments - Integration guide
## Agentic Bill Payments - MCP Server - Integration guide

Currently live on ChatGPT and Claude, as other LLM providers don't allow for custom connectors. All bill payments require a phone number/OTP to fetch bills.

Expand Down Expand Up @@ -91,50 +91,8 @@ Ensure you have at least a Claude Pro account, and installed a Claude Desktop.

You are ready!

### Cursor

1. Ensure you have Cursor installed and running.
2. **Open Cursor** → start a chat with cursor agent -> click on three dots at the top left of agent chat.
<ol type="a">
<li><strong>Agent Settings &gt; Tools &amp; MCP &gt; New MCP Server.</strong> This will open the mcp server mcp.json file.</li>
</ol>
3. Add the following JSON to existing or empty file (include other mcp servers alongside as needed):

<CodeBlockWithCopy language="json">{`
{
"mcpServers": {
.
. other mcp servers
.
"cou-mcp-server": {
"command": "npx",
"args" : [
"mcp-remote",
"https://billpay-mcp.setu.co/mcp"
]
}
}
}
`}</CodeBlockWithCopy>

4. **Verify your phone number with an OTP**
5. On confirming, you will be taken to a page to enter your phone number and OTP. All bill payments require a phone number to fetch bills.
6. Start Chatting!
<ol type="a">
<li>Make bill payments while coding.</li>
<li>Make agents that can use the <i>Setu Bill Payments MCP</i>.</li>
<li>For code level agents go to Get Started - <a href="https://billpay-mcp.setu.co/login" target="_blank" rel="noreferrer">Setu Bill Payments</a>.</li>
<li>Generate token using a mobile number.
<MainImage src="https://storage.googleapis.com/strapi-assets/latest/MCP_for_bill_payment/cursor-authentication.png" alt="Cursor Authentication successful" /></li>
<li>Use token fetch API to get token.</li>
<MainImage src="https://storage.googleapis.com/strapi-assets/latest/MCP_for_bill_payment/cursor-token-fetch.png" alt="Cursor Token Fetch"/>
<li>Use this token to call the /mcp endpoints for tools and no need to implement OAuth user redirect implementation.</li>
</ol>

Claude / ChatGPT and other GUI clients will always implement that OAuth redirect to remote auth service implementations so Client ID or Secret is not to be used there.

You are ready!

### Using the MCP

ℹ️ To use any “tool”, a service of the MCP, the LLM client (ChatGPT or Claude) will ask you permission to allow to access that tool of the MCP. Please select “Always Allow” for a seamless experience. Currently, all LLM clients ask this permission for the first time each tool is used.
Expand Down
74 changes: 74 additions & 0 deletions content/payments/billpay/mcp/tools-and-prompts.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,74 @@
---
sidebar_title: Tools and Prompts
page_title: MCP for Bill Payments - Tools and Prompts
order: 2
visible_in_sidebar: true
---

## Agentic Bill Payments MCP Server

The Agentic Bill Payments MCP exposes a set of tools that let an AI agent help you discover bills, fetch amounts, pay bills, and track transactions using natural language. Check out our <a href="/payments/billpay/mcp/integration-guide" target="_blank" rel="noreferrer">integration guide</a> on how to integrate this seamlessly.

You don't need to know which tool exists. Just ask naturally. If you're building or testing agents, the mapping below shows how prompts translate to tools.

## Tools

| Tool name | Tool Description | Tool specific prompt |
|-----------|------------------|---------------------|
| List Billers | Shows which billers are supported. | "Is my electricity provider supported?" |
| List Categories | Shows the types of bills you can pay. | "What kinds of bills can I pay here?" |
| Get Saved Bills | Shows the bills you've already paid for once. | "Do I have any pending bills?" |
| Fetch Bill | Fetches the latest amount due for a bill. | "How much is my Credit Card bill?" |
| Pay Bill | Initiates payment for a bill after confirmation. | "I want to recharge my FASTag account with Rs.500." |
| Check Payment Status | Checks whether a payment attempt was successful. | "Did my last payment go through?" |
| Get Transaction Receipt | Provides a receipt for a completed payment. | "Show me the receipt for my last payment." |
| List Payment History | Shows your past bill payments. | "Show all my bill payments from last 3 months." |

## Sample Prompts

You can use these prompts directly, and the Agent will know which tool to invoke. For the first time, you might have to allow the Agent to call the tool. These prompts automatically trigger multiple actions behind the scenes.

### Bill Payments

Use these to fetch bills, make payments, and track transaction status quickly and securely.

**Examples:**

- "Can I pay my electricity bill/broadband bill here?"
- "What kinds of bills can I pay here?"
- "Do I have any bills due?"
- "Pay my electricity bill."
- "I live in Chennai. I want to pay my electricity bill"
- "Did I pay my Credit Card bill this month? Share payment details"

You can also upload the image of your physical bill or screenshots of your bills from your payments app and watch the Agent fetch your outstanding bills!

### Analysis and Insights

Use these to understand why your bills look the way they do, and generate customised insights for you.

**Examples:**

- "Show me all the bills I usually pay."
- "Why was my electricity bill higher this summer?"
- "Summarise my bill payments from last month."
- "Show a breakdown of my bill spends by category."
- "Which bills do I spend the most on?"

### Proactive & Preventive Prompts

Use these to stay ahead of bills before they become urgent.

**Examples:**

- "Do I have any bills due in the next 7 days?"
- "Which bills usually come up around this time of the month?"

### Planning & Control Prompts

Use these to plan and budget.

**Examples:**

- "How much should I budget for bills every month?"
- "Which of my bills are fixed and which vary?"