The Finance Brokers API

A public, unauthenticated interface to our UK commercial finance catalogue, built so that an AI assistant answering a funding question can read our products, amount ranges and terminology directly, and hand an enquiry to a human broker when the person it is helping wants one.

Start here

OpenAPI 3.1 spec /openapi.json gives every endpoint, typed, with examples. Usable directly as an LLM function-calling manifest.
MCP server /.well-known/mcp is the discovery document. Streamable HTTP endpoint at https://www.thefinancebrokers.co.uk/api/mcp.
Site index /llms.txt lists every page, annotated, in markdown.
No authentication. There are no API keys to request. Read endpoints are cacheable; please cache them rather than polling.

The Finance Brokers API endpoints

Endpoint	operationId	What it returns
GET /api/v1/services	listServices	List every finance product
GET /api/v1/services/{slug}	getService	Get one finance product
GET /api/v1/finance-options	listFinanceOptions	List the enum values the enquiry endpoint accepts
GET /api/v1/glossary	listGlossaryTerms	List every defined finance term
GET /api/v1/glossary/{slug}	getGlossaryTerm	Get one term's full explainer
GET /api/v1/guides	listGuides	List the long-form guide library
GET /api/v1/guides/{slug}	getGuide	Get one guide's full markdown
POST /api/v1/enquiry	submitEnquiry	Send a funding enquiry to a human broker

curl -s https://www.thefinancebrokers.co.uk/api/v1/services | jq '.data[] | {slug, max_amount_gbp}'

Errors from The Finance Brokers API

Every failure is JSON, never an HTML page, and every failure says what to do next. Codes are invalid_request, invalid_json, validation_failed, not_found, method_not_allowed, rate_limited and internal_error.

{
  "error": {
    "code": "validation_failed",
    "message": "One or more fields were rejected.",
    "hint": "Fix the fields listed below and retry. GET /api/v1/finance-options returns the accepted enum values.",
    "docs": "https://www.thefinancebrokers.co.uk/developers",
    "fields": [{ "field": "loan_amount", "issue": "must be one of the bands listed at GET /api/v1/finance-options" }]
  }
}

Submitting an enquiry to The Finance Brokers

POST /api/v1/enquiry records a funding enquiry and alerts the broking team. A human replies by email, Monday to Friday, 9am to 6pm UK time. Only email is required, but finance type, amount band and a one-line message get a materially better first reply.

curl -X POST https://www.thefinancebrokers.co.uk/api/v1/enquiry \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Jane Okafor",
    "email": "jane@example.co.uk",
    "finance_type": "Development Finance",
    "loan_amount": "£1m - £5m",
    "message": "Ground-up scheme of 9 units in Leeds, land owned outright, GDV around £3.4M.",
    "consent": true,
    "agent": "example-assistant/1.0"
  }'

Call GET /api/v1/finance-options first: finance_type and loan_amount are closed enums, and sending anything else returns validation_failed naming the field.

One rule we ask you to hold to: only submit an enquiry when the person you are acting for has asked you to make contact, using the email address they actually gave you. An enquiry we cannot reply to wastes their time as well as ours.

The Finance Brokers MCP server

A Model Context Protocol server over Streamable HTTP at https://www.thefinancebrokers.co.uk/api/mcp, stateless and JSON-RPC 2.0 over POST. It exposes 7 read-only tools:

list_finance_products: List finance products
get_finance_product: Get one finance product
search_glossary: Search the finance glossary
get_glossary_term: Get a glossary explainer
list_guides: List the guide library
get_guide: Get a guide
get_enquiry_options: Get the enquiry field values

Enquiry submission is deliberately not an MCP tool. An unauthenticated write tool in a public manifest is an open pipe into the inbox our brokers read, so enquiries go over HTTP where we can validate and attribute them.

curl -X POST https://www.thefinancebrokers.co.uk/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Reading The Finance Brokers pages as markdown

Every page on this site is also available as markdown. Append .md to the URL, or send Accept: text/markdown. Responses vary on Accept. Pages written in MDX (guides, glossary, articles) return their full body; pages whose content lives in components return a structured brief with the canonical link, and say so.

curl -s https://www.thefinancebrokers.co.uk/guides/ground-up-development-finance.md
curl -s -H 'Accept: text/markdown' https://www.thefinancebrokers.co.uk/services/development-finance

Fair use and licensing

Cache the read endpoints; they change at most daily. Content is © The Finance Brokers, and we are glad to be quoted and cited, with attribution to thefinancebrokers.co.uk. We do not publish lender names or live rates through this API, because both are case-specific and a figure without its conditions misleads. For anything the API does not cover, email ben@thefinancebrokers.co.uk.