FinHub API & MCP Documentation

POST 1. Get a JWT Token

All API and MCP requests require a Bearer token. Obtain one by logging in:

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

Response includes token (valid 24h) and type: "bearer".

REST 2. Use the REST API

Pass the token as a Bearer header on all requests:

curl /api/v1/subscriptions \
  -H "Authorization: Bearer <token>"

Two access levels:

• Company — /api/v1/* (manage clients, products, subscriptions, billing, usage search)
• Client — /api/v1/my/* (view own subscriptions, billing, forms)

MCP 3. Connect via MCP

FinHub exposes an MCP server over Streamable HTTP at:

POST /api/v1/mcp
Authorization: Bearer <token>
Content-Type: application/json

Protocol: JSON-RPC 2.0. Tools available depend on user type (company vs client).

Claude Code config:

{
  "type": "stdio",
  "command": "npx",
  "args": ["-y", "mcp-remote",
    "https://finhub.finhero.asia/api/v1/mcp",
    "--header",
    "Authorization: Bearer <token>"]
}