Skip to main content

Quickstart

Get from "empty workspace" to "first answer" in about five minutes. You can do every step in the hosted app — no install required.

1. Register a source​

In the app, go to Sources and click + Add source, then pick a category and a system. AgentData connects read-only and profiles the schema; it never copies your data into its registry.

Add a data source

POST /api/sources
{
  "name": "northwind",
  "type": "postgres",
  "conn_str": "postgresql://readonly_user:••••@db.internal:5432/northwind"
}

Don't have a database handy? Use the bundled Northwind demo to follow along.

2. Scan it​

Trigger a scan (Discovery → Scan). AgentData profiles each table, classifies columns, and proposes entities (Customer, Order, Product…) with their measures and dimensions.

3. Review and approve the model​

Open Entities. Each discovered entity starts as pending_review. Check the names and roles, then Approve all. Approved entities become confirmed and queryable. (You can rename, merge, split or add calculated columns here too — see Concepts.)

Confirmed entities

4. Ask your first question​

In the Query → NL tab, ask in plain language:

top 5 products by revenue

AgentData plans the query against your approved model, validates it, runs it locally, and returns the rows plus the generated SQL. Follow-up questions and other languages work too. You can also build a precise metric query by picking an entity, measures and dimensions:

Metric query result

5. Connect an AI client over MCP​

Go to Query → Connect, create an API key, and point any MCP client at:

https://agentdata.mdm.biskilled.com/mcp/

Now Claude, ChatGPT or your IDE can call query_nl and answer questions straight from your data. See MCP server for client config.

Connect over MCP

Do it from the API instead​

Every step above maps to a REST endpoint. Once you have a key:

curl -X POST https://agentdata.mdm.biskilled.com/api/query/nl \
  -H "Authorization: Bearer agentdata_sk_…" \
  -H "Content-Type: application/json" \
  -d '{"question": "top 5 products by revenue"}'

See the full API Reference for request and response schemas.