# Keenable MCP

> Keenable MCP tools reference and setup - Instant web search and page reading on Keenable's own index with no key needed, plus Time Machine and SELECT on your own Keenable key.

Web search and page reading on Keenable's own index. **Instant**: search and
fetch run on FlyMyAI's key, so an agent uses them with no Keenable account and
no key from you. Time Machine (the web as it was on a past date) and SELECT (one
SQL query over live web results) work with your own Keenable key.

Product page: [flymy.ai/mcp/keenable](https://flymy.ai/mcp/keenable/)

## What it can do

| Method | What it does |
| --- | --- |
| `keenable_search` | Ranked pages with title, url, snippet and dates, filtered by site, excluded hosts, publish date or index date. Mode `pro` searches deeper, `realtime` is the fastest. Instant. |
| `keenable_fetch` | One web page as clean markdown with its title, author and publish date, or only the part a prompt asks for. `live: true` fetches it from the source now. Instant. |
| `keenable_time_machine_search` | Search the web as it was at a past moment, `query_time`: every result is a version captured at or before it (experimental). Needs your own key, with Time Machine turned on for its Keenable organization. |
| `keenable_time_machine_fetch` | Read one page as it was at a past moment (experimental). Needs your own key, with Time Machine turned on. |
| `keenable_select` | One read-only SQL SELECT over live web search results, returned as a table. A query takes seconds to minutes. Needs your own key. |
| `keenable_select_tools` | The SELECT server's tools with their usage guide and argument schemas. Needs your own key. |
| `keenable_select_generate_report` | Build a shareable page, an unlisted link, from a brief and earlier SELECT result sets. Needs your own key. |
| `keenable_select_revoke_report` | Turn a report link off again. Needs your own key. |

## Prices

Instant calls are billed to your FlyMyAI balance at Keenable's own price, never
below the call's compute time. A call on your own Keenable key uses your own
Keenable plan, and FlyMyAI bills only its compute time.

| Method | Cost |
| --- | --- |
| `keenable_search`, `keenable_fetch` | Keenable's own price: nothing while Keenable's free monthly allowance covers the call, then $0.004 per request, plus compute time |
| Every other method | Your own Keenable key and plan, plus compute time |

## Use it as an agent's web search

Keenable is also one of the engines of an agent's web search. Set the agent's
`web_search` to `keenable` in the app's search picker, or through
`update_agent` and `list_web_search_engines` on the Agents MCP.

## How to get credentials

None for search and fetch: they run on FlyMyAI's key.

To use Time Machine or SELECT, or to run search and fetch on your own Keenable
account:

1. Sign up at [app.keenable.ai](https://app.keenable.ai/signup).
2. Open the [console](https://app.keenable.ai/console) and create an **API key**
   (it starts with `keen_`).
3. Paste it into the Keenable connection in FlyMyAI.

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `Keenable API key` (optional) | app.keenable.ai -> Console -> API keys; leave empty to use FlyMyAI's key for search and fetch |

## Troubleshooting

- **401** - the key is wrong or revoked. Create a new one in the Keenable console.
- **402** - the Keenable account is out of credits: buy credits in the console or
  wait for the monthly allowance to reset.
- **403 Feature not enabled** - Time Machine is turned on per Keenable
  organization. Ask Keenable support to enable it.
- **429** - Keenable is rate limiting the calls. The answer says how many
  seconds to wait.
- **SELECT is slow** - a query that fetches many pages takes minutes. Send a
  smaller one.

## Links

- [Keenable console](https://app.keenable.ai/console)
- [Keenable API reference](https://docs.keenable.ai/api-reference)
- [Keenable docs](https://docs.keenable.ai/)
