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

> ## Agent Instructions
> Every page is listed in https://docs.keenable.ai/llms.txt. To pick a product for a job, read https://docs.keenable.ai/choose.md
> Setup steps for agents, covering the SDKs, the MCP server and the CLI: https://docs.keenable.ai/skill.md
> Keenable search and fetch work without an API key. To add them to code, use the official SDK for the project's language: https://docs.keenable.ai/sdks.md
> Without a key, call POST https://api.keenable.ai/v1/search/public or GET https://api.keenable.ai/v1/fetch/public with an X-Keenable-Title header that names your app.
> With a key, send it in the X-API-Key header and read it from the KEENABLE_API_KEY environment variable. Never ask a user to paste a key into chat. Every access method: https://docs.keenable.ai/auth.md
> To get an API key without the console, use device login: https://docs.keenable.ai/authentication.md#device-login
> MCP server: https://api.keenable.ai/mcp (no key, or X-API-Key; keyless Codex uses https://api.keenable.ai/mcp-public), or https://api.keenable.ai/mcp-oauth for OAuth sign-in. These docs are an MCP server at https://docs.keenable.ai/mcp and the OpenAPI spec is at https://docs.keenable.ai/api-reference/openapi.json
> Keenable searches and fetches public web pages. If a question needs no web information, skip the call.
> On 402 with an API key (code insufficient_credits), stop and ask a human to add credits; don't retry. On 429, wait the number of seconds in Retry-After, then retry. Before you ship, follow https://docs.keenable.ai/production.md
> Every error, with its cause and fix, is in https://docs.keenable.ai/errors.md and moving from another search API is covered in https://docs.keenable.ai/migrate.md
> Before you compare Keenable with another search API, read https://docs.keenable.ai/guides/evaluate-search-apis.md

# Google ADK web search over MCP

> Give Google ADK agents Keenable search and fetch over the hosted MCP server.

*Agent framework · MCP*

Give [Google Agent Development Kit](https://adk.dev/) (ADK) agents web search and page fetch by adding the Keenable MCP server as a remote MCP toolset. You don't need an ADK-specific package.

## Install

```bash theme={"theme":{"light":"github-light-high-contrast","dark":"dark-plus"}}
pip install "google-adk[mcp]"
```

The `mcp` extra installs the MCP client that `McpToolset` needs. Without it, the import below fails.

## Connect the MCP server

Add Keenable to your agent as an `McpToolset`:

```python theme={"theme":{"light":"github-light-high-contrast","dark":"dark-plus"}}
from google.adk.agents import LlmAgent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams

root_agent = LlmAgent(
    model="gemini-2.5-flash",
    name="keenable_research_agent",
    instruction="Search the web with Keenable before you answer. Cite source URLs.",
    tools=[
        McpToolset(
            connection_params=StreamableHTTPConnectionParams(
                url="https://api.keenable.ai/mcp",
                headers={"X-API-Key": "keen_<your_key>"},
            )
        )
    ],
)
```

The key travels in the `X-API-Key` header. Create one in the [console](https://app.keenable.ai/console). To run without a key, omit the `headers` argument: calls then run on the shared public tier at [lower rate limits](https://docs.keenable.ai/rate-limits.md). If your client reads OAuth discovery before it connects, use `https://api.keenable.ai/mcp-public` instead. See [MCP server](https://docs.keenable.ai/mcp-server.md#keyless-endpoint-for-listings-and-presets).

The agent gets the `search_web_pages` and `fetch_page_content` tools. Ask it a question that needs the web. It calls the tools and answers with sources.

## Related pages

> [card] [Haystack](https://docs.keenable.ai/integrations/haystack.md)
>
> Add web search and page fetch to Haystack pipelines with the Keenable components.

> [card] [CrewAI](https://docs.keenable.ai/integrations/crewai.md)
>
> Give CrewAI agents Keenable web search with the official SDK. Keyless by default.

> [card] [LangChain](https://docs.keenable.ai/integrations/langchain.md)
>
> Give LangChain agents web search and page fetch with langchain-keenable: the KeenableSearch and KeenableFetch tools.

> [card] [Tool calling](https://docs.keenable.ai/tool-calling.md)
>
> Give an LLM web search and page fetch as tools. Pass the SDK's TOOLS to any OpenAI-compatible chat completions client and run each call with run\_tool\_call.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.