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

# HTTP Tools

> How to Use HTTP Tools in AI21 Studio 

HTTP tools allow AI21 Maestro to call external services directly using standard HTTP requests.  They’re best for simple or one-off integrations that don’t require a full MCP server.\
Follow these steps to give your agent access to external APIs.

### Step 1: **Go to the Playground Section**

<Expandable title="Content">
  Navigate to Maestro [**Playground**](https://studio.ai21.com/v2?tab=maestro) from the left-hand menu in AI21 Studio.

  <img src="https://mintcdn.com/ai21-demo/LNlHHKfViioyL7qE/Step1GotothePlaygroundSection.png?fit=max&auto=format&n=LNlHHKfViioyL7qE&q=85&s=cd37a1abd98d3b0593ce7cb5aff9a18f" alt="Dataconnectorsallscreen Pn" width="1498" height="709" data-path="Step1GotothePlaygroundSection.png" />
</Expandable>

### Step 2: Add a Tool

<Expandable title="Content">
   In the **Configuration** panel, go to the **Tools** section and click **Add**.

  <img src="https://mintcdn.com/ai21-demo/LNlHHKfViioyL7qE/images/Step2AddaTool.png?fit=max&auto=format&n=LNlHHKfViioyL7qE&q=85&s=9411bc6315736e17e3397d6a9f6e8e8d" alt="Step2adda Tool Pn" width="1489" height="722" data-path="images/Step2AddaTool.png" />
</Expandable>

### **Step 3: Select HTTP Tools**

<Expandable title="Content">
  In the tools dropdown, select **MCP**.

  <img src="https://mintcdn.com/ai21-demo/9Ke9pWofpjOWYHs4/images/Step3SelectHTTPTools.png?fit=max&auto=format&n=9Ke9pWofpjOWYHs4&q=85&s=d96752d22134f2389c7b27ee9b57d403" alt="Step3select HTTP Tools Pn" width="1476" height="718" data-path="images/Step3SelectHTTPTools.png" />
</Expandable>

### **Step 4: Fill in the Fields**

<Expandable title="Content">
  **4.1 Define the JSON Schema**\
  Provide the **JSON schema** that describes the API operation you want to connect.

  * This schema defines the function name, description, parameters, and their types.
  * Use the exact schema of the API you want your agent to call.

      <img src="https://mintcdn.com/ai21-demo/T3wZYubxawXoGbLB/images/4.1DefinetheJSONSchema.png?fit=max&auto=format&n=T3wZYubxawXoGbLB&q=85&s=7b2d6d2801bdb3baba1d8e74c62cf6b7" alt="4 1definethe JSON Schema Pn" width="1340" height="766" data-path="images/4.1DefinetheJSONSchema.png" />

  **4.2 Enter the URL**\
  Add the **API endpoint URL** that the tool should call.\
  Use the full URL, for example: `https://api.example.com/weather`.

  <img src="https://mintcdn.com/ai21-demo/T3wZYubxawXoGbLB/images/4.2EntertheURL.png?fit=max&auto=format&n=T3wZYubxawXoGbLB&q=85&s=4062f5af3da053622f97b3a4735dd281" alt="4 2enterthe URL Pn" width="1343" height="769" data-path="images/4.2EntertheURL.png" />

  **4.3 Add the Authorization Header** \
  If your API requires authentication, enter the **authorization header** \
  (for example, `Bearer {api_key}`).

  <Note>
    AI21 Maestro does not store your API credentials or any provided header.
  </Note>

  <img src="https://mintcdn.com/ai21-demo/T3wZYubxawXoGbLB/images/4.3AddtheAuthorizationHeader.png?fit=max&auto=format&n=T3wZYubxawXoGbLB&q=85&s=801153cdcd0400490695b9f9ddeb3c8d" alt="4 3addthe Authorization Header Pn" width="1343" height="774" data-path="images/4.3AddtheAuthorizationHeader.png" />
</Expandable>

### **Step 5: Add the HTTP Tool**

<Expandable title="Content">
  After verifying the tools are correct, click **Add**.

  <img src="https://mintcdn.com/ai21-demo/FkHYJqvPpCpd1Umx/images/Step5AddtheHTTPTool.png?fit=max&auto=format&n=FkHYJqvPpCpd1Umx&q=85&s=27a1ea80995ebbfe5885c3a150685521" alt="Step5addthe HTTP Tool Pn" width="1475" height="770" data-path="images/Step5AddtheHTTPTool.png" />
</Expandable>

### **Step 6 (Optional): Edit HTTP Tools**

<Expandable title="Content">
  Edit an existing MCP tool by following these steps:

  1. Click the **⋮** (colon icon).
  2. Select **Edit**, make your changes, and click **Save.**

  <img src="https://mintcdn.com/ai21-demo/1c9AiCFNhfpxWOZR/images/EditMCPTools1.png?fit=max&auto=format&n=1c9AiCFNhfpxWOZR&q=85&s=0c7cf19e079c139aac6c5ee3f22bfb0b" alt="Edit MCP Tools1 Pn" width="871" height="576" data-path="images/EditMCPTools1.png" />

  <img src="https://mintcdn.com/ai21-demo/ub4x4Unil0hBEfe0/images/edirhttp.png?fit=max&auto=format&n=ub4x4Unil0hBEfe0&q=85&s=764d9385b055eda342475d500b8155a8" alt="Edirhttp Pn" width="637" height="479" data-path="images/edirhttp.png" />
</Expandable>

### Next Steps

Use HTTP tools in [AI21 Stuido](https://studio.ai21.com/v2?tab=maestro).
