Docs

Integration modes ​

When adding the MCP server to your config you will have to set the operating mode in the args array to either static or dynamic:

json
"args": [
  "-y",
  "@florentine-ai/mcp",
  "--mode",
  "static"
]

Static mode ​

The static mode should be used if you integrate Florentine.ai into an existing external MCP client such as a MCP-ready Desktop App like Claude Desktop or Dive AI.

In static mode you set all neccessary parameters (such as Return Types, Required Inputs, etc.) as env variables inside the config json. This means that these parameters will remain static until you change the setup config and will be sent with every request to Florentine.ai.

Dynamic mode ​

The dynamic mode should be used if you integrate Florentine.ai into your own custom MCP client.

In dynamic mode you can pass all neccessary parameters (such as Return Types, Required Inputs, etc.) directly to the florentine_ask tool. This means you can dynamically inject individual parameters to every request forwarded to Florentine.ai (i.e. a user's sessionId).