What are native tools?
Native tools are Flowra’s own built-in tools — they don’t come from external toolkits (Slack, Gmail, etc.). They let the AI and your workflows do platform actions: create or run a workflow, search and execute other tools, manage connections, work with the Table (database) and Knowledge (RAG) APIs, read/edit files, and more. They are available:- In MCP when you use Smart mode — the client (e.g. Cursor) sees these tools so the AI can discover tools, run them, create workflows, and manage connections.
- In workflows and agents — you can attach native tools like any other tool so a workflow can, for example, create another workflow, query the database, or search the knowledge base.
FLOWRA_CREATE_OR_UPDATE_WORKFLOW). You can list them via the Tools API (filter by provider LOCAL or toolkit slug for the local toolkit) or via MCP get-config. Below is a grouped overview of the main native tools.
General / platform tools
These cover workflows, agents, tool discovery, execution, connections, and files.| Tool (concept) | What it does |
|---|---|
| Create or update workflow | Create or update an automation workflow (trigger + steps). Use when the user wants to “build a flow” or “schedule something”. |
| Create or update agent | Create or update a dynamic agent (prompt, model, tools). |
| Get workflow or agent by ID | Fetch a workflow or agent by ID (one tool for both). |
| Execute workflow | Run a workflow by ID (e.g. for testing or from another flow). |
| Tools builder | Build a new tool or toolkit from cURL, OpenAPI, or a manual spec. |
| Get tool details | Get a tool’s full details (and toolkit) by tool slug. |
| Get tool schemas | Get full input/output schemas for given tool slugs. Use before executing a tool so arguments are schema-compliant. |
| Discover tools | Find tools that match the user’s request across apps; returns tool slugs and a recommended execution plan. Call this first when the user mentions an app or task. Run returned tools via Multi execute tool. |
| Multi execute tool | Execute multiple action tools in one call (e.g. run several tools from a discover result). |
| Manage connections | Create or manage OAuth/API connections to apps. If Discover tools finds no active connection for an app, call this with the toolkit and required auth params. Returns redirect URLs for OAuth when needed. |
| List AI models | List available AI/LLM models (for agents or chat). |
| Test HTTP request | Send a test HTTP request (e.g. for debugging). |
| File export | Export data as a file or shareable link. |
| Convert file | Convert a file to another format (image, media, document, text). |
| Read file | Read file content (Excel, CSV, PDF, text, etc.) or search inside it. |
| Edit file | Overwrite a text file with new content (txt, md, csv, json, etc.). |
| JS remote workbench | Run JavaScript in a persistent remote sandbox (state preserved across calls). |
Database (Table) tools
These map to the Table API: collections and documents (MongoDB-style). Use them from a workflow or MCP to query and mutate data.| Tool (concept) | What it does |
|---|---|
| Database find | Query documents in a collection (filter, sort, limit). |
| Database insert | Insert one or more documents into a collection. |
| Database update | Update documents in a collection (by filter). |
| Database delete | Delete documents from a collection (by filter). |
| Database aggregate | Run an aggregation pipeline on a collection. |
| Database count | Count documents matching a filter. |
| Database list collections | List all collections in the database. |
| Database create collection | Create a new collection. |
| Database rename collection | Rename a collection (display name). |
| Database delete collection | Delete a collection and all its documents. |
RAG (Knowledge) tools
These map to the Knowledge API: RAG collections and chunks. Use them to ingest content and search from a workflow or MCP.| Tool (concept) | What it does |
|---|---|
| RAG add knowledge | Add text chunks to a RAG knowledge base. |
| RAG add file | Ingest a file into a RAG knowledge base. |
| RAG add URL | Ingest content from a URL into a RAG knowledge base. |
| RAG search knowledge | Semantic search over a RAG knowledge base. |
| RAG delete knowledge | Delete knowledge (chunks or collection) from RAG. |
| RAG list collections | List RAG knowledge base collections. |
| RAG delete collection | Delete a RAG collection and all its documents. |
| RAG rename collection | Rename a RAG collection. |
How to use them
- From MCP (Smart mode) — Connect to Flowra’s MCP endpoint with Smart mode; the client receives these tools and can call them (discover tools → get schemas → multi-execute, or create workflow, manage connections, etc.). See MCP.
- From the Tools API — List tools with provider
LOCALor the appropriate toolkit slug; you get slugs and schemas. Execute via POST Execute tool with the native tool slug. - In workflows — When editing a workflow, attach the native tools you need (e.g. database find, RAG search, create workflow) so the agent can use them in that flow.