Skip to content

docs: add skills for the new MCP tool areas - #15

Merged
alamin-br merged 2 commits into
mainfrom
docs/skills-for-new-tools
Nov 12, 2026
Merged

docs: add skills for the new MCP tool areas#15
alamin-br merged 2 commits into
mainfrom
docs/skills-for-new-tools

Conversation

@alamin-br

@alamin-br alamin-br commented Nov 11, 2026

Copy link
Copy Markdown
Collaborator

Teaches agents to use the tools Baserow's MCP server gained since 0.1.1, part of baserow/baserow#6345.

What changes

  • Agents get guidance for building databases, tables, fields and views, including sorts, hidden fields and row colours.
  • Agents can build, publish and pause automation workflows, and are told to ask the user before publishing.
  • Agents get guidance for dashboards and their widgets, and for building application builder pages, forms, buttons and login.
  • Agents know how to search the workspace, use row comments and read the audit log, and how to read errors from any tool.
  • When a tool is missing, agents tell the user to turn it on in Baserow's settings instead of signing in again. The README and store listings describe all six tool areas.

How to test

  1. Start a local Baserow stack on develop with BASEROW_MCP_OAUTH_ENABLED=true and premium and enterprise licences.
  2. In Claude Code, run /plugin marketplace add <path to this checkout> and /plugin install baserow@baserow, enter http://localhost:8000/mcp, then sign in with /mcp and pick the Read only preset.
  3. Ask "Find the customer called Acme". The agent searches the workspace and doesn't change anything.
  4. Ask for a table that isn't there, such as "Create a Tasks table". The agent says the edit tools are off and points to Edit tools in Settings.
  5. Turn on every group with Edit tools, then ask for a Tasks table with a kanban view, a dashboard with a summary of open tasks, and a workflow that emails on new tasks. The agent asks before publishing the workflow.

The manifest checks cover the skill front matter and listing metadata.

@alamin-br
docs: add skills for the new MCP tool areas
080d5b2 
Baserow's MCP server now has database structure, automation, dashboard,
application builder, search, comment and audit log tools, and the plugin's
single skill only covered rows.
@alamin-br alamin-br self-assigned this Nov 11, 2026
@alamin-br
fix: correct the dashboard examples and skill gaps found in testing
d5f5da1 
Widgets need table_id, not every tool error has a code, and agents reached for the legacy list_databases and guessed the get_row data source path.
@alamin-br
alamin-br marked this pull request as ready for review November 11, 2026 17:53
@alamin-br alamin-br mentioned this pull request Nov 11, 2026
Draft
silvestrid
silvestrid approved these changes Nov 12, 2026
View reviewed changes

@silvestrid silvestrid left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great, let's merge

@alamin-br
alamin-br merged commit 8808f8e into main Nov 12, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@silvestrid silvestrid silvestrid approved these changes

Assignees

@alamin-br alamin-br

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@alamin-br @silvestrid