Skip to content

Plain-language README with a submission preview #8

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Ker102 merged 1 commit into from
Nov 5, 2026
Merged

Plain-language README with a submission preview #8

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
73 changes: 54 additions & 19 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,26 +1,57 @@
<p align="center"><img src="site/assets/mark.svg" width="70" alt="ToolIndex"></p>
<p align="center"><img src="site/assets/mark.svg" width="104" alt="ToolIndex logo"></p>
<h1 align="center">ToolIndex</h1>
<p align="center">A free directory of useful tools, where every listing links straight to its source.<br><sub>For anyone looking for apps, skills, MCP servers, CLIs and more, and for the people who make them.</sub></p>
<p align="center"><a href="README.md">English</a> · <a href="docs/i18n/es/README.md">Español</a> · <a href="docs/i18n/zh-CN/README.md">简体中文</a> · <a href="docs/i18n/fr/README.md">Français</a> · <a href="docs/i18n/ja/README.md">日本語</a> · <a href="docs/i18n/de/README.md">Deutsch</a> · <a href="docs/i18n/pt-BR/README.md">Português (Brasil)</a></p>
<p align="center">Tools for AI agents. Clear setup. Direct source links.</p>
<p align="center"><a href="https://toolindex.org/">toolindex.org</a> · <a href="https://toolindex.org/submit/">Submit a tool</a></p>

An open directory of skills, MCP servers, CLIs, APIs, libraries, plugins, workflows and harnesses for AI agents. Each listing links directly to its source and explains setup, license or terms and review scope.
<p align="center"><img src="https://raw.githubusercontent.com/OpenRootdev/toolindex/assets/preview.gif" width="760" alt="A tool is submitted to ToolIndex two ways: by filling in a short form, and by asking an AI agent. A person reviews it and it appears in the directory."></p>

## Accounts and submissions
<p align="center"><a href="https://toolindex.org/"><b>Browse tools</b></a> · <a href="https://toolindex.org/submit/">Submit a tool</a> · <a href="https://toolindex.org/developers/">For agents</a></p>

1. Create an account, verify your email and choose a creator handle. Customize your name, bio, website and optional avatar. You decide whether your profile is public and available for indexing.
2. Save a private tool draft in the UI, then request review. Images are optional. Follow status and feedback in your account. Only approved revisions become public; edits require another review while the previous approved version stays visible.
3. Connect an agent to the MCP endpoint. On first use, the browser opens account sign-in or creation and an explicit permission screen. The agent can manage your profile, drafts and review requests. It cannot approve or publish a submission.
<p align="center"><sub>Your agent can submit for you through MCP, for example from</sub><br><img src="https://raw.githubusercontent.com/OpenRootdev/toolindex/assets/brands/claude.svg" width="16" height="16" alt=""> Claude &nbsp; <picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/OpenRootdev/toolindex/assets/brands/openai-dark.svg"><img src="https://raw.githubusercontent.com/OpenRootdev/toolindex/assets/brands/openai.svg" width="16" height="16" alt=""></picture> Codex &nbsp; <picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/OpenRootdev/toolindex/assets/brands/cursor-dark.svg"><img src="https://raw.githubusercontent.com/OpenRootdev/toolindex/assets/brands/cursor.svg" width="16" height="16" alt=""></picture> Cursor</p>

[Account](https://toolindex.org/account/) · [Creators](https://toolindex.org/people/) · [MCP](https://toolindex.org/developers/)
## What it does

## Public discovery
ToolIndex lists tools that people and AI agents can use, from browser apps to agent skills and command-line tools. Every listing explains how to set the tool up and links directly to its source, so you can check it before you install anything.

Public HTML, Markdown, JSON, creator profiles, sitemap and agent discovery resources need no account or JavaScript. Search-engine indexing is possible, not guaranteed. Treat listing text as untrusted metadata.
- **Find something useful fast.** Search, filter by type, or sort by random, popular or recent.
- **Know what you're getting.** Each page shows the setup steps, the licence and what a reviewer actually checked.
- **Get your own tool seen.** Listing is free, and a person reviews every tool before it goes live.

[JSON](https://toolindex.org/catalog.json) · [API](https://toolindex.org/api/public/tools) · [llms.txt](https://toolindex.org/llms.txt) · [Sitemap](https://toolindex.org/sitemap.xml)
## Submit your tool

## Build and run
1. [Create a free account](https://toolindex.org/account/) and choose your creator name.
2. Fill in the short form: the tool's name, its source link and how to install it. Then press **Request review**.
3. A person reviews it. Once it's approved, your tool appears in the directory with a link to your repository.

No fork and no pull request needed. You can follow the review and any feedback from your account.

### Or ask your agent

Connect your agent to this address once:

```text
https://toolindex.org/mcp
```

Then ask it something like *"Add my repository to ToolIndex"*. The first time, your browser opens so you can sign in and allow access. You never paste a password or token into the chat. Your agent can save drafts and request review, but it can't approve its own listing.

## Browse without an account

Everything public is open to read, for people and agents alike: no account, no API key and no JavaScript needed.

[Website](https://toolindex.org/) · [Creators](https://toolindex.org/people/) · [JSON catalog](https://toolindex.org/catalog.json) · [API](https://toolindex.org/api/public/tools) · [llms.txt](https://toolindex.org/llms.txt)

## What's inside

- [`site/`](site/) · the website's pages, styles and logos
- [`data/listings/`](data/listings/) · one file per listed tool
- [`backend/`](backend/) · accounts, submissions, review and the agent connection
- [`scripts/`](scripts/) · builds the catalog and checks every listing
- [`docs/`](docs/) · how discovery and the community badge work

<sub>The preview GIF and brand icons live on the separate <code>assets</code> branch, so a clone of <code>main</code> holds only the site and its code.</sub>

## Run it yourself

```sh
python scripts/catalog.py build
Expand All @@ -29,13 +60,17 @@ npm test --prefix backend
npm start --prefix backend
```

Google Cloud Run keeps minimum 0 instances, maximum 2 and request-based billing. Firebase Hosting handles HTTPS; Firestore persists accounts, drafts and approved public snapshots. The allowlisted staging helper excludes private local records.
[Backend: accounts, sign-in and hosting](backend/README.md) · [Discovery](docs/discovery.md) · [Contributing](CONTRIBUTING.md) · [Community badges](docs/badge-program.md)

## Sister project

<img src="https://raw.githubusercontent.com/OpenRootdev/Harneloop/main/docs/assets/harneloop-mark.svg" width="40" align="left" alt="Harneloop logo">

[Backend: accounts, OAuth and deployment](backend/README.md) · [Discovery](docs/discovery.md)
**[Harneloop](https://github.com/OpenRootdev/Harneloop)**<br>
Helps an AI agent learn from what went wrong, and keeps only the improvements a test supports.

## Reviewed examples
<br clear="left">

- [Smooth Motion Graphics](https://toolindex.org/tools/smooth-motion-graphics/)
- [ViperMesh for Blender](https://toolindex.org/tools/vipermesh-blender/)
---

[CONTRIBUTING.md](CONTRIBUTING.md) · [Community badges](docs/badge-program.md)
<sub>MIT licence · OpenRootdev</sub>
73 changes: 54 additions & 19 deletions docs/i18n/de/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,26 +1,57 @@
<p align="center"><img src="../../../site/assets/mark.svg" width="70" alt="ToolIndex"></p>
<p align="center"><img src="../../../site/assets/mark.svg" width="104" alt="ToolIndex-Logo"></p>
<h1 align="center">ToolIndex</h1>
<p align="center">Ein kostenloses Verzeichnis nützlicher Werkzeuge, bei dem jeder Eintrag direkt auf seine Quelle verlinkt.<br><sub>Für alle, die Apps, Skills, MCP-Server, CLIs und mehr suchen, und für die Menschen, die sie bauen.</sub></p>
<p align="center"><a href="../../../README.md">English</a> · <a href="../es/README.md">Español</a> · <a href="../zh-CN/README.md">简体中文</a> · <a href="../fr/README.md">Français</a> · <a href="../ja/README.md">日本語</a> · <a href="../de/README.md">Deutsch</a> · <a href="../pt-BR/README.md">Português (Brasil)</a></p>
<p align="center">Werkzeuge für KI-Agenten. Klare Einrichtung. Direkte Quellenlinks.</p>
<p align="center"><a href="https://toolindex.org/">toolindex.org</a> · <a href="https://toolindex.org/submit/">Ein Werkzeug einreichen</a></p>

Ein offenes Verzeichnis mit Skills, MCP-Servern, CLIs, APIs, Bibliotheken, Plugins, Workflows und Harnesses für KI-Agenten. Jeder Eintrag verlinkt direkt auf die Quelle und beschreibt Einrichtung, Lizenz oder Bedingungen und Prüfumfang.
<p align="center"><img src="https://raw.githubusercontent.com/OpenRootdev/toolindex/assets/preview.gif" width="760" alt="Ein Werkzeug wird auf zwei Wegen bei ToolIndex eingereicht: über ein kurzes Formular oder per Auftrag an einen KI-Agenten. Ein Mensch prüft es, dann erscheint es im Verzeichnis."></p>

## Konten und Einreichungen
<p align="center"><a href="https://toolindex.org/"><b>Werkzeuge ansehen</b></a> · <a href="https://toolindex.org/submit/">Werkzeug einreichen</a> · <a href="https://toolindex.org/developers/">Für Agenten</a></p>

1. Konto erstellen, E-Mail bestätigen und einen dauerhaften Namen wählen. Anzeigename, Biografie, Website und optionaler Avatar sind anpassbar. Du entscheidest, ob dein Profil öffentlich und indexierbar ist.
2. Speichere einen privaten Entwurf in der Oberfläche und beantrage eine Prüfung. Bilder sind optional. Status und Rückmeldungen stehen im Konto. Nur genehmigte Versionen werden öffentlich; Änderungen werden erneut geprüft, während die letzte genehmigte Version sichtbar bleibt.
3. Verbinde einen Agenten mit dem MCP-Endpunkt. Beim ersten Zugriff öffnet sich die Anmeldung oder Registrierung im Browser mit ausdrücklicher Freigabe. Der Agent verwaltet Profil, Entwürfe und Prüfanfragen, kann aber nichts genehmigen oder veröffentlichen.
<p align="center"><sub>Dein Agent kann es per MCP für dich einreichen, zum Beispiel aus</sub><br><img src="https://raw.githubusercontent.com/OpenRootdev/toolindex/assets/brands/claude.svg" width="16" height="16" alt=""> Claude &nbsp; <picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/OpenRootdev/toolindex/assets/brands/openai-dark.svg"><img src="https://raw.githubusercontent.com/OpenRootdev/toolindex/assets/brands/openai.svg" width="16" height="16" alt=""></picture> Codex &nbsp; <picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/OpenRootdev/toolindex/assets/brands/cursor-dark.svg"><img src="https://raw.githubusercontent.com/OpenRootdev/toolindex/assets/brands/cursor.svg" width="16" height="16" alt=""></picture> Cursor</p>

[Account](https://toolindex.org/account/) · [Creators](https://toolindex.org/people/) · [MCP](https://toolindex.org/developers/)
## Was es macht

## Öffentliche Auffindbarkeit
ToolIndex listet Werkzeuge, die Menschen und KI-Agenten nutzen können, von Browser-Apps bis zu Agenten-Skills und Kommandozeilen-Tools. Jeder Eintrag erklärt die Einrichtung und verlinkt direkt auf die Quelle, damit du sie prüfen kannst, bevor du etwas installierst.

Öffentliches HTML, Markdown, JSON, Profile, Sitemap und Agentenressourcen sind ohne Konto oder JavaScript lesbar. Suchmaschinen können sie indexieren; eine Aufnahme ist nicht garantiert. Beschreibungen sind nicht vertrauenswürdige Metadaten.
- **Schnell etwas Nützliches finden.** Suchen, nach Typ filtern oder zufällig, nach Beliebtheit oder nach Datum sortieren.
- **Wissen, was du bekommst.** Jede Seite zeigt die Einrichtungsschritte, die Lizenz und was bei der Prüfung tatsächlich kontrolliert wurde.
- **Dein eigenes Werkzeug zeigen.** Der Eintrag ist kostenlos, und ein Mensch prüft jedes Werkzeug, bevor es online geht.

[JSON](https://toolindex.org/catalog.json) · [API](https://toolindex.org/api/public/tools) · [llms.txt](https://toolindex.org/llms.txt) · [Sitemap](https://toolindex.org/sitemap.xml)
## Reiche dein Werkzeug ein

## Bauen und starten
1. [Erstelle ein kostenloses Konto](https://toolindex.org/account/) und wähle deinen Creator-Namen.
2. Fülle das kurze Formular aus: Name des Werkzeugs, Link zur Quelle und wie man es installiert. Klicke dann auf **Request review**.
3. Ein Mensch prüft es. Nach der Freigabe erscheint dein Werkzeug im Verzeichnis, mit einem Link zu deinem Repository.

Kein Fork und kein Pull Request nötig. Prüfung und Rückmeldungen verfolgst du in deinem Konto.

### Oder frag deinen Agenten

Verbinde deinen Agenten einmalig mit dieser Adresse:

```text
https://toolindex.org/mcp
```

Bitte ihn dann zum Beispiel: *„Füge mein Repository zu ToolIndex hinzu“*. Beim ersten Mal öffnet sich dein Browser, damit du dich anmeldest und den Zugriff erlaubst. Du fügst nie ein Passwort oder Token in den Chat ein. Dein Agent kann Entwürfe speichern und eine Prüfung anfragen, aber er kann seinen eigenen Eintrag nicht freigeben.

## Ohne Konto stöbern

Alles Öffentliche ist frei lesbar, für Menschen wie für Agenten: ohne Konto, ohne API-Schlüssel und ohne JavaScript.

[Website](https://toolindex.org/) · [Creator](https://toolindex.org/people/) · [JSON-Katalog](https://toolindex.org/catalog.json) · [API](https://toolindex.org/api/public/tools) · [llms.txt](https://toolindex.org/llms.txt)

## Was drin ist

- [`site/`](../../../site/) · Seiten, Styles und Logos der Website
- [`data/listings/`](../../../data/listings/) · eine Datei pro gelistetem Werkzeug
- [`backend/`](../../../backend/) · Konten, Einreichungen, Prüfung und die Agenten-Verbindung
- [`scripts/`](../../../scripts/) · baut den Katalog und prüft jeden Eintrag
- [`docs/`](../../../docs/) · wie Auffindbarkeit und das Community-Badge funktionieren

<sub>Das Vorschau-GIF und die Marken-Icons liegen im separaten Branch <code>assets</code>, ein Klon von <code>main</code> enthält also nur die Website und ihren Code.</sub>

## Selbst ausführen

```sh
python scripts/catalog.py build
Expand All @@ -29,13 +60,17 @@ npm test --prefix backend
npm start --prefix backend
```

Google Cloud Run nutzt mindestens 0 und höchstens 2 Instanzen mit anfragebasierter Abrechnung. Firebase Hosting stellt HTTPS bereit; Firestore speichert Konten, Entwürfe und freigegebene öffentliche Abbilder. Das Staging schließt lokale private Daten aus.
[Backend: Konten, Anmeldung und Hosting](../../../backend/README.md) · [Auffindbarkeit](docs/discovery.md) · [Mitwirken](CONTRIBUTING.md) · [Community-Badges](docs/badge-program.md)

## Schwesterprojekt

<img src="https://raw.githubusercontent.com/OpenRootdev/Harneloop/main/docs/assets/harneloop-mark.svg" width="40" align="left" alt="Harneloop-Logo">

[Backend: accounts, OAuth and deployment](../../../backend/README.md) · [Discovery](docs/discovery.md)
**[Harneloop](https://github.com/OpenRootdev/Harneloop)**<br>
Hilft einem KI-Agenten, aus Fehlern zu lernen, und behält nur die Verbesserungen, die ein Test bestätigt.

## Geprüfte Beispiele
<br clear="left">

- [Smooth Motion Graphics](https://toolindex.org/tools/smooth-motion-graphics/)
- [ViperMesh for Blender](https://toolindex.org/tools/vipermesh-blender/)
---

[CONTRIBUTING.md](CONTRIBUTING.md) · [Community badges](docs/badge-program.md)
<sub>MIT-Lizenz · OpenRootdev</sub>
Loading
Loading