Toshl MCP Server

🚀 Toshl MCP Server

A Model Context Protocol (MCP) server for integrating Toshl Finance with AI agents.

🚀 Quick Start

The Toshl MCP Server serves as a bridge between AI agents and the Toshl Finance API. It enables AI agents to access Toshl's financial data, analyze it, and provide insights based on the data.

✨ Features

Read Access to Toshl API

• Toshl Finance: Allows reading data related to Toshl Finance.
• MCP Resources: Provides access to Toshl MCP resources.
• MCP Tools: Offers a set of tools for interacting with Toshl MCP.

MCP Resources

• Model Context Protocol Resources: Provides functions related to the model context protocol.
• Data Processing: Supports processing and analyzing Toshl data.

MCP Tools

• API Calls: Offers tools for interacting with the Toshl API.
• Data Conversion: Supports converting Toshl data into other formats for AI agents to use.

📦 Installation

Prerequisites

To run this server, you need the following environment:

1. Install Node.js (Recommended version: v14 or higher).
2. Install npm (Recommended version: 6 or higher).

Obtaining an API Token

To obtain a Toshl API token, follow these steps:

1. Visit the official Toshl website.
2. Log in to your account.
3. Go to the "My Apps" section.
4. Create a new application and obtain the API token.

Installation Steps

1. Clone this repository:

   git clone https://github.com/your-repository.git
   

2. Navigate to the repository directory:

   cd your-repository
   

3. Install dependencies:

   npm install
   

💻 Usage Examples

Configuration

Create a .env file and add the following content:

TOSHL_API_TOKEN=your_api_token_here

Running the Server

1. Build the project:

   npm run build
   

2. Start the server:

   npm start
   

📚 Documentation

Project Structure

The following is the project's file structure:

dist/                        # Compiled JavaScript files
.env                         # Environment variable file
.env.example                 # Example environment variable file
package.json                 # Project dependencies
tsconfig.json                # TypeScript configuration
src/
  └── main.ts               # Main program entry

Configuration

The server can be configured through the following environment variables:

• TOSHL_API_TOKEN: Your Toshl API token.
• NODE_ENV: Environment mode (Default: development).

📄 License

This project is licensed under the MIT license.