Tools Reference

The Vibe BI MCP Server exposes 5 tools. All tools require authentication via OAuth.

ask_question

Ask a data question in natural language. Vibe BI finds the right tables, generates SQL, executes it, and returns the answer.

Response time: 10–30 seconds (up to 2 minutes for complex queries).

Parameters

Parameter	Type	Required	Description
question	string	Yes	A natural language data question
thread_id	string	No	Pass from a previous response for follow-up questions with context

Example

question: "What were our top 10 products by revenue last month?"

For follow-ups, pass the thread_id from the previous response:

question: "Now break that down by category"
thread_id: "abc123-..."

---

search_tables

Find database tables relevant to a natural language description using semantic search. Use this to explore what data is available before asking specific questions.

Response time: 1–2 seconds.

Parameters

Parameter	Type	Required	Description
query	string	Yes	Natural language description of the data you’re looking for
limit	number (1–50)	No	Max tables to return (default: 10)

Example

query: "user signups and registrations"
limit: 5

---

list_tables

List all tables in the connected database.

Response time: < 1 second.

Parameters

No parameters required.

---

list_charts

List your saved charts in Vibe BI.

Response time: < 1 second.

Parameters

Parameter	Type	Required	Description
limit	number (1–100)	No	Max charts to return (default: 20)

---

list_dashboards

List your dashboards in Vibe BI.

Response time: < 1 second.

Parameters

Parameter	Type	Required	Description
limit	number (1–100)	No	Max dashboards to return (default: 20)