Back to Articles
Quickstart Guide
Tutorial
Getting Started

Quickstart Guide

Get started with JazzMCP quickly with this step-by-step guide to setting up and testing your first integration.

Quickstart Guide

1. Get an API Key

Sign in at dashboard.jazzmcp.com → API Keys.

Click Generate Key → copy the value (looks like sk-live-…).

Store it in a secret store or export for local testing:

export JAZZMCP_API_KEY="sk-live-0123456789abcdef"

2. Smoke Test with curl

curl -N -H "Authorization: Bearer $JAZZMCP_API_KEY" \
     https://mcp.jazzmcp.com/sse/list_tools

You should receive a JSON array that defines search_web, crawl_pages, and exec_py.

3. Hello-World with the OpenAI Agents SDK

from openai_agents import Agent, run
from openai_agents.tools.remote import McpServer
import os

mcp = McpServer(
    sse_params={
        "url":     "https://mcp.jazzmcp.com/sse",
        "headers": {"Authorization": f"Bearer {os.getenv('JAZZMCP_API_KEY')}"},
    }
)

assistant = Agent(
    model="o3",
    system="You are a concise research assistant.",
    tools=mcp.tools,                       # <- auto-imported tool list
)

print(run(assistant,
      "Search for 2025 electric-vehicle battery costs and plot them in Python"))

The agent will:

  • Call search_web to find data sources.
  • Use crawl_pages if it needs raw HTML.
  • Feed cleaned numbers into exec_py, streaming a Matplotlib chart back to you.