> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockworks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ChatGPT

> Install the Blockworks plugin for ChatGPT and ask questions against Blockworks market, onchain, and research data without leaving the chat.

The Blockworks plugin for ChatGPT brings market data, fundamentals, research, news, signals,
events, and fundraising data into your ChatGPT conversations. Install it from the ChatGPT
plugin directory, authorize it once with your Blockworks API key, and ChatGPT can pull
Blockworks data whenever a question calls for it.

The plugin is the Blockworks MCP server packaged for ChatGPT's plugin directory. It answers
from the same datasets and the same [tools](/mcp/tools/overview) as any other MCP client,
but there is no server URL to paste and no developer mode to enable. If you would rather
create the connection by hand, see the ChatGPT tab in [Client setup](/mcp/clients).

## What you need

* A ChatGPT account with access to plugins.
* A Blockworks API key. Generate or view yours at
  [app.blockworks.com/account/api](https://app.blockworks.com/account/api).

## Installation

<Steps>
  <Step title="Find the plugin">
    In ChatGPT, open the plugin directory (the **Plugins** button below the composer, or
    **Plugins** in settings) and search for **Blockworks**.

    <img src="https://mintcdn.com/blockworksdocs/aThYhUyT6Aci79lx/images/mcp/chatgpt-search.png?fit=max&auto=format&n=aThYhUyT6Aci79lx&q=85&s=fecc89cef0038221ce8840aeded85c20" alt="Searching the ChatGPT plugin directory for Blockworks" width="1008" height="530" data-path="images/mcp/chatgpt-search.png" />
  </Step>

  <Step title="Install it">
    Open the listing and click **Install plugin**.

    <img src="https://mintcdn.com/blockworksdocs/ecN3mgnll8dMWTWd/images/mcp/chatgpt-install.webp?fit=max&auto=format&n=ecN3mgnll8dMWTWd&q=85&s=220b3ead3f6ab9c4fe1c855effb52621" alt="The Blockworks plugin listing with the Install plugin button" width="1632" height="1002" data-path="images/mcp/chatgpt-install.webp" />
  </Step>

  <Step title="Authorize with your API key">
    ChatGPT opens a Blockworks authorization page. Paste your API key and click
    **Authorize**. The key is sent to Blockworks only, and ChatGPT stores the resulting
    credentials so you do not have to repeat this step.

    <img src="https://mintcdn.com/blockworksdocs/ecN3mgnll8dMWTWd/images/mcp/chatgpt-authorize.png?fit=max&auto=format&n=ecN3mgnll8dMWTWd&q=85&s=fe59a6f6c7ab8df1d3ed9fca6e2dce25" alt="The Connect to Blockworks page asking for an API key" width="1340" height="1346" data-path="images/mcp/chatgpt-authorize.png" />
  </Step>

  <Step title="Confirm it is connected">
    Back in ChatGPT the listing shows **Blockworks plugin installed**, with a **Try in chat**
    button and a few example prompts to start from.

    <img src="https://mintcdn.com/blockworksdocs/ecN3mgnll8dMWTWd/images/mcp/chatgpt-installed.webp?fit=max&auto=format&n=ecN3mgnll8dMWTWd&q=85&s=087e56dda2680d565d50a8496275e63a" alt="The plugin listing after installation, showing example prompts" width="1662" height="1302" data-path="images/mcp/chatgpt-installed.webp" />
  </Step>
</Steps>

## Using the plugin

Once installed, ChatGPT calls the plugin on its own when a question needs Blockworks data.
To make sure a request goes to Blockworks, type `@` in the composer and pick **Blockworks**
from the list, then write your question.

<img src="https://mintcdn.com/blockworksdocs/ecN3mgnll8dMWTWd/images/mcp/chatgpt-mention.png?fit=max&auto=format&n=ecN3mgnll8dMWTWd&q=85&s=f9e6892c602b3bae3c6947af4eaaac42" alt="Selecting the Blockworks plugin with an @ mention in the composer" width="1688" height="414" data-path="images/mcp/chatgpt-mention.png" />

Ask the kind of question you would ask an analyst. ChatGPT works out which datasets to
query, fetches the series, and does the arithmetic:

<img src="https://mintcdn.com/blockworksdocs/aThYhUyT6Aci79lx/images/mcp/chatgpt-result.png?fit=max&auto=format&n=aThYhUyT6Aci79lx&q=85&s=72a30cba2d396868247e47fb6e17dd23" alt="A ChatGPT answer comparing Ethereum and Solana activity in a table" width="1792" height="1410" data-path="images/mcp/chatgpt-result.png" />

Prompts that work well:

* Compare Ethereum and Solana on daily active addresses, fees, and transaction counts over
  the last 90 days. Put it in a table.
* What are the most important developments for Ethereum in the past week? Summarize with
  sources.
* What is Solana's fully diluted valuation compared to its circulating market cap?

For more prompt patterns, and how to steer the assistant toward the right dataset, see
[Prompt guide](/mcp/prompts).

## Access to data

Which datasets the plugin can query is determined by your organization's API permissions.
If ChatGPT reports that a metric or dataset is unavailable, check the APIs enabled for your
key at [app.blockworks.com/account/api](https://app.blockworks.com/account/api).

## Troubleshooting

* **Authorization failed or expired.** Remove the Blockworks plugin in ChatGPT, then install
  it again and enter your key. Reinstalling is what clears the stored credentials.
* **ChatGPT answers without using the plugin.** Add an `@Blockworks` mention to the prompt,
  or name the metric and entity explicitly.
* **Your workspace does not show the plugin.** Plugin installs can be restricted by a
  ChatGPT workspace administrator. Ask your admin to allow it, or connect through a
  developer-mode connector as described in [Client setup](/mcp/clients).

Anything that applies to the MCP server also applies here, so the
[MCP troubleshooting](/mcp/troubleshooting) page covers the rest.