@lowdefy/docs-content 0.0.0-experimental-20260710073520

package/content/connections/mariadb.md

@@ -0,0 +1,177 @@
+# MariaDB
+
+The [Knex](/Knex) connection can be used to connect to a [MariaDB](https://www.mysql.com) database. To connect to a MariaDB database, use the `mysql2` client — knex does not have a separate `mariadb` client.
+
+## Connections
+
+Connection types:
+  - Knex
+
+### Knex
+
+#### Properties
+- `client: enum`: __Required__ - Use the `mysql2` client to connect to MariaDB.
+- `connection: object | string `: __Required__ - Connection object or string to pass to the [`mysql2`](https://www.npmjs.com/package/mysql2) database client.
+- `version: string`:  Set database version.
+- `useNullAsDefault: boolean`: If true, undefined keys are replaced with NULL instead of DEFAULT.
+
+#### Examples
+
+###### Connection object:
+```yaml
+connections:
+  - id: mariadb
+    type: Knex
+    properties:
+      client: mysql2
+      connection:
+        host:
+          _secret: MARIADB_HOST
+        database:
+          _secret: MARIADB_DB
+        user:
+          _secret: MARIADB_USER
+        password:
+          _secret: MARIADB_PASSWORD
+```
+Environment variables:
+```
+LOWDEFY_SECRET_MARIADB_HOST = database.server.com
+LOWDEFY_SECRET_MARIADB_DB = db
+LOWDEFY_SECRET_MARIADB_USER = user
+LOWDEFY_SECRET_MARIADB_PASSWORD = password
+```
+
+## Requests
+
+Request types:
+
+- KnexBuilder
+- KnexRaw
+
+### KnexBuilder
+
+#### Properties
+
+- `query: object[]`: **Required** - SQL query builder array. An array of objects, with a single key which is the name of the knex builder function. The value should be an array of arguments to pass to the builder function.
+- `tableName: string | object`: The name of the table to query from.
+
+#### Examples
+
+###### Build a query:
+
+```yaml
+id: knexBuilder
+type: KnexBuilder
+connectionId: knex
+payload:
+  name:
+    _state: name
+properties:
+  query:
+    - select:
+        - '*'
+    - from:
+        - users
+    - where:
+        - name
+        - _payload: name
+```
+
+###### Using `tableName`:
+
+```yaml
+id: knexBuilder
+type: KnexBuilder
+connectionId: knex
+payload:
+  name:
+    _state: name
+properties:
+  tableName: users
+  query:
+    - select:
+        - '*'
+    - where:
+        - name
+        - _payload: name
+```
+
+###### Aliases:
+
+```yaml
+id: knexBuilder
+type: KnexBuilder
+connectionId: knex
+properties:
+  tableName:
+    a: tableA
+    b: tableB
+  query:
+    - select:
+        - aField: 'a.field'
+        - bField: 'b.field'
+    - limit:
+        - 1
+```
+
+### KnexRaw
+
+#### Properties
+
+- `query: string`: **Required** - SQL query string.
+- `parameters: string | number | array | object`: SQL query parameters.
+
+#### Examples
+
+###### Simple raw query:
+
+```yaml
+id: knexRaw
+type: KnexRaw
+connectionId: knex
+properties:
+  query: SELECT * FROM "my_table";
+```
+
+###### Query with named parameters:
+
+```yaml
+id: knexRaw
+type: KnexRaw
+connectionId: knex
+payload:
+  selected_name:
+    _state: selected_name
+properties:
+  query: select * from users where name = :name
+  parameters:
+    name:
+      _payload: selected_name
+```
+
+###### Query with positional parameters:
+
+```yaml
+id: knexRaw
+type: KnexRaw
+connectionId: knex
+payload:
+  selected_name:
+    _state: selected_name
+properties:
+  query: select * from users where name = ?
+  parameters:
+    - _payload: selected_name
+```
+
+###### Reference a `.sql` file:
+
+```yaml
+id: knexRaw
+type: KnexRaw
+connectionId: knex
+properties:
+  query:
+    _ref: my_query.sql
+```

package/content/connections/mcp.md

@@ -0,0 +1,134 @@
+# MCP
+
+The MCP connection defines a [Model Context Protocol](https://modelcontextprotocol.io/) server that provides tools to [Lowdefy agents](/agents-introduction). MCP is an open standard for connecting AI models to external tools and data sources.
+
+> The MCP connection is provided by the `@lowdefy/connection-mcp` package, which is included by default.
+
+MCP connections are referenced from the `mcp` array on an agent. The agent automatically discovers and uses the tools the MCP server provides. See [MCP Tools](/agent-mcp-tools) for details on using MCP with agents and for inline configuration without a connection.
+
+## Connections
+
+### Mcp
+
+#### Properties
+
+| Property | Type | Default | Description |
+| --- | --- | --- | --- |
+| `transport` | string | `'http'` | Transport protocol: `'http'`, `'sse'`, or `'stdio'`. |
+| `url` | string | | URL for the MCP server. Required for `http` and `sse` transports. |
+| `headers` | object | | HTTP headers. Only for `http` and `sse`. __Operators are evaluated__. |
+| `command` | string | | Command to run. Required for `stdio` transport. |
+| `args` | string[] | | Arguments for the stdio command. |
+| `env` | object | | Environment variables for the stdio command. __Operators are evaluated__. |
+
+### HTTP Transport
+
+Connect to a remote MCP server over HTTP:
+
+```yaml
+connections:
+  - id: mcp_tools
+    type: Mcp
+    properties:
+      url: https://mcp.example.com/tools
+      transport: http
+```
+
+###### With authentication:
+```yaml
+connections:
+  - id: mcp_tools
+    type: Mcp
+    properties:
+      url: https://mcp.example.com/tools
+      transport: http
+      headers:
+        Authorization:
+          _string.concat:
+            - 'Bearer '
+            - _secret: MCP_API_KEY
+```
+
+### SSE Transport
+
+Connect using Server-Sent Events:
+
+```yaml
+connections:
+  - id: mcp_sse
+    type: Mcp
+    properties:
+      url: https://mcp.example.com/sse
+      transport: sse
+```
+
+### Stdio Transport
+
+Launch a local MCP server process. Useful for npm-published MCP servers:
+
+###### File system access:
+```yaml
+connections:
+  - id: mcp_filesystem
+    type: Mcp
+    properties:
+      transport: stdio
+      command: npx
+      args:
+        - '-y'
+        - '@modelcontextprotocol/server-filesystem'
+        - '/data/documents'
+```
+
+###### GitHub integration:
+```yaml
+connections:
+  - id: mcp_github
+    type: Mcp
+    properties:
+      transport: stdio
+      command: npx
+      args:
+        - '-y'
+        - '@modelcontextprotocol/server-github'
+      env:
+        GITHUB_TOKEN:
+          _secret: GITHUB_TOKEN
+```
+
+###### Custom server with environment variables:
+```yaml
+connections:
+  - id: mcp_database
+    type: Mcp
+    properties:
+      transport: stdio
+      command: node
+      args:
+        - ./mcp-servers/database.js
+      env:
+        DATABASE_URL:
+          _secret: DATABASE_URL
+```
+
+## Usage
+
+Reference MCP connections in the `mcp` array on an agent:
+
+```yaml
+agents:
+  - id: dev_assistant
+    type: ClaudeAgent
+    connectionId: anthropic
+    properties:
+      model: claude-sonnet-4-20250514
+      instructions: |
+        You help developers with code and GitHub issues.
+        Use GitHub tools to search issues, read files,
+        and create pull requests.
+    mcp:
+      - mcp_github
+      - mcp_filesystem
+```
+
+MCP servers can also be defined inline on the agent without a connection. See [MCP Tools](/agent-mcp-tools) for inline configuration.