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.

139 changes: 139 additions & 0 deletions content/payments/billpay/mcp/integration-guide.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,139 @@
---
sidebar_title: Integration Guide
page_title: MCP for Bill Payments - Integration Guide
order: 1
visible_in_sidebar: true
---

## MCP for Bill Payments 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.

### ChatGPT

Ensure you have a ChatGPT Plus or a higher upgrade account.

1. **Enable Developer Mode**
<ol type="a">
<li>Browse over to Settings under the Profile section.</li>
<li>Under Apps and Connectors, scroll down to Advance Settings and expand.</li>
<li>On expanding it, you will see an option to enable Developer Mode.</li>
<li>Once enabled, you will observe an orange highlight on your chat inputs.</li>
</ol>
2. **Add the MCP**
<ol type="a">
<li>Once the Developer mode is enabled, go to Apps and Connectors.</li>
<li>Click on Create at the top right.</li>
<li>Add a name for the Setu MCP — say, <i>Setu Bill Payments MCP</i>.</li>
<li>In the URL field, add <a href="https://billpay-mcp.setu.co/mcp" target="_blank" rel="noreferrer">https://billpay-mcp.setu.co/mcp</a>.</li>
<li>Under Authentication, select OAuth; check the consent box, and confirm.</li>
</ol>
3. **Verify your phone number with an OTP**
<ol type="a">
<li>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.</li>
</ol>
4. **Start Chatting!**
<ol type="a">
<li>You can also instruct GPT to only use the <i>Setu Bill Payments MCP</i> on the chat window, by clicking on the plus icon and adding the MCP to your chat.</li>
<li>It is not mandatory to do so, but could help in some scenarios.</li>
</ol>

**You are ready!**

**_With this you are ready to now fetch your bills, pay your bills, analyse your payment history, ask your LLM agent to analyse your bills, and more._**

### Claude

Ensure you have at least a Claude Pro account, and installed a Claude Desktop.

1. **Install Claude Desktop**
<ol type="a">
<li>Follow the steps on <a href="https://www.claude.com/download" target="_blank" rel="noreferrer">Download Claude</a> to download the relevant desktop version for your system.</li>
<li>Install the application by clicking continue and complete the installation successfully.</li>
</ol>
2. **Adding the MCP**
<ol type="a">
<li>Open Claude Desktop, and under Profile, go to Settings, and click on Connectors.</li>
<li>Click on “Custom Connector”.</li>
<li>Enter the MCP name - <i>Setu Bill Payments MCP</i>, and the MCP URL <a href="https://billpay-mcp.setu.co/mcp" target="_blank" rel="noreferrer">https://billpay-mcp.setu.co/mcp</a>.</li>
</ol>
3. **Start Chatting!**
<ol type="a">
<li>You can also instruct Claude to only use the <i>Setu Bill Payments MCP</i> on the chat window, by clicking on the plus icon and adding the MCP to your chat.</li>
<li>It is not mandatory to do so, but could help in some scenarios.</li>
</ol>

**You are ready!**

### Perplexity

1. Install Perplexity for Mac.
2. Go to settings on bottom left .
3. Click connectors
4. Follow Perplexity instruction to download and install additional package
5. click on Add Connector
6. Go to Advanced and paste the following:

<CodeBlockWithCopy language="json">{`
{
"args" : [
"mcp-remote",
"https://billpay-mcp.setu.co/mcp"
],
"command" : "npx",
"env" : {
},
"useBuiltInNode" : true
}
`}</CodeBlockWithCopy>

7. On saving, you will be taken to a page to enter your phone number and OTP. All bill payments require a phone number to fetch bills.

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.<br/><img src="/assets/payments/billpay/mcp/image-20251126-103200.png" alt="OTP verification"/></li>
<li>Use token fetch API to get token.<br/><img src="/assets/payments/billpay/mcp/image-20251126-103532.png" alt="Token fetch"/></li>
<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.

Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.