What is Folderr Mcp Server

folderr-mcp-server is a Model Context Protocol (MCP) server designed to facilitate interaction with Folderr’s API, specifically for managing and communicating with Folderr Assistants.

Use cases

Use cases include automating responses to user queries through assistants, managing multiple assistants for different tasks, and integrating Folderr’s capabilities into larger software solutions.

How to use

To use folderr-mcp-server, add it to your MCP settings by including the specified command and arguments in your configuration. You can authenticate using either email/password or API token methods.

Key features

Key features include authentication via email/password or API token, assistant management functions such as listing available assistants and asking questions, and detailed error handling for various scenarios.

Where to use

folderr-mcp-server is suitable for applications that require interaction with Folderr Assistants, such as customer support systems, virtual assistants, and automation tools.

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:

1. Login with Email/Password

   {
     "name": "login",
     "arguments": {
       "email": "[email protected]",
       "password": "your-password"
     }
   }
   

2. 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

1. List Assistants

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

   Returns a list of all available assistants for the authenticated user.

2. 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

1. Either:
   • Use the login tool with email and password
   • Use the set_api_token tool with an API token from Folderr’s 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
• “Failed to list assistants”: Error retrieving assistant list
• “Failed to ask assistant”: Error sending question to assistant