Docs

MCP Server Overview ​

The Florentine.ai MCP Server lets you integrate natural language querying for your MongoDB data directly into your custom AI Agent or AI Desktop App.

How it works ​

Questions are forwarded by the AI Agent to the MCP Server, transformed into MongoDB aggregations and the aggregation results are returned to the Agent for further processing.

You need to add the MCP server to your initial MCP setup configuration, which is typically formatted as json:

json
{
  "mcpServers": {
    "florentine": {
      "command": "npx",
      "args": ["-y", "@florentine-ai/mcp", "--mode", "static"],
      "env": {
        "FLORENTINE_TOKEN": "<FLORENTINE_API_KEY>"
      }
    }
  }
}

Available Tools ​

The server provides two tools:

  • florentine_list_collections --> Lists all currently active collections that can be queried. That includes descriptions, keys and type of values.
  • florentine_ask --> Receives a question and returns an aggregation, aggregation result or answer (depending on the returnTypes setting).