Folderr

🚀 Folderr MCP Server

A Model Context Protocol (MCP) server that provides tools to interact with the Folderr API, primarily used for managing and communicating with Folderr assistants.

🚀 Quick Start

This server offers tools for interacting with the Folderr API and managing Folderr assistants.

📦 Installation

Add the following to your MCP settings:

{
  "mcpServers": {
    "folderr": {
      "command": "npx",
      "args": ["-y", "@folderr/folderr-mcp-server"]
    }
  }
}

✨ Features

The server provides the following tools:

Authentication

It supports two authentication methods:

Login with Email/Password

{
  "name": "login",
  "arguments": {
    "email": "user@example.com",
    "password": "your-password"
  }
}

API Token Authentication

{
  "name": "set_api_token",
  "arguments": {
    "token": "your-api-token"
  }
}

The API token can be generated in the Folderr developers section. This method is recommended for automated or long - running processes.

Assistant Management

List Assistants

{
  "name": "list_assistants",
  "arguments": {}
}

Returns a list of all available assistants for authenticated users.

Ask an Assistant

{
  "name": "ask_assistant",
  "arguments": {
    "assistant_id": "assistant-id",
    "question": "Your question here"
  }
}

Sends a question to a specific assistant and gets its response.

📚 Documentation

Configuration

The server stores configuration in the config.json file, which includes:

• The base URL of the Folderr API
• Authentication tokens (from login or API keys)

Error Handling

The server provides detailed error messages for common scenarios:

• Authentication failure
• Invalid requests
• API errors
• Network issues

Development

Build the server:

npm install
npm run build

Usage in MCP Settings

Add the following to your MCP settings configuration:

{
  "mcpServers": {
    "folderr": {
      "command": "node",
      "args": ["/path/to/folderr-server/build/index.js"]
    }
  }
}

Authentication Process

1. Either:
   • Use the login tool to log in with email and password.
   • Use the set_api_token tool to set the API token (from the Folderr developers section).
2. The authentication token is automatically saved and used for subsequent requests.
3. All assistant - related tools require authentication before use.

Error Messages

Common error messages and their meanings:

• "Not logged in": No authentication token is set.
• "Login failed": Invalid credentials.
• "Unable to list assistants": Error retrieving the assistant list.
• "Unable to ask an assistant": Failed to send a question to the assistant.