# Vings External API

> Readonly API and MCP access to your Vings financial intelligence platform data.

## Docs

- [Get v1banksstatus](https://docs.vin.gs/api-reference/banks/get-v1banksstatus.md)
- [Get v1budgetscategories](https://docs.vin.gs/api-reference/budgets/get-v1budgetscategories.md)
- [Get v1budgetssummary](https://docs.vin.gs/api-reference/budgets/get-v1budgetssummary.md)
- [Get v1cashflowsummary](https://docs.vin.gs/api-reference/cashflow/get-v1cashflowsummary.md)
- [Get health](https://docs.vin.gs/api-reference/health/get-health.md)
- [Get ready](https://docs.vin.gs/api-reference/health/get-ready.md)
- [Get mcp](https://docs.vin.gs/api-reference/mcp/get-mcp.md): MCP requires JSON-RPC POST requests
- [Post mcp](https://docs.vin.gs/api-reference/mcp/post-mcp.md): JSON-RPC 2.0 transport for the Vings readonly MCP server.
- [Get well knownoauth protected resource](https://docs.vin.gs/api-reference/oauth/get-well-knownoauth-protected-resource.md)
- [Get well knownoauth protected resourcemcp](https://docs.vin.gs/api-reference/oauth/get-well-knownoauth-protected-resourcemcp.md)
- [Get v1portfolio](https://docs.vin.gs/api-reference/portfolio/get-v1portfolio.md)
- [Get v1portfoliohistory](https://docs.vin.gs/api-reference/portfolio/get-v1portfoliohistory.md)
- [Get v1preferences](https://docs.vin.gs/api-reference/preferences/get-v1preferences.md)
- [Get v1spendingcategories](https://docs.vin.gs/api-reference/spending/get-v1spendingcategories.md)
- [Get v1spendingmerchantstop](https://docs.vin.gs/api-reference/spending/get-v1spendingmerchantstop.md)
- [Get v1spendingsummary](https://docs.vin.gs/api-reference/spending/get-v1spendingsummary.md)
- [Get v1recurring payments](https://docs.vin.gs/api-reference/transactions/get-v1recurring-payments.md)
- [Get v1transactions](https://docs.vin.gs/api-reference/transactions/get-v1transactions.md)
- [Get v1me](https://docs.vin.gs/api-reference/user/get-v1me.md)
- [Authentication](https://docs.vin.gs/external/docs/authentication.md): Bearer tokens, personal access tokens, OAuth discovery, and Vings scopes.
- [Introduction](https://docs.vin.gs/external/docs/introduction.md): Overview of the Vings External API — base URL, surfaces, and OpenAPI.
- [MCP](https://docs.vin.gs/external/docs/mcp.md): JSON-RPC transport, tools, schemas, and local testing with MCP Inspector.
- [Personal dashboards](https://docs.vin.gs/external/docs/personal-dashboards.md): Connect v0, Lovable, or your own app to the Vings External API with owner-only OAuth.

## OpenAPI Specs

- [openapi](https://external.vin.gs/api/openapi.json)