Reference

MCP tools

Every tool the Vibefilo MCP server gives your agent, with its arguments.

These tools are listed to your agent automatically. The bridge fills in project_id from .vibefilo.json and creates idempotency keys, so your agent rarely sets them by hand.

vibefilo_login

Starts sign-in. Returns a link and a code for you to approve in the browser. Runs in the local bridge.

vibefilo_status

Returns the signed-in account, organization, credit balance and projects. Read only.

vibefilo_setup_project

Creates a project or links an existing one, and returns the project id to save in .vibefilo.json.

Argument	Type	Description
project_id	uuid, optional	Link this existing project instead of creating one.
name	string, optional	Project name, up to 80 characters.
countries	string[], optional	Two-letter country codes you serve.
business_type	string, optional	For example SaaS or marketplace.
deployed_url	url, optional	Where the app is deployed.

vibefilo_estimate

Returns the credit cost of a mode without starting anything. Read only.

Argument	Type	Description
mode	lite \| normal \| full	The mode to price.

vibefilo_start_audit

Charges credits, creates a run and returns the run id, the cost, your balance, the rule pack version, and the rules for that mode with what to investigate, how to check, and the verification goals.

Argument	Type	Description
project_id	uuid	Defaults to the project in `.vibefilo.json`.
mode	lite \| normal \| full	Defaults to normal.
idempotency_key	string	Retries with the same key never charge twice. The bridge sets it.
confirm_credits	integer, optional	Required for checks over 50 credits (every Full check). Without it the call returns `needs_confirmation` with the cost and charges nothing. Pass the cost after the user agrees.

vibefilo_submit_findings

Submits every finding from a run, then returns the counts and the dashboard link. Resubmitting is safe.

Argument	Type	Description
run_id	uuid	The run from `vibefilo_start_audit`.
findings	Finding[]	Up to 500 findings.
checked_rules	string[]	Every rule id the agent inspected, clean ones too. Must come from `vibefilo_start_audit`.
not_applicable	{ rule_id, reason }[], optional	Rules that do not apply to this app, with a short reason.

Finding

Field	Type	Description
rule_id	string	A rule id returned by `vibefilo_start_audit` (35 rule ids in the current pack).
severity	blocker \| high \| medium \| low \| info	How serious the issue is.
title	string	3 to 200 characters.
file	string, optional	Path relative to the project.
line	integer, optional	1-based line number.
evidence	string, optional	Short snippet with secret values masked.

vibefilo_get_audit

Returns the findings of a project as JSON. Read only.

Argument	Type	Description
project_id	uuid	Defaults to the project in `.vibefilo.json`.
severity	string, optional	Only this severity.
status	string, optional	Only this status, for example open.
limit	integer, optional	1 to 200. Defaults to 50.
format	string, optional	`markdown` returns the content of `latest.md` instead.

vibefilo_get_fix

Fix guidance for one finding. Costs 1 credit and marks the finding as fix in progress.

Argument	Type	Description
finding_id	uuid	The finding to fix.
idempotency_key	string	Retries with the same key never charge twice.
stack	string, optional	For example `nextjs` or `supabase`.

vibefilo_verify_fix

Records the re-check result. Costs 1 credit. If every goal passes the finding becomes Verified and the score updates; otherwise it is reopened.

Argument	Type	Description
finding_id	uuid	The finding that was fixed.
idempotency_key	string	Retries with the same key never charge twice.
goals	array	One `{ goal, passed }` per verification goal, with the exact goal text.
evidence	string, optional	Re-check output. Secrets are masked.

vibefilo_balance

Returns your credit balance, recent usage and a link to the Usage page. Read only.