Skip to content
Back to skills

Flisk Recipe Ai Agent

ASecurity

Recipe for "build me an AI agent with MCP tools and a database" with Flisk - an agent service with sessions, an MCP tools server and a backend with a database in one stack, started with `flisk up`. Use with the flisk-build skill when the user asks for an AI agent, chatbot, assistant, MCP server or tools for an agent.

  • 54 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added November 21, 2026
ai-agentsbashdockerapidatabasebackend

Works with

  • claude code
  • cli
  • api
  • mcp

Security analysis

A100/100

Scanned November 21, 2026

npx -y skills add flisk-sh/flisk --skill flisk-recipe-ai-agent --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Flisk Recipe Ai Agent?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Flisk Recipe Ai Agent
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/flisk-sh-flisk-recipe-ai-agent-flisk/badge)](https://www.skillsdirectory.com/skills/flisk-sh-flisk-recipe-ai-agent-flisk)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: flisk-recipe-ai-agent
description: Recipe for "build me an AI agent with MCP tools and a database" with Flisk - an agent service with sessions, an MCP tools server and a backend with a database in one stack, started with `flisk up`. Use with the flisk-build skill when the user asks for an AI agent, chatbot, assistant, MCP server or tools for an agent.
license: MIT
compatibility: Requires the flisk CLI, Docker and Tilt on the local machine. Does not deploy.
metadata:
  author: flisk-sh
  version: "1.0"
---

# Recipe: an AI agent with MCP tools and a database

**Parts:** an agent that keeps a conversation per session, an MCP server with the agent's tools, and a backend that stores the data the tools read and write.

## Steps

```bash
flisk doctor
flisk project --yes
flisk resource assistant --type agent --stack ai --yes
flisk resource tools-mcp --type mcp --stack ai --yes
flisk resource notes-api --type backend --stack ai --feature drizzle --yes
flisk up ai --dry-run
flisk up ai --json &          # wait for {"ok":true}
flisk networks --stack ai --raw
```

Keep the agent on the default session storage (a named volume). In Flisk 1.4.2 an agent created with `--durability postgres` fails its image build (`TS7016: Could not find a declaration file for module 'pg'`); use the `notes-api` backend for the database instead.

## App code

- `notes-api`: a `notes` table (`src/schema.ts`) and `GET /notes`, `POST /notes`. Keep `/health` and `/health/db`.
- `tools-mcp`: tools such as `list_notes` and `add_note` that call `notes-api`.
- `assistant`: the agent contract is already in place: `/health`, `/ready`, `POST /turn` and `GET /session` with an `x-session-id` header. Put the agent's logic in the turn handler. If the user gives a model API key, list its name under `secrets.required` in `service.json` and put the value in the project `.env`.

## Done when

Each answers 200 on `api.<project>.localhost:<port>`: `/api/assistant/health`, `/api/assistant/ready`, `/api/tools-mcp/health`, `/api/notes/health`, `/api/notes/health/db`. Then send one turn:

```bash
curl -s -X POST -H 'x-session-id: demo' -H 'content-type: application/json' \
  -d '{"input":"hello"}' http://api.<project>.localhost:<port>/api/assistant/turn
```

Tell the user the three URLs, how to talk to the agent (the `curl` above), and that `flisk agent sessions assistant --session-id demo` shows the saved conversation.

## MCP tools

If a `mcp__flisk__*` tool is missing, run `flisk connect claude` in the project folder and restart Claude Code. The CLI commands in this skill work without MCP as well.

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.