Bulkpe MCP Integration Docs

Bulkpe MCP

Does More Than You Think

Integrate payouts, collections, verifications and interpret the data the way you can imagine directly into your AI agents and workflows via the Model Context Protocol.

Unlimited Use Case
Complete Control
Plug & Play Anywhere
Understanding MCP
What is MCP?
A simple explanation of the protocol and how Bulkpe uses it.
🔌
MCP - Model Context Protocol
MCP is an open standard that lets AI assistants (like Claude, Cursor, or your own agent) connect to external tools and services - just like USB lets your computer talk to any device.

Instead of writing custom API code, your AI simply "plugs in" to an MCP server and gets instant access to all its capabilities through natural language.
💚
What Bulkpe MCP Does
Bulkpe MCP gives your AI assistant the power to handle and interpret payments - right from the chat. No code. No dashboards. Your AI can:

✅ Check wallet balance & transaction history
✅ Create payment links, UPI QRs & VPAs
✅ Verify bank accounts, PAN & GST
✅ Track payouts, pay bills
✅ Analyse and share insights
✅ Create graphs and project

What you can do
Capabilities at a Glance
All tools available via natural language through any MCP-compatible AI client.
💸
Payouts & Balance
Check live wallet balance, fetch payout status, and query full transaction history with date and mode filters.
🔗
Collections
Create static VPAs for recurring collections, dynamic QR codes for one-time payments, and PG payment links.
📄
Bill Payments
Fetch due bill payment transactions with category and status filters across all supported billers.
✅
Verification & KYC
Verify bank accounts (penny drop + pennyless), validate IFSC codes, verify PAN, and check GST registration.
See it in Action
Example Usage
Here's what it looks like when an AI assistant uses Bulkpe MCP.
You say
"Check my Bulkpe wallet balance and show my last 5 transactions"
The AI assistant / agent will
  • 🔍 Call fetch_balance & get_statement to get your data
  • 📊 Format the balance and transaction list into a clean summary
  • 💬 Reply with your balance and a table of your last 5 transactions
You say
"How many payments we have made for XYZ vendor and give it to in a graph"
The AI assistant / agent will
  • 🪪 Check and collect all the data from Bulkpe Server
  • 🏢 Start preparing the report with a nice table
  • ✅ Reply you with an insightful graph
You say
"Create a payment link for ₹2,500 for invoice INV-2024-042"
The AI assistant / agent will
  • 🔗 Call create_pg_link with amount ₹2,500 and reference INV-2024-042
  • 📦 Receive the hosted payment link from Bulkpe
  • 💬 Reply with the shareable payment link ready to send via WhatsApp, email or SMS
Get Started in Seconds
Setup
Connect your AI assistant to Bulkpe in one step.
⚡ Add this JSON to your AI client's MCP config 
{
  "mcpServers": {
    "bulkpe": {
      "url": "https://mcp.bulkpe.in/sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}
Replace YOUR_API_TOKEN with your Bulkpe API key. That's it - your AI can now access all Bulkpe tools instantly.
Step-by-Step Guide
How to Set Up in Claude AI
Follow these steps to connect Bulkpe MCP to Claude Desktop.
01
Open Claude Desktop
Launch the Claude Desktop app on your computer. Make sure you have the latest version installed from claude.ai/download.
02
Open Settings
Click on the Claude menu in the top-left corner and select Settings, or press Cmd + , (Mac) / Ctrl + , (Windows).
03
Go to Developer → Edit Config
In Settings, click on Developer in the left sidebar, then click the Edit Config button. This opens the claude_desktop_config.json file.
04
Paste the Bulkpe MCP Config
Copy the JSON config from the Setup section above and paste it into the config file. Replace YOUR_API_TOKEN with your actual Bulkpe API key.
05
Save & Restart Claude
Save the config file and restart Claude Desktop. You should see a 🔌 icon or a tools indicator showing Bulkpe is connected.
06
Start Using Bulkpe via Chat
That's it! Try asking: "What's my Bulkpe balance?" or "Have I paid my warehouse electricity bill?" - Claude will automatically use the right Bulkpe tool.
API Reference
Tool Reference
Click any tool to expand parameters and see example usage.
Account & Payouts
Collections
Bill Payments
Verification
GET fetch_balance Check wallet balance ▼
Returns the current available balance in your Bulkpe wallet. No parameters needed. Use to check available funds before initiating payouts.
Parameters

No parameters required.


Example Prompt
// Ask your AI agent:
"What is my current Bulkpe wallet balance?"
"Do I have enough funds to send ₹50,000?"
GET fetch_status Payout transaction status ▼
Fetch the status of a specific payout transaction using its Bulkpe transaction ID or reference ID. Returns current status (SUCCESS / PENDING / FAILED) and metadata.
Parameter Type Required Description
transaction_id string OPTIONAL Bulkpe internal transaction ID
reference_id string OPTIONAL Your own reference ID passed during payout creation. One of transaction_id or reference_id is required.
Example Prompt
// Ask your AI agent:
"Check status of payout with reference ID REF20240312001"
"What happened to transaction TXN98765?"
GET get_statement Account statement / passbook ▼
Retrieve a paginated list of all debit and credit transactions from your Bulkpe account. Supports filtering by date range, payment mode, status, transaction type, and virtual account.
Parameter Type Required Description
limit number REQUIRED Number of records per page
page number REQUIRED Page number (starts at 1)
fromDate string OPTIONAL Start date filter (YYYY-MM-DD)
toDate string OPTIONAL End date filter (YYYY-MM-DD)
type enum OPTIONAL DEBIT | CREDIT
status enum OPTIONAL SUCCESS | PENDING | FAILED
paymentMode enum OPTIONAL IMPS | NEFT | RTGS | UPI
vaId string OPTIONAL Filter by virtual account ID
connectedAccountNumber string OPTIONAL Filter by connected bank account number
Example Prompt
// Ask your AI agent:
"Show me all failed payouts from last week"
"Get my NEFT credits from 2024-03-01 to 2024-03-12"
"Fetch last 20 transactions from my Bulkpe account"
POST create_static_vpa Fixed VPA for recurring collections ▼
Creates a permanent Virtual Payment Address (VPA) that customers can pay to repeatedly. Ideal for subscriptions, invoices, and merchant checkout flows where the same address is reused.
Returns a static VPA string and QR code. Payments to this VPA are automatically routed to your Bulkpe wallet.
Example Prompt
"Create a static UPI VPA for collecting monthly subscription fees"
"Set up a permanent payment address for my store checkout"
POST create_dynamic_vpa One-time QR / VPA for specific amount ▼
Generates a single-use UPI QR code or VPA pre-loaded with a specific transaction amount. Perfect for invoice payment links, order checkout, and one-time collection requests. Expires after successful payment.
Each dynamic VPA is single-use. Generate a new one for each order/invoice.
Example Prompt
"Generate a payment QR for ₹1,499 for order #ORD-4521"
"Create a one-time UPI link for collecting ₹25,000"
POST create_pg_link Payment gateway link ▼
Creates a hosted payment gateway link that can be shared with customers via WhatsApp, email, or SMS. Supports UPI, cards, and netbanking. No frontend integration required.
Example Prompt
"Create a payment link for ₹5,000 for invoice INV-2024-101"
"Generate a PG link to collect payment from a customer"
GET list_routing_transactions All UPI routing transactions ▼
Fetches a paginated list of all inbound UPI routing transactions across all channels: Payment Gateway (PG), Static VPA, Dynamic VPA, and UPI Collect. Use query filters to drill into specific flows.
Parameter Type Required Description
limit number REQUIRED Records per page
page number REQUIRED Page number
vpa_reference_id string OPTIONAL Static VPA reference ID
vpa_id string OPTIONAL Bulkpe static VPA transaction ID
order_id string OPTIONAL Bulkpe dynamic VPA order ID
collection_order_id string OPTIONAL Bulkpe UPI Collect order ID
transaction_id string OPTIONAL Bulkpe transaction ID
reference_id string OPTIONAL Dynamic VPA or UPI collect reference ID
pg_order_id string OPTIONAL Bulkpe PG order ID
Example Prompt
"Show all UPI routing transactions for PG order PG-ORD-9901"
"Find the payment that came in on dynamic VPA order DYN-4412"
"List last 50 routing transactions across all channels"
GET list_bbps_transaction BBPS bill payment history ▼
Returns a paginated list of all Bharat Bill Payment System (BBPS) transactions. Filter by biller category (electricity, gas, water, etc.) and status to reconcile bill payments programmatically.
Parameter Type Required Description
limit number REQUIRED Records per page
page number REQUIRED Page number
category string OPTIONAL Biller category (e.g. ELECTRICITY, GAS, BROADBAND)
status enum OPTIONAL SUCCESS | PENDING | FAILED
Example Prompt
"Show all failed BBPS electricity bill payments"
"List my last 10 bill payments"
"Get all pending BBPS transactions"
POST bank_verification Penny drop bank account verification ▼
Verifies a bank account by depositing Re. 1 (penny drop) and retrieving the registered account holder name as per bank records. Use before initiating large payouts to prevent failed transfers.
Costs one penny per verification. Use pennyless_verification for a free (no-debit) alternative.
Example Prompt
"Verify bank account 1234567890 with IFSC SBIN0001234"
"Do a penny drop verification for this vendor's bank account"
POST pennyless_verification Pennyless bank account verification ▼
Verifies a bank account using account number and IFSC code without debiting any amount. Returns account holder details. Faster and free compared to penny drop. Preferred for high-volume KYC flows.
Parameter Type Required Description
account_number string REQUIRED Bank account number to verify
ifsc string REQUIRED IFSC code of the bank branch
Example Prompt
"Verify account 9876543210 IFSC HDFC0001234 without penny drop"
"Do a pennyless KYC check on this bank account"
GET validate_ifsc IFSC code validation ▼
Validates an IFSC code and returns the associated bank name, branch name, address, city, and state. Use to pre-validate beneficiary details before payouts.
Parameter Type Required Description
ifsc string REQUIRED 11-character IFSC code (e.g. HDFC0001234)
Example Prompt
"Is IFSC SBIN0001234 valid? Which branch is it?"
"Look up bank details for IFSC ICIC0000001"
POST verify_pan PAN card verification ▼
Verifies a PAN card and returns the holder's name, date of birth, and Aadhaar linkage status. Essential for KYC flows, onboarding vendors, and GST compliance checks.
Parameter Type Required Description
pan string REQUIRED 10-character PAN number (e.g. ABCDE1234F)
Example Prompt
"Verify PAN ABCDE1234F and tell me the holder's name"
"Is this PAN linked to Aadhaar? PQRST5678G"
POST verify_gst GST registration verification ▼
Verifies a GSTIN and returns the registered business name, registration status, business type, and state. Use for B2B vendor onboarding, invoice validation, and compliance automation.
Parameter Type Required Description
gstin string REQUIRED 15-character GSTIN number
Example Prompt
"Verify GST number 29ABCDE1234F1Z5"
"Is this vendor's GSTIN active? Check 27PQRST5678G1Z3"
Data Types
Common Response Schema
Standard fields returned across most Bulkpe MCP tool responses.
{
  "status":     "SUCCESS" | "PENDING" | "FAILED"
  "message":    string          // human-readable result
  "data":       object | array  // tool-specific payload
  "page":       number          // current page (paginated tools)
  "limit":      number          // records per page
  "total":      number          // total matching records
}

Payment Modes
IMPS  → Instant (24x7, up to ₹5L)
NEFT  → Batch settlements
RTGS  → High-value (₹2L+)
UPI   → Real-time UPI rails
Transaction Types
DEBIT   → Money sent out
CREDIT  → Money received in