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

# Tavily

> AI-optimized web search and content extraction — give your agents fast, accurate answers from the web through Mantle

Connect your Tavily API key and equip your AI agents with search built specifically for AI use cases. Tavily returns
clean, relevant results optimized for language models — including direct answers, extracted content, and site crawling.

***

## What you unlock

<CardGroup cols={2}>
  <Card title="AI-powered search" icon="magnifying-glass">
    Search the web with results optimized for AI consumption — clean, structured, and relevant.
  </Card>

  <Card title="Direct answers" icon="message-check">
    Get concise answers to questions directly from search results, without manually parsing pages.
  </Card>

  <Card title="Content extraction" icon="file-import">
    Extract full content from any URL — articles, documentation, product pages — ready for AI analysis.
  </Card>

  <Card title="Site crawling" icon="sitemap">
    Crawl and map website content to build context for your agent's research and analysis tasks.
  </Card>
</CardGroup>

***

## Connect Tavily

<Steps>
  <Step title="Open Settings → Integrations">
    In any workspace go to **Settings → Integrations** and select **Tavily**.
  </Step>

  <Step title="Get your API key">
    Sign up or log in at [tavily.com](https://tavily.com), go to your dashboard, and copy your API key.
  </Step>

  <Step title="Paste and connect">Paste the key into the **API Key** field and click **Connect**.</Step>
</Steps>

***

## Agent tools

Add Tavily tools to agents that need them. Their access is limited by the connected key and selected tools.

### Search

| Tool            | Description                                               |
| --------------- | --------------------------------------------------------- |
| Search          | Run a general AI-optimized web search                     |
| Basic search    | Quick search returning concise results                    |
| Advanced search | In-depth search with more results and context             |
| Q\&A search     | Search optimized for direct question-and-answer responses |

### Content Extraction

| Tool        | Description                                       |
| ----------- | ------------------------------------------------- |
| Extract     | Extract structured content from a URL             |
| Extract URL | Extract the full text content from a specific URL |

### Crawling & Mapping

| Tool  | Description                                    |
| ----- | ---------------------------------------------- |
| Crawl | Crawl a website and extract content from pages |
| Map   | Map the URL structure of a website             |

### Usage

| Tool      | Description                                       |
| --------- | ------------------------------------------------- |
| Get usage | Check your Tavily API usage and remaining credits |

***

## Triggers

<Note>
  Automated triggers for Tavily are not yet available. Triggers will be added in a future update — check back soon.
</Note>

***

## Example use cases

<AccordionGroup>
  <Accordion title="Answer questions with real-time web data">
    Ask your agent any factual question and it uses Tavily's Q\&A search to find and return a direct answer from the web
    — grounded in real sources rather than relying solely on training data.
  </Accordion>

  <Accordion title="Research and summarize a topic">
    Ask "Research the latest developments in edge computing" and the agent runs an advanced search, extracts content
    from the top results, and synthesizes a comprehensive summary.
  </Accordion>

  <Accordion title="Extract article content for analysis">
    Share a URL in chat and ask your agent to extract the full content. It pulls the article text, metadata, and key
    points — ready for summarization, translation, or further analysis.
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="My API key isn't working">
    Verify the key was copied from your Tavily dashboard at [tavily.com](https://tavily.com) and your account is active.
    Generate a fresh key if the current one doesn't work.
  </Accordion>

  <Accordion title="Search returns irrelevant results">
    Try refining your query with more specific terms. Tavily works best with clear, well-formed questions rather than
    single keywords. Use the advanced search for more comprehensive results.
  </Accordion>

  <Accordion title="Content extraction fails for some URLs">
    Some websites block automated access or require authentication. Tavily can only extract content from publicly
    accessible pages. Try a different source URL if extraction fails.
  </Accordion>

  <Accordion title="Usage limits reached">
    Check your remaining credits with "Get usage". Tavily has monthly usage limits based on your plan. Upgrade at
    [tavily.com](https://tavily.com) if you need more capacity.
  </Accordion>
</AccordionGroup>

***

<Card title="Back to Integrations" icon="plug" href="/integrations/overview">
  View all available integrations
</Card>