API reference

POST /public/v1/mcp

/public/v1/mcp is the Credicorp MCP server — a Model Context Protocol endpoint that lets an AI agent read public business-lending facts through six read-only tools. The server identifies as Credicorp v1.0.0 on protocol revision 2025-06-18. POST handles JSON-RPC calls; GET returns the server card so a client can inspect capabilities before connecting.

2 min read

6 toolsAll read-only, public
2025-06-18MCP protocol revision
CredicorpServer name, v1.0.0

What it does

This endpoint sits on the public /public/v1 ring — unauthenticated, anonymous and open to any caller. There is no API key and no OAuth token on this ring; the trust boundary is enforced by rate limiting, strict input validation and a server-fixed response shape rather than by a credential.

The MCP endpoint exposes Credicorp’s public business-lending knowledge to AI agents through the Model Context Protocol. Every tool is read-only — the server can describe products, criteria and quotes, but it never writes, applies or moves money. POST carries JSON-RPC requests (initialize, tools/list, tools/call); a plain GET returns the server card with the protocol revision, server identity and a summary of the available tools.

The six tools

FieldTypeRequiredNotes
ListProductsreadList the lending products: Business Loan, Credicorp Flex, Credicorp Slice.
ProductDetailsreadFull detail on one product by name.
GetQuotereadAn indicative quote for a stated amount and term.
EligibilityCriteriareadThe baseline criteria a business must meet.
HowToApplyreadThe application steps and what to prepare.
LoyaltyTiersreadThe loyalty ladder and per-tier benefit (mirrors the loyalty-tiers endpoint).

Inspect the server card

curl -sS -X GET \
  https://hub.credicorp.co.uk/public/v1/mcp \
  -H 'Accept: application/json'

The card returns protocolVersion, the server name/version, its capabilities and a name+description summary of each tool. The full input schemas come from a live tools/list call.

Call a tool

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":1,"method":"tools/call","params":{"name":"ListProducts","arguments":{}}}'

Frequently asked questions

Can the MCP server take an action, like starting an application?

No. Every tool is read-only. The server can tell an agent how to apply and what a quote might look like, but it cannot submit an application or move money — those stay off the public ring entirely.

Which MCP protocol revision does it speak?

Revision 2025-06-18. Point a compliant MCP client at the endpoint and it will negotiate on initialize; a plain GET returns the server card if you want to inspect capabilities first.

How do I discover the tool input schemas?

The GET server card gives you a name and description per tool. For the full input schemas, issue a tools/list JSON-RPC call over POST.

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.