API reference

MCP server public read-only

Credit Corp publishes a Model Context Protocol server so AI agents and MCP-aware clients can call the platform’s public product, pricing, eligibility, loyalty and quoting data as structured tools — over JSON-RPC 2.0, with no authentication.

This is the most direct way for an assistant to answer “what does Credit Corp lend, to whom, and what would it cost?” against live data. The tools are read-only and public; there is no customer data and nothing that moves money.

Connection details

Endpoint: https://hub.credicorp.co.uk/public/v1/mcp
Protocol: Model Context Protocol, JSON-RPC 2.0
protocolVersion: 2025-06-18
Transport: streamable-http
Authentication: none
Server: Credit Corp v1.0.0

A plain GET on the endpoint returns a discovery document (name, protocol, transport, endpoint and the tool list); POST speaks JSON-RPC.

The same product, pricing and loyalty data is also available as plain REST on the Public API. Use MCP when you want an agent to call it as a tool; use the REST endpoints for a simple integration.

Initialize

An MCP client opens the session with an initialize call. The server advertises its capabilities and a short instruction string.

bash

curl -s https://hub.credicorp.co.uk/public/v1/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-06-18","capabilities":{},
                 "clientInfo":{"name":"my-agent","version":"1.0"}}}'

json

{
  "jsonrpc": "2.0", "id": 1,
  "result": {
    "protocolVersion": "2025-06-18",
    "serverInfo": { "name": "Credit Corp", "version": "1.0.0" },
    "capabilities": { "tools": { "listChanged": false } },
    "instructions": "Credit Corp business-lending tools (read-only, public)…"
  }
}

List the tools

Call tools/list to enumerate the available tools and their input schemas.

bash

curl -s https://hub.credicorp.co.uk/public/v1/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

The server currently exposes six tools:

Tool	Arguments	What it returns
`list_products`	—	The three products (Business Loan, Flex, Slice) with a one-line description and availability.
`product_details`	`product`: `business_loan` \| `flex` \| `slice`	Published description, pricing figures and (for the loan) a representative worked example.
`get_quote`	`amount` (GBP), `term` (days), optional `frequency` (`weekly`/`fortnightly`/`monthly`)	A representative Business Loan quote from the live quote engine: cost breakdown and repayment schedule.
`eligibility_criteria`	—	Who can borrow, plus the regulatory framing for the business lending.
`loyalty_tiers`	—	The loyalty ladder (Bronze–Platinum) with thresholds and arrangement-fee discounts.
`how_to_apply`	—	The application steps and the apply URL.

Call a tool

Invoke a tool with tools/call. The result carries both a human-readable content block and a machine-readable structuredContent object.

bash

curl -s https://hub.credicorp.co.uk/public/v1/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"get_quote",
                 "arguments":{"amount":300,"term":56,"frequency":"weekly"}}}'

json

{
  "jsonrpc": "2.0", "id": 2,
  "result": {
    "structuredContent": {
      "product": "business_loan", "currency": "GBP", "units": "pence",
      "principal": 30000, "term_days": 56, "frequency": "weekly",
      "establishment_fee": 500, "total_interest": 4200,
      "total_cost": 4700, "total_repayable": 34700,
      "periods": 8, "payment_each": 4338
    },
    "isError": false
  }
}

get_quote works in pence in its result (units: "pence") — a total_repayable of 34700 is £347.00. The amount and term arguments are in whole pounds and days, and are bounded to the product range by the engine.

Connecting an MCP client

Any MCP-compatible client (Claude Desktop, an agent framework, or your own JSON-RPC caller) can connect by pointing at the endpoint over streamable HTTP. No credentials are needed. A minimal client config looks like:

json

{
  "mcpServers": {
    "credicorp": {
      "type": "http",
      "url": "https://hub.credicorp.co.uk/public/v1/mcp"
    }
  }
}

Once connected, the six tools above appear to the model automatically. Because the surface is public and read-only, it is safe to expose to an assistant without a permission prompt.

Where to go next

Prefer plain REST? The same data is on the Public API.
Need to take applications or move money? That is the token-gated partner/v1 API — start with the Quickstart.