CreditcorpDev
API reference

MCP tool: LoyaltyTiers

LoyaltyTiers is a read-only MCP tool on the Credicorp MCP server that returns the four-tier loyalty ladder — the same vocabulary and per-tier arrangement-fee discount served by GET /public/v1/loyalty/tiers, delivered through the Model Context Protocol so an AI agent can read it as a tool call.

2 min read

read-onlyNever writes
4 tiersBronze → Platinum
mirrorSame data as the REST endpoint

What it does

LoyaltyTiers lets an agent connected to the Credicorp MCP server read the loyalty ladder without calling REST directly. It returns the same figures as GET /public/v1/loyalty/tiers: the four tiers in order, their thresholds, and the arrangement-fee discount in percent units.

Call it

curl -sS -X POST \
  https://hub.credicorp.co.uk/public/v1/mcp \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":7,"method":"tools/call","params":{"name":"LoyaltyTiers","arguments":{}}}'

When to use the tool vs the REST endpoint

Use the MCP tool when an AI agent is the consumer and you want the model to discover and call it as part of a tool set. Use the REST endpoint when a page or service needs the ladder directly. Both read the same config, so they never disagree.

Frequently asked questions

Is the tool data the same as the REST endpoint?

Yes. LoyaltyTiers reads the same loyalty config as GET /public/v1/loyalty/tiers, so the tiers, thresholds and discounts match exactly.

Can this tool change a customer’s tier?

No. Like every tool on the Credicorp MCP server it is strictly read-only. It reports the ladder; it never modifies anyone’s standing.

Funding for UK limited companies

Credicorp lends to your company, not to you personally — short-term working capital with no personal guarantee. See what your business could access.

Explore business loans Apply now