> ## 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

# mcporter web search over MCP

> Call Keenable web search and page fetch from the mcporter CLI and runtime: one keenable entry in mcporter.json, with no API key required.

*MCP server in mcporter*

[mcporter](https://github.com/openclaw/mcporter) is a CLI and TypeScript runtime for calling MCP servers. Add the Keenable [MCP server](https://docs.keenable.ai/mcp-server.md) to its config and you can call `search_web_pages` and `fetch_page_content` from the terminal or a script, with no API key. mcporter ships a ready-made Keenable config in its repository.

→ [mcporter's Keenable guide](https://github.com/openclaw/mcporter/blob/main/docs/keenable-search.md) · [The example config](https://github.com/openclaw/mcporter/blob/main/examples/keenable-search/mcporter.json)

## Install

mcporter needs Node 24 or newer for npm installs:

```bash theme={"theme":{"light":"github-light-high-contrast","dark":"dark-plus"}}
npm install -g mcporter
```

To try it without installing, put `npx` in front of each `mcporter` command below. On macOS, `brew install steipete/tap/mcporter` also works.

## Add the server

Save this as `mcporter.json`. It registers a server named `keenable` at `https://api.keenable.ai/mcp`, and `imports: []` keeps mcporter from pulling in servers from your editors' configs:

```json mcporter.json theme={"theme":{"light":"github-light-high-contrast","dark":"dark-plus"}}
{
  "mcpServers": {
    "keenable": {
      "description": "Keenable web search and page fetching without an API key.",
      "baseUrl": "https://api.keenable.ai/mcp",
      "headers": {
        "X-Keenable-Title": "mcporter"
      }
    }
  },
  "imports": []
}
```

The `X-Keenable-Title` header names the calling app. To use Keenable next to other servers, copy the `keenable` entry into your existing `mcpServers` map instead, and keep your own `imports` setting.

List the tools to check the connection:

```bash theme={"theme":{"light":"github-light-high-contrast","dark":"dark-plus"}}
mcporter --config mcporter.json list keenable --schema
```

You see `search_web_pages` and `fetch_page_content` with their arguments, such as `site` and `published_after`.

## Search and fetch

Search for sources, then fetch one page as markdown:

```bash theme={"theme":{"light":"github-light-high-contrast","dark":"dark-plus"}}
mcporter --config mcporter.json call keenable.search_web_pages \
  --args '{"query":"Model Context Protocol official documentation","max_results":5}'

mcporter --config mcporter.json call keenable.fetch_page_content \
  --args '{"url":"https://modelcontextprotocol.io/"}'
```

The search prints a title, URL and snippet for each result. The fetch prints the page as markdown. Add `--output json` when a script reads the results. Every argument is in the [tool reference](https://docs.keenable.ai/mcp-server.md#search_web_pages).

## Add an API key

A key removes the hourly cap. Add it as an environment variable placeholder. mcporter fills it in when it connects, and stops with the variable's name if it's unset:

```json mcporter.json theme={"theme":{"light":"github-light-high-contrast","dark":"dark-plus"}}
{
  "mcpServers": {
    "keenable": {
      "baseUrl": "https://api.keenable.ai/mcp",
      "headers": {
        "X-Keenable-Title": "mcporter",
        "X-API-Key": "${KEENABLE_API_KEY}"
      }
    }
  }
}
```

| Key in the `keenable` entry | Value | What it does |
| - | - | - |
| `baseUrl` | `https://api.keenable.ai/mcp` | The Keenable MCP server. |
| `headers.X-Keenable-Title` | `mcporter` | Names the calling app. |
| `headers.X-API-Key` | `${KEENABLE_API_KEY}` | Optional. Your [API key](https://docs.keenable.ai/api-keys.md), read from the environment. With a key, the server also lists the [Monitors tools](https://docs.keenable.ai/mcp-server.md#monitors-tools). |

> [!NOTE]
>
> Without a key, calls run on the shared public tier at [lower rate limits](https://docs.keenable.ai/rate-limits.md).

## Related pages

> [card] [NVIDIA NeMo Agent Toolkit](https://docs.keenable.ai/integrations/nemo-agent-toolkit.md)
>
> Give NVIDIA NeMo Agent Toolkit agents web search and page fetch with the Keenable function group (keenable\_\_search, keenable\_\_fetch).

> [card] [Mastra](https://docs.keenable.ai/integrations/mastra.md)
>
> Give Mastra agents web search and page fetch with the @keenable/mastra package: the keenable-search and keenable-fetch tools.

> [card] [OctoTools](https://docs.keenable.ai/integrations/octotools.md)
>
> Give OctoTools solvers web search with Keenable\_Search\_Tool, a tool card in the OctoTools toolbox, with site and date filters and no API key.

> [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.