akoya-mcp-server-demo

akoya-mcp-server-demo

0

Akoya MCP Server is designed to facilitate access to personal finance data using the Model Context Protocol. It allows easy setup and integration with Claude Desktop, providing sandbox accounts for testing and development.

Akoya MCP Server

How to Build

  1. Install Node.js version 22 or greater. Check version with node --version.
  2. Run cd sdk && npm install to go to the SDK folder and build the SDK.
  3. Now run cd ../mcp-server && npm install to go to the server folder and build the server.

How to Run

If you are not familiar with how to setup MCP Servers with Claude Desktop, see this tutorial first.

Now add something like this to your Claude Desktop config:

{
  "mcpServers": {
    "Akoya": {
      "command": "node",
      "args": ["[YOUR-PATH-HERE]/akoya-mcp-server-main/mcp-server/dist/index.js"],
      "env": {
        "AKOYA_AP_IS_V_2_4_0_LIB_ACCESS_TOKEN": "[YOUR-ACCESS-TOKEN-HERE]"
      }
    }
  }
}

A claude_desktop_config.json file is also provided as reference.

Make sure to set the path to the location where your MCP Server is stored as well as the access token you got after authenticating.

How to Get Access Token

Follow this guide to see how to get the access token to the Mikomo bank sandbox for Akoya.

Usage Tips

  • See here for a list of sandbox accounts. For best results, try this personal finance account or this lending and credit account.
  • Make sure to specify the date range you want when you are using the MCP Server in chat. The available date ranges are given for each account in the Akoya docs linked above.
  • Username and password are always the same, for example the lending account has Username: GenericUser_LendingAndCredit and Password GenericUser_LendingAndCredit.