---
title: "Get started with the Fincanva Open API and MCP server"
description: "Make a first call to Fincanva: a REST request to list_allocation_methods with an API key, or an MCP client connected to the Fincanva MCP server with OAuth."
canonical_url: "https://fincanva.com/developers/get-started/get-started-with-the-fincanva-open-api-and-mcp-server"
last_updated: "2026-10-03"
md_url: "https://fincanva.com/developers/get-started/get-started-with-the-fincanva-open-api-and-mcp-server.md"
---

# Get started with the Fincanva Open API and MCP server

Fincanva’s operations are reachable two ways: as tools in an MCP client, or as REST endpoints your own code calls. This page takes you to a first call on each.

## How do you make a first REST call?

Send `POST` to `https://app.fincanva.com/api/v1/research/list_allocation_methods` with the JSON body `{}`: the operation takes no required parameter, so an empty object is a complete request. Authenticate with an API key, either as `Authorization: Bearer` followed by the key or in the `x-api-key` header.

The answer is the [result envelope](/developers/concepts/the-result-envelope): `status: true` and a `data` object whose `result` lists every allocation method Fincanva offers. Which plans include the Open API is in [Plans, quotas and limits](/developers/get-started/plans-quotas-and-limits).

## How do you connect an MCP client?

Add `https://app.fincanva.com/mcp` to an MCP client that connects to remote servers over Streamable HTTP. The client signs in with OAuth: the server tells it where, through the discovery documents [Authentication and API keys](/developers/open-api/authentication-and-api-keys) lists. Each operation then appears as a tool named by its operation id.

## Where do you go from here?

- [The Fincanva MCP server](/developers/mcp-server/the-fincanva-mcp-server) — the transport, the tools and what a client receives when it connects.
- [Authentication and API keys](/developers/open-api/authentication-and-api-keys) — every credential and what it may call.
- [Plans, quotas and limits](/developers/get-started/plans-quotas-and-limits) — which plans include each surface, and the monthly allowances.
- [The Reference](/developers/reference) — every operation, one page each.

Fincanva is for education and illustration only. It is not personalised financial advice, and past or simulated results do not predict future ones. [Read the Terms Addendum](https://fincanva.com/terms/addendum#section-3)