Developer Portal

FinHub API

Interactive Swagger UI for the FinHub REST API. Manage clients, products, subscriptions, billing models, usage, and e-mandate operations.

View API Reference →

Coming Soon

FinSys Lender API

Lender API for managing loan applications, programs, and webhook delivery. Documentation will be proxied from finsys-api.

Coming Soon

FinSys Borrower API

Borrower-facing API for loan applications and document submission. Documentation will be proxied from finsys-api.

MCP

Connect via MCP

FinHub exposes an MCP server at /api/v1/mcpover Streamable HTTP (JSON-RPC 2.0). Tools are scoped by user type — company users get management tools, client users get self-service tools.

Discovery: /.well-known/mcp.json

Claude Desktop

Claude Desktop / Cursor

Add this to your MCP client configuration. OAuth login will open in your browser automatically.

          {
  "mcpServers": {
    "finhub": {
      "url": "https://finhub.finhero.asia/api/v1/mcp"
    }
  }
}

Claude Code

Add to your ~/.claude.jsonor project .mcp.json:

          {
  "mcpServers": {
    "finhub": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-remote",
        "https://finhub.finhero.asia/api/v1/mcp"]
    }
  }
}

OAuth 2.1

MCP Authentication

MCP clients use OAuth 2.1 Authorization Code + PKCE. When you connect, your MCP client opens a browser where you log in with your FinHub credentials. Tokens refresh automatically.

Access tokens: 8 hours • Refresh tokens: 30 days

REST API

REST API Authentication

For direct REST API access, POST to /api/v1/loginwith your email and password to get a JWT bearer token (24h expiry).

          curl -X POST /api/v1/login \
  -H "Content-Type: application/json" \
  -d '{"email":"...","password":"..."}'

FinHubDeveloper Portal

API Documentation