---
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)
*   [Pipeline integrations](https://www.jsonify.com/docs/pipelines/integrations)
*   [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)

## Analytics

*   [Dashboards](https://www.jsonify.com/docs/analytics/dashboards)
*   [Editing dashboards](https://www.jsonify.com/docs/analytics/editing-dashboards)

## Alerts

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

## Integrations

*   [Integrations overview](https://www.jsonify.com/docs/integrations/overview)
*   [Sheets, warehouses and webhooks](https://www.jsonify.com/docs/integrations/destinations)
*   [Warehouses and S3](https://www.jsonify.com/docs/integrations/warehouses)
*   [Slack and email](https://www.jsonify.com/docs/integrations/slack-and-email)
*   [Start runs from your systems](https://www.jsonify.com/docs/integrations/triggers)
*   [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)
*   [Sharing a workspace](https://www.jsonify.com/docs/workspace/sharing)
*   [The sidebar](https://www.jsonify.com/docs/workspace/sidebar)
*   [Usage](https://www.jsonify.com/docs/workspace/usage)
*   [Billing](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.** Open [Jsonify on the ChatGPT plugin store](https://chatgpt.com/plugins/plugin_asdk_app_6abfe9dfc5348191982ae0f71ce97e5e), select **Connect** and sign in.
*   **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.

To check the connection from Jsonify, open **Integrations → AI → Connect AI**, choose **ChatGPT, Claude & Microsoft Copilot**, and press **Check connection**. Your assistant then appears on the AI tab under **Assistant connections**.

![The AI tab of the Integrations page, where connected assistants are listed under Assistant connections](/assets/images/product/tut-agent-connections.png)

Connected assistants appear on the Integrations page's AI tab. Open one to disconnect it.

## 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, which also appears in **Conversations** in Jsonify. 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
