folderr

Folderr MCP Server exposes a set of tools to interact with Folderr's API, enabling authentication, assistant management, and message querying through MCP. The server is accessed via its MCP tools catalog, where you can login using email/password or set an API token to perform authenticated actions like listing assistants or sending questions to a specific assistant. Once authenticated, the tools you can use include login, set_api_token, list_assistants, and ask_assistant, allowing you to manage credentials and interact with Folderr Assistants programmatically.

Use the authentication tools first to establish a session. After authentication, you can list all available assistants for your account to discover their IDs, then target a specific assistant with ask_assistant by providing the assistant_id and your question. The response will contain the assistant's reply. All actions are designed to be used in automated workflows or scripts, making it suitable for integration into larger automation pipelines that leverage Folderr’s API via MCP.

Prerequisites:

• Node.js installed (for local MCP environment) or access to an MCP-compatible runtime
• Internet access to fetch the MCP server package from npm registry

Installation steps:

1. Ensure your MCP settings include the folderr server entry. You can add the following to your MCP configuration:

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

2. If you prefer not to use npx directly in your environment, you can install the package globally or as a dev dependency in your project, then reference the executable accordingly. For example:

npm install -g @folderr/folderr-mcp-server

3. Start or initialize the MCP server according to your runtime—typically by ensuring your MCP configuration is loaded by your MCP host and the folderr server is available under the configured command/args. If your host requires explicit startup, follow your usual startup procedure for MCP servers with the folderr entry.

4. Verify connectivity by invoking a basic tool, such as login or list_assistants, to confirm authentication and API access.

Tips and considerations:

• Authentication tokens should be stored securely and reused across requests to avoid repeated logins.
• The API token method (set_api_token) is preferred for automated or long-running processes.
• Ensure you have created any required credentials in Folderr (email/password or API token) before attempting to login.
• The config.json for Folderr stores the base API URL and the token; keep this secure and do not expose it in client-side environments.
• If you encounter authentication errors, verify that the token or session is valid and not expired, and that the requested action is permitted for the authenticated account.
• The tools assume proper network access to Folderr API endpoints; handle network issues and rate limits as appropriate for your environment.