# OKF Index MCP server

> Search Open Knowledge Format bundles and read published knowledge bases as Markdown.

- Listing: https://mcp.tc/i/okf-index
- Connect: use the server's own URL `https://okfindex.com/mcp` (no sign-in); clients connect to it directly. The listing link is a page, not an MCP endpoint.
- Type: remote (Streamable HTTP)
- Auth: none
- Category: [Docs & Knowledge](https://mcp.tc/c/docs-knowledge)
- Vendor: OKF Index (WRP Consultoria e Informática)
- Homepage: <https://okfindex.com>

## About

OKF Index is a public index of Open Knowledge Format (OKF) bundles and knowledge bases. The tools search bundles, read bundle cards, and list, search and read published bases, documents, concepts and sources. Bundle owners can also submit bundle URLs for indexing using IndexNow key verification.

It runs as a hosted streamable HTTP endpoint at https://okfindex.com/mcp. No sign-in or API key is needed for the public tools. Account tools appear only when the connection sends an account session or API key. Tools are free within their stated limits.

## What it can do

- Search OKF bundles by text, origin, language, license and concept count
- Read a bundle card with version, concept count and provenance
- List and search published knowledge bases and their documents
- Read document Markdown, concepts, sources and original files
- Read published collections and search their references
- Submit bundle URLs from a host you own via IndexNow

## Tools (115)

- `api_index`: Index of the OKF Index API: routes, quota and how to plug in the MCP. (read-only)
- `search_bundles`: Search live OKF bundles by text, origin, repo, version, language, license, type or concepts. (read-only)
- `get_bundle`: Get one bundle's card: root index URL, version, concept count, provenance. (read-only)
- `index_stats`: Size of the index by provenance and when it last changed. (read-only)
- `legislation_status`: Read Brazilian federal corpus coverage and synchronization status. (read-only)
- `search_legislation`: Search Brazilian federal laws by number/year or full-text words. (read-only)
- `get_legislation`: Read a law's first part, original-source links, download date and part count. (read-only)
- `get_legislation_part`: Read one law text part. (read-only)
- `list_bases`: List bases in your personal account. (read-only)
- `create_base`: Create a private base.
- `publish_base`: Publish the current files in your base.
- `unpublish_base`: Make your published base private. (can modify or delete data)
- `get_base`: Read your base and its documents. (read-only)
- `get_base_usage`: Read your base's search and document-read counts for the last 30 days. (read-only)
- `list_base_documents`: List the documents in your base. (read-only)
- `get_base_connection`: Read the connected source and its last check. (read-only)
- `connect_base_source`: Connect one public Markdown source to your base.
- `disconnect_base_source`: Stop source updates and keep the last document. (can modify or delete data)
- `search_base`: Search the full text of your base. (read-only)
- `add_base_document`: Import one Markdown or TXT file.
- `replace_base_document`: Replace your document after reviewing the new text. (can modify or delete data)
- `remove_base_document`: Archive your document and end public access. (can modify or delete data)
- `get_base_document`: Read the document Markdown and metadata. (read-only)
- `read_base_markdown`: Download document Markdown. (read-only)
- `read_base_original`: Download the original file. (read-only)
- `read_base_image`: Download a verified image from the document. (read-only)
- `read_base_index`: Read the private OKF root index. (read-only)
- `read_base_concept`: Read an OKF concept with source and hash. (read-only)
- `read_base_source`: Read the original source linked by the OKF concept. (read-only)
- `read_base_pdf_source`: Download the PDF source linked by the OKF concept. (read-only)
- `read_base_docx_source`: Download the DOCX source linked by the OKF concept. (read-only)
- `read_base_doc_source`: Download the DOC source linked by the OKF concept. (read-only)
- `export_base`: Get the private OKF ZIP download. (read-only)
- `restore_base_version`: Restore one retained version as current.
- `delete_base_document_permanently`: Permanently delete one personal document and all its retained versions.
- `list_base_history`: Export one page of private document history, including archived versions. (read-only)
- `get_base_version`: Read one retained document version. (read-only)
- `read_base_version_original`: Download the original of a retained version. (read-only)
- `read_base_version_markdown`: Download the text of a retained version. (read-only)
- `read_base_version_concept`: Download this version's OKF concept and source hash. (read-only)
- `read_base_version_conversion`: Export the saved manifest, quote and processing result for a retained converted version. (read-only)
- `read_base_version_image`: Download a verified image from a retained version. (read-only)
- `quote_base_document`: Upload PDF, DOCX or DOC and get its conversion quote.
- `list_base_conversions`: List saved conversions in your base. (read-only)
- `get_base_conversion`: Read the quote and saved conversion state. (read-only)
- `remove_base_conversion`: Remove an unauthorized quote. (can modify or delete data)
- `authorize_base_conversion`: Authorize the quoted price and queue conversion.
- `ask_base_question`: Ask a question with sources from your base.
- `get_base_answer`: Read an answer and its source versions. (read-only)
- `save_base_dataset`: Store a dataset description in your own base. (can modify or delete data)
- `public_list_bases`: List published bases by name or author. (read-only)
- `public_get_base`: Read a published base and its documents. (read-only)
- `public_list_base_documents`: List the documents in a published base. (read-only)
- `public_search_base`: Full-text search inside a published base. (read-only)
- `public_get_base_document`: Read a document's Markdown and metadata. (read-only)
- `public_read_base_markdown`: Download document Markdown. (read-only)
- `public_read_base_original`: Download the original file of a document. (read-only)
- `public_read_base_image`: Download a verified image from a document. (read-only)
- `public_read_base_index`: Read the published OKF root index of a base. (read-only)
- `public_read_base_concept`: Read an OKF concept with its source and hash. (read-only)
- `public_read_base_source`: Read the original source linked by an OKF concept. (read-only)
- `public_read_base_pdf_source`: Download the PDF source linked by an OKF concept. (read-only)
- `public_read_base_docx_source`: Download the DOCX source linked by an OKF concept. (read-only)
- `public_read_base_doc_source`: Download the DOC source linked by an OKF concept. (read-only)
- `public_export_base`: Get the published OKF ZIP download of a base. (read-only)
- `favorite_ids`: List your favorite bundle IDs. (read-only)
- `favorite_bundles`: Search your favorite bundles. (read-only)
- `save_favorite`: Save a bundle to your private favorites (up to 200).
- `remove_favorite`: Remove a bundle from your private favorites. (can modify or delete data)
- `list_collections`: List collections in your personal account. (read-only)
- `create_collection`: Create a private collection of base references.
- `get_collection`: Read your collection and accessible base references. (read-only)
- `search_collection`: Search documents across bases in your collection. (read-only)
- `save_collection_base`: Save an owned or public base in your collection. (can modify or delete data)
- `remove_collection_base`: Remove a base reference and its collection search results. (can modify or delete data)
- `publish_collection`: Publish references to currently public bases.
- `unpublish_collection`: Withdraw the collection page and public search. (can modify or delete data)
- `remove_collection`: Delete your collection and its references only. (can modify or delete data)
- `public_get_collection`: Read a published collection without an account. (read-only)
- `public_search_collection`: Search the references of a public collection. (read-only)
- `team_list_bases`: List bases in your personal account. (read-only)
- `team_get_base`: Read your base and its documents. (read-only)
- `team_list_base_documents`: List the documents in your base. (read-only)
- `team_search_base`: Search the full text of your base. (read-only)
- `team_get_base_document`: Read the document Markdown and metadata. (read-only)
- `team_read_base_markdown`: Download document Markdown. (read-only)
- `team_read_base_original`: Download the original file. (read-only)
- `team_read_base_image`: Download a verified image from the document. (read-only)
- `team_read_base_index`: Read the private OKF root index. (read-only)
- `team_read_base_concept`: Read an OKF concept with source and hash. (read-only)
- `team_read_base_source`: Read the original source linked by the OKF concept. (read-only)
- `team_read_base_pdf_source`: Download the PDF source linked by the OKF concept. (read-only)
- `team_read_base_docx_source`: Download the DOCX source linked by the OKF concept. (read-only)
- `team_read_base_doc_source`: Download the DOC source linked by the OKF concept. (read-only)
- `team_export_base`: Get the private OKF ZIP download. (read-only)
- `team_get_base_answer`: Read an answer and its source versions. (read-only)
- `team_list_collections`: List collections in your personal account. (read-only)
- `team_get_collection`: Read your collection and accessible base references. (read-only)
- `team_search_collection`: Search documents across bases in your collection. (read-only)
- `list_knowledge_teams`: List your organizations with OKFIndex enabled. (read-only)
- … and 15 more on the listing page.

## Example prompts

- "Search OKF Index for bundles about Kubernetes"
- "Show the bundle card for this OKF bundle and its concept count"
- "Search the published base for documents about refund policy"
- "Read the Markdown of this document from a published base"

## Install

### Claude Code

1. Run this in a terminal, in your project folder:

```bash
claude mcp add --transport http okf-index https://okfindex.com/mcp
```

2. Start Claude Code and type `/mcp`. **okf-index** should show as connected.

Add `--scope user` to make it available in every project, not just this one.

### Claude Desktop

1. Open **Customize → Connectors**, click **+ Add**, then **Add custom connector**.

2. Name it **OKF Index** and paste this URL:

```url
https://okfindex.com/mcp
```

3. Click **Add**. Its tools appear in the chat’s tools menu.

Claude Desktop’s JSON config file only starts local servers. Remote servers go through Connectors, and connectors you add on claude.ai show up here too.

### claude.ai

1. Open the connector form on claude.ai. This button fills in the name and URL for you:

[Add to claude.ai](<https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=OKF%20Index&connectorUrl=https%3A%2F%2Fokfindex.com%2Fmcp>) (opens connector settings)

2. Check that the URL reads `https://okfindex.com/mcp` and click **Add**.

3. Turn it on in a chat from the tools menu.

Free plans allow one custom connector. On Team and Enterprise plans an owner adds it under **Organization settings → Connectors**.

### ChatGPT

1. On chatgpt.com, go to **Plugins**, select **+**, then **Add custom MCP server**.

2. Enter a name for the server.

3. Under **Connection**, paste `https://okfindex.com/mcp` as the server URL, then for authentication choose **No authentication**.

4. Check **I understand and want to continue**, then select **Create as a plugin**.

Whether you can add a custom MCP server depends on your ChatGPT plan and your workspace permissions (in Business workspaces, admins and owners can).

### Cursor

[Add to Cursor](<https://cursor.com/install-mcp?name=okf-index&config=eyJ1cmwiOiJodHRwczovL29rZmluZGV4LmNvbS9tY3AifQ%3D%3D>) (opens Cursor)

Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project):

`mcp.json`:

```json
{
  "mcpServers": {
    "okf-index": {
      "url": "https://okfindex.com/mcp"
    }
  }
}
```

### VS Code

[Install in VS Code](<https://vscode.dev/redirect/mcp/install?name=okf-index&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fokfindex.com%2Fmcp%22%7D>) (opens VS Code)

Or from a terminal:

```bash
code --add-mcp '{"name":"okf-index","type":"http","url":"https://okfindex.com/mcp"}'
```

Or commit it to the repo in `.vscode/mcp.json`:

`.vscode/mcp.json`:

```json
{
  "servers": {
    "okf-index": {
      "type": "http",
      "url": "https://okfindex.com/mcp"
    }
  }
}
```

### Devin Desktop

1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows):

`mcp_config.json`:

```json
{
  "mcpServers": {
    "okf-index": {
      "serverUrl": "https://okfindex.com/mcp"
    }
  }
}
```

2. Refresh the MCP server list in Cascade.

Devin Desktop is the new name for Windsurf. It reads `serverUrl` (or `url`) for remote servers.

### Codex

```bash
codex mcp add okf-index --url https://okfindex.com/mcp
```

Or edit `~/.codex/config.toml` directly:

`config.toml`:

```toml
[mcp_servers.okf-index]
url = "https://okfindex.com/mcp"
```

### Gemini CLI

```bash
gemini mcp add --transport http okf-index https://okfindex.com/mcp
```

This adds it to the current project. Add `-s user` to use it everywhere.

### Any client

Most clients accept this shape. Some name the URL field differently: `serverUrl` in Devin Desktop, `httpUrl` in Gemini CLI’s settings file.

```json
{
  "mcpServers": {
    "okf-index": {
      "type": "http",
      "url": "https://okfindex.com/mcp"
    }
  }
}
```

Zed puts servers under `context_servers` in its settings. Cline needs `"type": "streamableHttp"`, or it assumes SSE.

Client only starts local servers? Bridge it with `npx -y mcp-remote https://okfindex.com/mcp`.

## Recent changes

- 2026-11-12 23:34 UTC: 9 tools added and 31 tools changed. Source: automatic check. Added: delete\_base\_document\_permanently, get\_base\_version, list\_base\_history, read\_base\_version\_concept, read\_base\_version\_conversion, read\_base\_version\_image, read\_base\_version\_markdown, read\_base\_version\_original, restore\_base\_version. Changed: add\_base\_document, connect\_base\_source, create\_base, disconnect\_base\_source, export\_base, get\_base, get\_base\_connection, get\_base\_document, get\_base\_usage, list\_base\_conversions, list\_base\_documents, list\_bases, public\_export\_base, public\_read\_base\_index, publish\_base, read\_base\_concept, read\_base\_doc\_source, read\_base\_docx\_source, read\_base\_image, read\_base\_index and 11 more.
- 2026-11-10 17:55 UTC: 1 tool removed and 1 tool changed. Source: automatic check. Removed: billing. Changed: pricing.
- 2026-11-05 05:53 UTC: 3 tools changed. Source: automatic check. Changed: authorize\_base\_conversion, create\_base, save\_base\_dataset.
- 2026-11-04 02:48 UTC: Server instructions changed. Source: automatic check. Worth a look: new server instructions.
- 2026-11-01 17:49 UTC: 2 tools changed. Server instructions changed. Source: automatic check. Worth a look: new server instructions. Changed: get\_api\_x402\_legislation, list\_bases.

More on the History tab, with descriptions before and after for the newest entries: https://mcp.tc/i/okf-index#history (Atom feed: https://mcp.tc/i/okf-index/history.xml). It records what mcp.tc's anonymous checks saw, every 3 hours where the tool list can be read without sign-in; it is not a security review.

## Details

- Server version: 56837557
- MCP protocol version: 2025-06-18
- Last checked: 2026-11-15 (reachable)
- Listed: 2026-10-15
- Updated: 2026-11-12

---
Source: https://mcp.tc/i/okf-index (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report