Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Criterion

by BalajSaleemversion 1.0.0i★ 21iRuns in the cloudOfficial site ↗
Registry nameio.github.BalajSaleem/criterion

How to install

What it does

Semantic search across 6,236 Quran verses and 12,416 authentic Hadiths for Islamic guidance.

  • Connects Runs in the cloud
  • Account or key No key needed
  • Category Search & AI memory

Use together with

Skills that teach the AI this kind of work; they work alongside this one

timesfm

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

by google-research★ 35,6291 skills

Skill · How-to guide

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

by BigBodyCobain★ 11,6021 skills

Skill · How-to guide

google-maps-scraper

scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place

by gosom★ 8,2091 skills

Skill · How-to guide

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity16/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score28/100

Quality: Passed 2/4 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Passed 2/4 checks · Runs on your computer

We hid some of the commands

Connect by URL: the server address did not answer when we checked

No install path has passed yet. See the maker’s instructions or pick another server in this category · Maker’s install instructions · Others in this category

First: which AI do you use?

Pick your app and the steps appear below.

Claude cannot connect Criterion yet

No install path has passed yet. See the maker’s instructions or pick another server in this category

ChatGPT cannot connect Criterion yet

No install path has passed yet. See the maker’s instructions or pick another server in this category

What you can do instead

B · Others in Search & AI memory that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Claude Code cannot connect Criterion yet

No install path has passed yet. See the maker’s instructions or pick another server in this category

Cursor cannot connect Criterion yet

No install path has passed yet. See the maker’s instructions or pick another server in this category

VS Code cannot connect Criterion yet

No install path has passed yet. See the maker’s instructions or pick another server in this category

No install path has passed yet. See the maker’s instructions or pick another server in this category

Stuck? Ask people who use Criterion💬 Discussion →

At a glance

Downloads per weeki
Not on npm/PyPI
Licencei
No licence stated
Connection
Runs in the cloud
Transport
streamable-http
Latest versioni
1.0.0
Published to registryi
Jan 2, 2026
Code last changedi
Oct 29, 2026
Last checked
Nov 18, 2026
Maker
BalajSaleem
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

GooseLM StudioMsty StudioCherry StudioVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

All apps, with pros and cons →

Related guides

What it can do

The server did not answer when we last checked, so we could not read its tools.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account BalajSaleem, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 21 days ago

  • ! Caution

    Has a licence

    GitHub could not identify the licence type; open the file to check

  • ✕ Fail

    Endpoint responds

    Did not respond within 6 seconds when we checked

  • – Not applicable

    Sign-in with OAuth

    Did not respond within 6 seconds when we checked

  • … Not checked yet

    No hidden instructions in tool descriptions

    Not checked yet; we read the tool list when we check the endpoint

The cloud address answered 0 of the last 4 checks · no answer last time · checked Nov 18, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/balajsaleem-criterion.svg)](https://mcp.popnx.com/en/servers/balajsaleem-criterion)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Search & AI memoryi

  • More stars than 95% of the other 6416 servers in this category
  • Published to the registry more recently than 1% of the other 6416 servers in this category
  • Basic checks equal to or better than 10% of the other 6416 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Criterion safe?

It passed 2 of 4 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed 21 days ago, and the latest version (1.0.0) reached the registry 11 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

OpenSEO

Keyword research, site audits, rank tracking and AI visibility for your AI agent.

by every-appWidely used★ 28.2KUpdated 5 days ago

Runs in the cloud✓ everyapp.com

Exa

Connect AI agents to Exa for web search, content fetching, and multi-step research.

by exa-labsWidely used★ 5.2KUpdated 2 months ago

Runs in the cloud✓ service owner · exa.aiTried by the PopNx team

Microsoft Learn MCP

Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.

by MicrosoftDocsWidely used★ 2KUpdated 12 months ago

Runs in the cloud✓ service owner · microsoft.comTried by the PopNx team

Docs

Search and read Empryo's documentation. Read-only, no auth, no local access.

by proxysoulGrowing★ 1.6KUpdated 2 months ago

Runs in the cloud✓ empryo.com
Compared with similar ones
This one
Criterion
OpenSEOExaMicrosoft Learn MCPDocsCOTAL actions (cotal.ai)
Runs whereRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoYesYesYesNoNo
Basic checks2/45/52/44/44/44/4
LicenseNOASSERTIONMITMITCC-BY-4.0NOASSERTIONApache-2.0
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Criterion - Islamic Knowledge Assistant

An AI-powered Da'i (invitor to Islam) bringing authentic Islamic guidance to seekers worldwide.

Built on the Quran and authentic Hadith. Free forever. For the sake of Allah.

Mission · Features · Tech Stack · Getting Started · MCP Server · Documentation

Mission

Criterion exists to bring authentic Islamic knowledge to anyone seeking truth, using modern technology to make divine guidance accessible to all of humanity — freely, forever, for the sake of Allah alone.

Our Four Pillars
  1. Truth & Authenticity — Every response is grounded in verified sources (Quran and Sahih Hadith). We never fabricate or hallucinate.
  2. Fundamentals & Simplicity — We focus on core Islamic teachings that unite. We avoid sectarian debates and controversial topics.
  3. For the Sake of Allah — Criterion will always be free, with no monetization or organizational promotion. This is Sadaqah Jariyah.
  4. State of the Art — We use cutting-edge AI to deliver Islamic guidance effectively to the masses.

👉 [Read the full mission and vision in MISSION.md](./MISSION.md)

Key Differentiators

Mission-Aligned:

  • ✨ Free Forever — No paywalls, no ads, no monetization. Built fi sabilillah (for Allah's sake)
  • 📚 Fundamentals-Focused — Avoids sectarian debates, focuses on universally accepted Islamic teachings
  • 🛡️ Trust-First — Grade-filtered authentic Hadith (defaults to Sahih), verified sources only
  • 🤝 Seeker-Oriented — Designed for curious minds, new Muslims, and students of knowledge
  • 🕌 Da'i Personality — Compassionate, knowledgeable, humble guidance

Technical Excellence:

  • 🎯 Semantic Search — Natural language queries return relevant verses from 6,236 Quran verses + 21,641 Hadith narrations
  • 📖 Contextual Retrieval — Top results include ±2 surrounding verses/narrations for proper context
  • 🌐 Multilingual — Read in English (fast) + Slovak (expandable to 10+ languages)
  • 🔗 Accurate Citations — All responses include source references with hyperlinks (Quran.com, Sunnah.com)
  • ⚡ Fast — <150ms query response time

Features

What Criterion Does

✅ Semantic Quran Search — Ask natural language questions, get relevant verses ✅ Semantic Hadith Search — Search authentic Hadith with grade & collection filtering ✅ Contextual Understanding — Top results include surrounding context for proper meaning ✅ Accurate Citations — Every response cites real sources with hyperlinks ✅ Multilingual Reading — English (fast) + Slovak (single JOIN <200ms) ✅ Shareable URLs — /quran/search?q=patience, /hadith/search?q=charity, and /quran/2/255 with metadata ✅ Real-time Streaming — Progressive response generation with token-by-token delivery ✅ Tool-Based RAG — LLM autonomously decides when to retrieve from Quran/Hadith

Technical Stack

How It Works

The RAG Pipeline
User Question

↓ XAI Grok 4 LLM (decides which tools to use) ↓ Tool Selection:

  • queryQuran → 6,236 verses (top 7 for chat, top 20 for search)
  • queryHadith → 21,641 hadiths from 6 collections (top 3 for chat, top 15 for search, with grade filtering) ↓

Vector Search (768-dim Gemini embeddings) ↓ Context Enhancement (top 3 get ±2 surrounding verses) ↓ LLM Generates Response with Citations ↓ Real-time Stream to User (Server-Sent Events)

Data
  • 6,236 Quran verses from all 114 Surahs
  • Arabic text (Tanzil Quran)
  • English translation (master)
  • Slovak translation (expandable)
  • 768-dimensional embeddings (Gemini text-embedding-004)
  • 21,641 Hadith narrations from 6 major collections (Kutub al-Sittah subset)
  • Sahih Bukhari (7,558)
  • Sahih Muslim (2,920)
  • Jami` at-Tirmidhi (3,951)
  • Sunan Abi Dawud (5,274)
  • 40 Hadith Nawawi (42)
  • Riyad as-Salihin (1,896)
  • Grade filtering (Sahih, Hasan, Da'if)
  • 768-dimensional embeddings
Performance
  • Quran search: <150ms (English), <200ms (translated)
  • Hadith search: <150ms
  • Vector search: Powered by HNSW indexes
  • Streaming: Real-time token-by-token delivery

Getting Started

Prerequisites
  • Node.js 18+ and pnpm
  • PostgreSQL database (recommend Neon)
  • API Keys:
  • XAI API Key (for Grok LLM)
  • Google AI Studio API Key (for embeddings)
Installation
  1. Clone the repository
git clone <repo-url>

cd criterion

  1. Install dependencies
pnpm install
  1. Set up environment variables

Create a .env.local file:

# Database

POSTGRES_URL=postgresql://...

AI APIs

XAI_API_KEY=xai-... AI_GATEWAY_API_KEY=...

Authentication (optional)

AUTH_SECRET=...

  1. Enable pgvector extension
pnpm db:enable-pgvector
  1. Run database migrations
pnpm db:migrate
  1. Ingest Quran data (generates embeddings for 6,236 verses)
pnpm ingest:quran

This will take 10-15 minutes to complete.

  1. Test the Quran search
pnpm test:quran
  1. Start the development server
pnpm dev

Your app should now be running on localhost:3000.

Available Commands

Development
pnpm dev          # Start dev server

pnpm build # Build for production pnpm start # Start production server

Database
pnpm db:generate  # Generate Drizzle schema

pnpm db:migrate # Run migrations pnpm db:studio # Open Drizzle Studio (GUI)

Data Ingestion & Testing
# Quran

pnpm clear:quran # Clear all Quran data pnpm ingest:quran # Ingest Quran verses and generate embeddings pnpm ingest:quran:slovak # Ingest Slovak translation pnpm test:quran # Test Quran search functionality

Hadith

pnpm clear:hadith # Clear all Hadith data pnpm ingest:hadith # Ingest Hadith and generate embeddings

MCP Server

Criterion exposes its semantic search capabilities through the Model Context Protocol (MCP), allowing AI assistants like Claude Desktop and Cursor to search Quran and Hadith directly.

Quick Setup:

{

"mcpServers": { "criterion": { "url": "https://criterion.life/api/mcp" } } }

Available Tools:

  • search_quran — Search 6,236 Quran verses
  • search_hadith — Search 21,641 authentic Hadiths from 6 collections
  • get_verse — Retrieve specific verse by reference (e.g., "2:255")

👉 [Read full MCP documentation in MCP.md](./MCP.md)

Project Structure

criterion/

├── app/ │ ├── (auth)/ # Authentication routes │ ├── (chat)/ # Chat interface and API │ │ └── api/chat/ # Main chat endpoint │ ├── search/ # Quran search page │ │ └── api/ # Quran search API │ ├── hadith/ │ │ └── search/ # Hadith search page and API │ └── quran/ # Quran reading pages ├── lib/ │ ├── ai/ │ │ ├── embeddings.ts # Core RAG logic │ │ ├── prompts.ts # Da'i system prompts │ │ └── tools/ │ │ ├── query-quran.ts # Quran search tool │ │ └── query-hadith.ts # Hadith search tool │ └── db/ │ ├── schema.ts # Database schema │ └── migrations/ # SQL migrations ├── components/ │ ├── chat.tsx # Main chat UI │ ├── quran-verses.tsx # Quran display component │ ├── hadith-narrations.tsx # Hadith carousel │ └── hadith/ │ └── hadith-card.tsx # Reusable hadith card ├── scripts/ │ ├── ingest-quran.ts # Quran data ingestion │ ├── ingest-hadith.ts # Hadith data ingestion │ └── test-*.ts # Test scripts └── data/ ├── quran*.txt # Quran translations └── *-full.json # Hadith collections

Documentation

Understanding Criterion
  • [MISSION.md](./MISSION.md) — Our vision, values, and deeper purpose. Read this first to understand _why_ we build Criterion.
  • [CRITERION_DETAILED.md](./CRITERION_DETAILED.md) — Comprehensive technical documentation including architecture, implementation history, and performance metrics.
  • [CRITERION.md](./CRITERION.md) — Quick reference guide for setup and key concepts.
Key Sections
DocumentPurpose
MISSION.mdVision, values, pillars, and long-term goals
CRITERION_DETAILED.mdTechnical architecture, database schema, components, and best practices
CRITERION.mdQuick start, commands, and core concepts
README.mdGetting started, features, and project overview

Architecture Overview

components/

├── Chat UI (QuranVerses, HadithNarrations, MessageActions) ├── Search Pages (Quran and Hadith semantic search with filters) ├── Hadith Components (reusable HadithCard for search and chat) ├── Quran Pages (shared components for context, language selection) └── UI Components (buttons, inputs, etc.)

lib/ ├── ai/ │ ├── embeddings.ts (vector search logic) │ ├── prompts.ts (Da'i system prompts) │ └── tools/ (queryQuran, queryHadith, requestSuggestions) ├── db/ │ ├── schema.ts (Drizzle ORM definitions) │ └── queries.ts (database functions) └── monitoring/ (performance tracking)

app/ ├── (chat)/api/chat (main chat endpoint) ├── quran/search/ (Quran search page and API) ├── hadith/search/ (Hadith search page and API) ├── quran/ (Quran reading pages) └── (auth)/ (authentication)

Data Attribution

  • Quran Text: Tanzil.net — Creative Commons Attribution 3.0
  • Quran Translations: Multiple sources with proper attribution
  • Hadith Collections: Sunnah.com, IslamicNetwork.com
  • Embeddings: Google Gemini text-embedding-004

Our Commitment

Criterion is built with these commitments:

  • ✅ Never monetize Islamic knowledge
  • ✅ Always cite sources with proper references
  • ✅ Never fabricate verses or hadiths
  • ✅ Focus on fundamentals — avoid sectarian debates
  • ✅ Build for the community — this belongs to all Muslims and benefits all humanity
  • ✅ Stay at the forefront — leverage state-of-the-art technology

Contributing

We welcome contributions from developers, scholars, and community members who share our mission. Please see CONTRIBUTING.md for guidelines.

License

  • Quran Text: Creative Commons Attribution 3.0 (Tanzil.net)
  • Hadith Data: From verified Islamic sources with proper attribution
  • Code: See LICENSE file for details

"Invite to the way of your Lord with wisdom and good instruction, and argue with them in a way that is best." — Quran 16:125

_May Allah accept this work and make it a means of

Only the beginning is shown; read the rest in the repo