Skip to main content

ChatGPT Setup Guide

ChatGPT supports MCP through its Developer Mode feature, enabling integration with external data sources like the Hgraph MCP Server. While this beta feature requires additional setup steps, it provides full access to live blockchain data across supported networks through natural language queries.

Hgraph MCP URL

https://mcp.hgraph.com/v1/YOUR_PUBLISHABLE_KEY/mcp

Prerequisites​

Before setting up the MCP connector, you'll need:

  1. Hgraph Publishable API Key (Free)

    • Create a free account at app.hgraph.com
    • Get your free Publishable API Key from the Hgraph App
    • Your Publishable Key starts with pk_prod_ (e.g., pk_prod_abc123xyz...)
    • No credit card required for the free tier

  2. ChatGPT Account

    • ChatGPT Plus subscription required for Developer Mode
    • Available at chat.openai.com

Set up in ChatGPT Web​

Follow these 5 steps to connect Hgraph to ChatGPT:

Step 1: Get Your Hgraph Publishable API Key​

Sign in to the Hgraph App, go to Projects in the sidebar, open your project, and copy your Publishable API Key (starts with pk_prod_).

Show me where to find my Publishable API Key

Go to Projects in the sidebar and open your project. In the API Keys section, click the eye icon to reveal the key's values, then click the copy icon next to the value starting with pk_prod_.

Step 2: Enable Developer Mode​

In ChatGPT, navigate to Settings → Apps & Connectors → Advanced Settings and toggle Developer Mode ON.

Show me how to enable Developer Mode

Opening Settings:

  1. Sign in to ChatGPT web
  2. Click your profile icon or menu (typically in the bottom left)
  3. Select "Settings" from the menu

Navigating to Developer Mode:

  1. In Settings, click "Apps & Connectors" in the left sidebar
  2. Scroll down to the "Advanced Settings" section at the bottom
  3. Find the "Developer Mode" toggle
  4. Toggle it ON (you'll see a warning about beta features)
  5. Click "Enable" to confirm

ChatGPT Settings showing Developer Mode toggle in Advanced Settings

Developer Mode is now enabled! You can now create custom MCP connectors.

Developer Mode Requirement

Developer Mode is a beta feature required to add custom MCP connectors. It's available for ChatGPT Plus, Business, Enterprise, and Education accounts.

Step 3: Navigate to Create Connector​

Go to Settings → Apps & Connectors → Create to add a new connector.

Show me where to find the Create button

Finding Create Connector:

  1. Make sure you're still in Settings
  2. Click "Apps & Connectors" in the left sidebar (if you navigated away)
  3. Near the top of the page, you'll see a "Create" button
  4. Click "Create" to open the connector creation form

ChatGPT Apps & Connectors page with Create button

The connector creation dialog will open.

Step 4: Configure Hgraph Connector​

Fill out the connector form with these exact details:

  • Name: Hgraph
  • MCP URL: https://mcp.hgraph.com/v1/YOUR_PUBLISHABLE_KEY/mcp
  • Authentication: Select "No Authentication"
    • The key in the URL is what authenticates the request, so ChatGPT doesn't need separate credentials
    • This is the correct setting for Hgraph MCP
Show me step-by-step with screenshots

Filling out the form:

  1. In the "Name" field, type exactly: Hgraph

  2. In the "MCP URL" field, paste: https://mcp.hgraph.com/v1/YOUR_PUBLISHABLE_KEY/mcp

    • Replace YOUR_PUBLISHABLE_KEY with your actual Publishable API Key (starts with pk_prod_)

  3. In the "Authentication" dropdown, select "No Authentication"

    • The Publishable Key in the URL is sufficient for authentication

Example URL:

https://mcp.hgraph.com/v1/pk_prod_abc123xyz789/mcp

ChatGPT Create connector dialog with Hgraph configuration

Creating the connector:

  1. Check the confirmation box (if required)
  2. Click "Create" to save the connector

Success! You should now see "Hgraph" in your connectors list.

Step 5: Test Your Setup​

Start a new chat, enable the Hgraph connector, and try this test query:

"Could you provide an overview of token 0.0.1055459?"

Show me what success looks like

When your MCP is working correctly, you'll see:

  1. ChatGPT will indicate it's using the Hgraph connector/tools
  2. You'll receive real Hedera token data in the response
  3. The response will include specific details about the token (name, symbol, supply, etc.)

ChatGPT showing successful token query response

Success indicator: You see real, current Hedera token data with specific numbers and details.

If not working: Check the troubleshooting section below.

For more example queries, see our Examples & Use Cases page.

Understanding What Just Happened​

Behind the scenes, your AI assistant called the Hgraph MCP Server, which queried the Hedera mirror node database to retrieve live token data. This same pattern works for any Hedera entity, metric, or blockchain query you request.

The MCP automatically selected the optimal data source (GraphQL, SQL, or RPC) based on your question type—no manual configuration needed.

Mobile Support

Once configured in ChatGPT web, the connector syncs to mobile apps automatically. Note: Mobile apps inherit settings but may have limited features compared to desktop.

Important Notes​

ChatGPT Platform Limitations
  • MCP connectors do not work in ChatGPT's Deep Research mode
  • MCP connectors do not currently work in the ChatGPT Desktop app

Security Considerations​

  • ChatGPT cannot modify or write data - all operations are read-only
  • The MCP server only accesses publicly available blockchain data
  • Your API key is included in the URL for authentication. Treat that URL as a credential. Both of a key's values (pk_prod_ and sk_prod_) currently grant the same access, so the connector URL carries full read access to your account's data under your plan's limits — don't share it, screenshot it, or commit it anywhere public.
  • Requests are attributed to your key and rate-limited by your plan, so a shared URL also consumes your quota.

Troubleshooting​

Developer Mode not available​

Ensure you have an active ChatGPT Plus subscription (or Business/Enterprise/Education plan).

Connector creation fails​

  • Verify your Publishable API Key is correct (starts with pk_prod_)
  • Ensure "No Authentication" is selected in the dropdown

Connector not working in chat​

  • Verify Developer Mode is still enabled in settings
  • Ensure you're not in Deep Research mode (MCP not supported)

Still not working?​

If issues persist after verifying the steps above:

  1. Recheck the URL and key: Confirm the connector URL is exactly https://mcp.hgraph.com/v1/YOUR_KEY/mcp, with your real publishable key (starts with pk_prod_) in place of YOUR_KEY.
  2. Check API key status: Visit Hgraph App → Projects → your project and confirm the key is still there. For programmatic ways to test a key, see API Key Access.
  3. Get help: Contact support or join our Discord community

Next Steps​

Now that your Hgraph MCP is set up, explore what you can do:

Need help? Visit our support page or join our Discord community