MCP tools reference
Every tool the Buron MCP server exposes, with parameters and return shapes.
The Buron MCP server exposes 14 tools grouped into five areas. Your editor's agent calls these automatically based on your questions, you don't need to invoke them directly. This reference is useful when you're building custom skills or want to know exactly what's available.
Queries
These tools let you run ad-hoc queries, manage saved queries, and execute them on demand. Each query targets a specific ad platform through its query language.
Supported sources:
| Source | Platform | Query language |
|---|---|---|
gaql | Google Ads | Google Ads Query Language |
More sources (Meta, TikTok, GA4) are coming. The source parameter determines which platform the query runs against.
query
Execute an ad-hoc query against a connected ad platform.
| Parameter | Type | Required | Description |
|---|---|---|---|
source | string | Yes | Query source, see supported sources above |
query | string | Yes | The query string in that platform's query language |
Returns the query results as JSON.
runQuery
Execute a saved query by ID and return fresh results.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Saved query ID |
Returns the same shape as query. The saved query already knows its source, so you don't need to specify it.
listQueries
List saved queries, optionally filtered by source.
| Parameter | Type | Required | Description |
|---|---|---|---|
source | string | No | Filter by source (e.g. "gaql") |
Returns { queries: [...] }. Each entry includes the query's ID, name, source, and query string.
createQuery
Save a query for reuse.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Display name (e.g. "BoF ROAS, Last 30 Days") |
source | string | Yes | Query source (e.g. "gaql") |
query | string | Yes | The query string |
config | object | No | Chart type, columns, display settings |
Returns the created query object with its generated ID.
Dashboards
Dashboards are pre-built views that combine multiple queries into KPIs, charts, and tables. Buron ships with default dashboards and your team can create custom ones.
listDashboards
List every dashboard available to your team: default dashboards (overview, channel, geo) plus any custom dashboards. Returns the fully-hydrated shape: each dashboard carries a description, tags, and panel definitions with their queries and visualizations.
No parameters.
Returns { dashboards: [...] }.
runDashboard
Run a dashboard for a date range and return panel data.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Dashboard ID (e.g. "overview", "channel", "geo", or a custom UUID) |
from | string | Yes | Start date, YYYY-MM-DD |
to | string | Yes | End date, YYYY-MM-DD |
fresh | boolean | No | Bypass the per-account cache |
Returns the computed panel data: KPIs, chart series, and detail tables.
Integrations
getIntegration
Check the connection status of an ad platform integration.
| Parameter | Type | Required | Description |
|---|---|---|---|
provider | string | Yes | Integration provider (e.g. "google-ads") |
Returns { connected, provider, status, externalAccountId }.
Knowledge files
Your team's knowledge layer is a file system. These tools give your editor full read/write access.
readFile
Read a file by path.
| Parameter | Type | Required | Description |
|---|---|---|---|
path | string | Yes | File path (e.g. /ads/taxonomy.md) |
Returns the file content as text. Returns an error if the file doesn't exist.
writeFile
Write or update a file.
| Parameter | Type | Required | Description |
|---|---|---|---|
path | string | Yes | File path |
content | string | Yes | File content |
metadata | object | No | Optional metadata object |
Returns confirmation with the path and character count.
listFiles
List files in a directory.
| Parameter | Type | Required | Description |
|---|---|---|---|
directory | string | No | Directory path (e.g. /ads/google/). Lists root if omitted |
Returns { files: [...] }.
glob
Find files matching a glob pattern.
| Parameter | Type | Required | Description |
|---|---|---|---|
pattern | string | Yes | Glob pattern (e.g. /ads/google/reports/*.md) |
Returns { files: [...] }.
grep
Search file contents for a pattern.
| Parameter | Type | Required | Description |
|---|---|---|---|
pattern | string | Yes | Search pattern (regex) |
directory | string | No | Directory to search in |
Returns { matches: [...] }.
Editor skills
These tools let your editor discover and install Buron skills (like /launch) directly.
listEditorSkills
List skills that can be installed into your project. Returns each skill's name and description, plus the install targets for each supported editor.
No parameters.
Returns { skills: [...], installTargets: [...] }.
readEditorSkill
Get the full template for a skill.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Skill name from listEditorSkills (e.g. "launch", "setup-google-ads-tracking") |
Returns the full SKILL.md template as text. Write it to {projectRoot}/{editorSkillsDir}/{name}/SKILL.md to install.
Was this page helpful?