Folderr MCP Server

A Model Context Protocol (MCP) server that provides tools to interact with Folderr's API, specifically for managing and communicating with Folderr Assistants.

Installation

Add to your MCP Settings

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

Features

The server provides the following tools:

Authentication

Two methods of authentication are supported:

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" } }
API tokens can be generated from 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 the authenticated user.
Ask Assistant
{ "name": "ask_assistant", "arguments": { "assistant_id": "assistant-id", "question": "Your question here" } }
Send a question to a specific assistant and receive their response.

Configuration

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

Base URL for the Folderr API
Authentication token (from login or API key)

Error Handling

The server provides detailed error messages for common scenarios:

Authentication failures
Invalid requests
API errors
Network issues

Development

To 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 Flow

Either:
- Use the login tool with email and password
- Use the set_api_token tool with an API token from Folderr's developers section
The authentication token is automatically saved and used for subsequent requests
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
"Failed to list assistants": Error retrieving assistant list
"Failed to ask assistant": Error sending question to assistant