HadithDB: tool descriptions scored io.github.iadnanmukhtar/hadithdb

tools/list taken: 2026-11-02 (UTC)
From: Official MCP Registry
Connected to: https://hadithunlocked.com/mcp
Homepage: hadithunlocked.com
Repository: github.com/iadnanmukhtar/hadithdb
Scoring rules: v2
Removal: support@forecall.dev

Scores, issues and names only

This page shows how HadithDB (io.github.iadnanmukhtar/hadithdb)'s tool descriptions scored, the issues found and the names of its tools and parameters. The descriptions are the server's own: read them where the copy came from.

Forecall asked the URL this server lists in the official MCP Registry for its tools/list once, on the date above, without calling any tool. The server may have changed since.

servers/io.github.iadnanmukhtar/hadithdb

Average score: 57.5 / 100Cloudy
Tools: 19
Near-identical descriptions: 0

Across the server

No server-wide issues.

Tools

search_blog

45 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 10 / 25
Return value: 8 / 15
Constraints and side effects: 7 / 10
Examples: 0 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context
Major
Arguments without a description: query, limit, cursor.param_no_description
Minor
The description mentions none of its 3 or more arguments.params_not_in_description

lookup_hadith_commentary

48 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 10 / 25
Return value: 8 / 15
Constraints and side effects: 10 / 10
Examples: 0 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context
Major
Arguments without a description: id, response_profile.param_no_description
Minor
Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.id_source_missing

search_tafsir

48 / 100Cloudy

Purpose: 13 / 20
When to use: 0 / 20
Arguments: 20 / 25
Return value: 8 / 15
Constraints and side effects: 7 / 10
Examples: 0 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context
Minor
Arguments without a description: limit, sort.param_no_description

list_quran_sections

49 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 14 / 25
Return value: 8 / 15
Constraints and side effects: 7 / 10
Examples: 0 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context
Major
Arguments without a description: surah, limit, offset.param_no_description

list_hadith_commentaries

50 / 100Cloudy

Purpose: 20 / 20
When to use: 5 / 20
Arguments: 7 / 25
Return value: 8 / 15
Constraints and side effects: 10 / 10
Examples: 0 / 10

Major
Arguments without a description: query, limit, offset.param_no_description
Minor
No `required` list, so every argument is optional.no_required
Minor
The description mentions none of its 3 or more arguments.params_not_in_description

search_quran

51 / 100Cloudy

Purpose: 17 / 20
When to use: 0 / 20
Arguments: 19 / 25
Return value: 8 / 15
Constraints and side effects: 7 / 10
Examples: 0 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context
Minor
Arguments without a description: limit, sort.param_no_description
Minor
The description mentions none of its 3 or more arguments.params_not_in_description

list_tafsirs

54 / 100Cloudy

Purpose: 17 / 20
When to use: 5 / 20
Arguments: 14 / 25
Return value: 8 / 15
Constraints and side effects: 10 / 10
Examples: 0 / 10

Minor
Arguments without a description: limit.param_no_description
Minor
No `required` list, so every argument is optional.no_required
Minor
The description mentions none of its 3 or more arguments.params_not_in_description

lookup_blog_post

55 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 10 / 25
Return value: 15 / 15
Constraints and side effects: 10 / 10
Examples: 0 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context
Major
Arguments without a description: id, response_profile.param_no_description
Minor
Required identifiers whose description does not say where the value comes from: id. Name the tool or the place that returns it, or models look it up first.id_source_missing

lookup_quran_page

56 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 11 / 25
Return value: 15 / 15
Constraints and side effects: 10 / 10
Examples: 0 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context
Major
Arguments without a description: page, surah, ayah.param_no_description
Minor
No `required` list, so every argument is optional.no_required

lookup_tafsir

57 / 100Cloudy

Purpose: 17 / 20
When to use: 0 / 20
Arguments: 20 / 25
Return value: 8 / 15
Constraints and side effects: 7 / 10
Examples: 5 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context
Minor
Arguments without a description: surah, ayah.param_no_description

lookup_quran_passage

58 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 16 / 25
Return value: 15 / 15
Constraints and side effects: 7 / 10
Examples: 0 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context
Major
Arguments without a description: surah, section, subsection.param_no_description

lookup_quran_ayah

60 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 25 / 25
Return value: 8 / 15
Constraints and side effects: 7 / 10
Examples: 0 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context

search_hadith_commentary

61 / 100Cloudy

Purpose: 20 / 20
When to use: 10 / 20
Arguments: 16 / 25
Return value: 8 / 15
Constraints and side effects: 7 / 10
Examples: 0 / 10

Major
Arguments without a description: query, limit, cursor.param_no_description
Minor
The description mentions none of its 3 or more arguments.params_not_in_description

list_quran_reciters

62 / 100Cloudy

Purpose: 17 / 20
When to use: 5 / 20
Arguments: 25 / 25
Return value: 8 / 15
Constraints and side effects: 7 / 10
Examples: 0 / 10

No issues.

search_hadith

62 / 100Cloudy

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 22 / 25
Return value: 8 / 15
Constraints and side effects: 7 / 10
Examples: 5 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context
Minor
Arguments without a description: limit.param_no_description
Minor
The description mentions none of its 3 or more arguments.params_not_in_description

get_quran_audio

65 / 100Cloudy

Purpose: 20 / 20
When to use: 5 / 20
Arguments: 18 / 25
Return value: 15 / 15
Constraints and side effects: 7 / 10
Examples: 0 / 10

Minor
Arguments without a description: surah, ayah_from.param_no_description

research_quran_ayah

65 / 100Cloudy

Purpose: 20 / 20
When to use: 5 / 20
Arguments: 20 / 25
Return value: 8 / 15
Constraints and side effects: 7 / 10
Examples: 5 / 10

Minor
Arguments without a description: surah, ayah.param_no_description

lookup_hadith_detail

70 / 100Clear

Purpose: 20 / 20
When to use: 0 / 20
Arguments: 25 / 25
Return value: 8 / 15
Constraints and side effects: 7 / 10
Examples: 10 / 10

Major
Says nothing about when to use it, or when not to.no_usage_context

research_islamic_topic

76 / 100Clear

Purpose: 20 / 20
When to use: 10 / 20
Arguments: 21 / 25
Return value: 8 / 15
Constraints and side effects: 7 / 10
Examples: 10 / 10

Minor
Arguments without a description: question.param_no_description

What static scoring cannot tell

This score reads only the text of each description and schema: it says what is written, not what a model will do. Short tools whose names already say what they do, such as browser_close, score low here even when models use them well, and in our measurements current models chose the right tool in one step even from one-line descriptions, as long as the names and schemas differed. What the text cannot show, such as what happens over several steps and whether an added sentence helps or misleads, is what an evaluation measures, on the Pro and Team plans.

Is your server listed here and you would rather it were not? Email support@forecall.dev, and we will take it off within 7 days.

All scored servers