Folderr MCP Server

View original on GitHub 

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": "user@example.com",
       "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