---
title: "Use a dataset from your agent"
description: "Connect Claude Code, Codex or ChatGPT to Jsonify over MCP, then ask questions of live data and ask Jason for new work without leaving your tools. About five minutes."
url: "https://www.jsonify.com/docs/tutorials/agent-query"
---

[Documentation](https://www.jsonify.com/docs/) Filter pages

## Getting started

*   [What is Jsonify?](https://www.jsonify.com/docs/)
*   [How pipelines work](https://www.jsonify.com/docs/how-jsonify-works)
*   [Your first pipeline](https://www.jsonify.com/docs/getting-started/first-pipeline)
*   [Workspaces](https://www.jsonify.com/docs/getting-started/workspaces)
*   [Glossary](https://www.jsonify.com/docs/getting-started/glossary)

## Tutorials

*   [Track the Hacker News front page](https://www.jsonify.com/docs/tutorials/hacker-news)
*   [Monitor prices across retailers](https://www.jsonify.com/docs/tutorials/price-monitoring)
*   [Get a Slack alert when a price drops](https://www.jsonify.com/docs/tutorials/slack-price-alert)
*   [Use a dataset from your agent](https://www.jsonify.com/docs/tutorials/agent-query)

## Jason

*   [Chatting with Jason](https://www.jsonify.com/docs/jason/chat)
*   [Changing a pipeline](https://www.jsonify.com/docs/jason/changing-a-pipeline)
*   [Agents, workers and repairs](https://www.jsonify.com/docs/data-agents)

## Pipelines

*   [The pipeline page](https://www.jsonify.com/docs/pipelines/overview)
*   [Statement of work and steps](https://www.jsonify.com/docs/pipelines/statement-of-work)
*   [Inputs and parameters](https://www.jsonify.com/docs/pipelines/inputs)
*   [Settings reference](https://www.jsonify.com/docs/pipelines/settings)
*   [Versions and changelog](https://www.jsonify.com/docs/pipelines/versions)

## Runs

*   [Running a pipeline](https://www.jsonify.com/docs/runs/running)
*   [Scheduling](https://www.jsonify.com/docs/runs/scheduling)
*   [Run detail](https://www.jsonify.com/docs/runs/run-detail)
*   [Run lifecycle](https://www.jsonify.com/docs/runs/lifecycle)
*   [Verification and repair](https://www.jsonify.com/docs/runs/verification-and-repair)

## Datasets

*   [Dataset pages](https://www.jsonify.com/docs/datasets/overview)
*   [Versions](https://www.jsonify.com/docs/datasets/versions)
*   [Query and export](https://www.jsonify.com/docs/datasets/query-and-export)
*   [Row detail and provenance](https://www.jsonify.com/docs/datasets/provenance)
*   [Sharing](https://www.jsonify.com/docs/datasets/sharing)

## Analytics

*   [Dashboards](https://www.jsonify.com/docs/analytics/dashboards)
*   [Newsletters](https://www.jsonify.com/docs/analytics/newsletters)

## Alerts

*   [Alert rules](https://www.jsonify.com/docs/alerts/rules)
*   [Alert history and notifications](https://www.jsonify.com/docs/alerts/history)

## Integrations

*   [Integrations overview](https://www.jsonify.com/docs/integrations/overview)
*   [Slack and email](https://www.jsonify.com/docs/integrations/slack-and-email)
*   [Sheets, warehouses and webhooks](https://www.jsonify.com/docs/integrations/destinations)
*   [Ingest and serve API](https://www.jsonify.com/docs/integrations/api)
*   [Connect your agent (MCP)](https://www.jsonify.com/docs/integrations/mcp)
*   [Command line](https://www.jsonify.com/docs/integrations/cli)

## Workspace and account

*   [Workspace settings](https://www.jsonify.com/docs/workspace/settings)
*   [Team](https://www.jsonify.com/docs/workspace/team)
*   [Billing and usage](https://www.jsonify.com/docs/workspace/billing)
*   [Data retention](https://www.jsonify.com/docs/workspace/data-retention)

## Plans

*   [Radar or Benchmark? Enterprise](https://www.jsonify.com/docs/radar-vs-benchmark)
*   [Row pricing and managed service](https://www.jsonify.com/docs/pricing-model)

## More

*   [Connect your agent](https://www.jsonify.com/connect)
*   [Pricing](https://www.jsonify.com/pricing)
*   [Contact support](https://www.jsonify.com/contact)

[Docs](https://www.jsonify.com/docs/)/Tutorials

# Use a dataset from your agent

Connect Claude Code, Codex or ChatGPT to Jsonify over MCP, then ask questions of live data and ask Jason for new work without leaving your tools. About five minutes.

Everything in your workspace is available to the assistant you already use. Once connected, your agent can list pipelines, read and query datasets, start runs, and hand a brief to Jason. This tutorial connects one client and runs three questions against the Hacker News dataset from the [first tutorial](https://www.jsonify.com/docs/tutorials/hacker-news).

Server URL

https://factory.jsonify.com/mcp

Auth

OAuth, sign in once

Transport

Streamable HTTP

Works with

ChatGPT, Claude, Codex, Cursor, Copilot

## 1\. Connect

Pick your client. The full per-client steps are on [Connect your agent](https://www.jsonify.com/docs/integrations/mcp); the short version:

*   **Claude Code.** Add a remote MCP server named `jsonify` with the URL above, then run `/mcp` and complete the sign-in in the browser tab that opens.
*   **Codex.** Add the server to your MCP configuration with the same URL and OAuth; Codex opens the sign-in on first use.
*   **ChatGPT.** Settings → Security and login → Developer mode, then create a connection with the URL and OAuth.
*   **Claude.ai.** Settings → Connectors → Add custom connector.

Sign in with the same account you use in Jsonify. The connection is scoped to your organisation; you choose the workspace in conversation.

![Integrations page showing the connected assistant with its client name and connection time](/assets/images/product/tut-agent-connections.png)

Connected assistants appear under Integrations. Revoke one there at any time.

## 2\. Ask a question

> In my Jsonify workspace “Latest Hacker News Posts”, which domains were linked most often, and what was the highest-scoring post from each?

> Your agent lists the workspace, finds the dataset, runs a query, and answers with a short table. It cites the dataset and the version it read.

The agent reads the active dataset version. Ask for “the version from Monday” and it will read that one instead.

## 3\. Start a run and wait for it

> Run the Hacker News pipeline now and tell me when it finishes.

The agent starts a run and polls it until it completes, then reports rows collected and links the run. Runs started this way are ordinary runs: they appear in the runs rail, publish a new version and count rows like any other.

## 4\. Ask Jason for something new

> Ask Jason to add a “domain” column to the Hacker News dataset, extracted from the url, and to keep the existing rows.

Your agent hands the brief to Jason and returns a link to the conversation. Jason makes the change as a new version and verifies it, exactly as if you had typed the request in Jsonify. If Jason has a question, your agent relays it and you answer in place.

> Your agent cannot approve things on your behalf. Anything that needs a decision, such as accepting a proposal or confirming a credential was set up, comes back to you as a question.

## What the agent can do

| Ask for | What happens |
| --- | --- |
| Workspaces, pipelines, datasets, runs | Listed with names, ids and status |
| A dataset’s rows or a query | Rows are returned in pages; large results are cut off with a cursor |
| A pipeline run | Starts a run; can wait for it |
| New work or a change | Opens a Jason conversation and returns its link |
| A conversation’s progress | Reads Jason’s latest events and questions |
| Cancel | Stops the running Jason turn |

The full tool list is on [Connect your agent](https://www.jsonify.com/docs/integrations/mcp). For scripts and automation rather than conversation, use the [command line](https://www.jsonify.com/docs/integrations/cli).

[**Connect your agent (MCP)**

Per-client setup and every tool.

](https://www.jsonify.com/docs/integrations/mcp)[**Command line**

Run pipelines and pull data from a terminal or CI.

](https://www.jsonify.com/docs/integrations/cli)[**Query and export**

The same questions, asked in Jsonify.

](https://www.jsonify.com/docs/datasets/query-and-export)

[PreviousGet a Slack alert when a price drops](https://www.jsonify.com/docs/tutorials/slack-price-alert) [NextChatting with Jason](https://www.jsonify.com/docs/jason/chat)

Something missing or wrong? [Tell us](https://www.jsonify.com/contact).[Build it →](https://factory.jsonify.com/setup)

## On this page