harpd-mcp
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HARPD_CACHE_DIR | No | Cache location. | ~/.cache/harpd-mcp |
| HARPD_DATA_BASE | No | Where to read datasets from. Supports https://, http:// and file:// (needs a trailing slash). | https://raw.githubusercontent.com/harpd-dev/harpd-ai-datasets/main/ |
| HARPD_CACHE_TTL_MS | No | On-disk cache TTL in milliseconds. | 3600000 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_productsA | Search the Harpd open product catalog (1,122 AI products) by free text, category and verification state. Returns each product with its board position (rank) and its rankPoints. IMPORTANT: rankPoints are promotional placement bought with Credits on Harpd Rank, NOT an editorial quality score. Ordering by rankPoints orders by promotional placement, not by merit. Every record carries full provenance (source, dataset path, updatedAt, license, attribution, evidence). |
| get_productA | Look up a single product in the Harpd open product catalog by id, slug or name. Returns the product record plus mandatory provenance (source, dataset path, sourceUrl, updatedAt, license, attribution, evidence links). A product that does not exist returns a structured found:false result rather than an error. NOTE: rankPoints are promotional placement bought with Credits, NOT an editorial quality score. |
| get_productsA | Page through the full Harpd open product catalog (1,122 records) with filters on category, verification state, product type and rankPoints range. Use this to enumerate or bulk-export products; use search_products for free-text lookup. IMPORTANT: rankPoints are promotional placement bought with Credits on Harpd Rank, NOT an editorial quality score. Sorting by "rankPoints" orders by promotional placement, not by merit. Page size is capped at 200. Every record carries full provenance. |
| get_rankingsA | Read one of the three published Harpd Rank boards (overall / monthly / weekly) with its period metadata. CRITICAL: rankPoints are promotional placement bought with Credits on Harpd Rank. They are NOT an editorial quality score, and a higher rankPoints value does NOT mean a better product. Ordering by "rankPoints" orders by promotional placement. Ordering by "rank" follows the published board position, which is also derived from promotional placement. The board is a live snapshot for its period, not a historical time series. Every record carries full provenance. |
| get_category_rankingA | Read one of the 28 published Harpd Rank category boards: the board metadata (product counts, state, board URL) plus the products listed in that category. CRITICAL: rankPoints are promotional placement bought with Credits on Harpd Rank, NOT an editorial quality score. A category board being "topRankOpen" or a product having high rankPoints says nothing about product quality. An unknown category returns a structured found:false result listing the valid slugs, not an error. Every record carries full provenance. |
| get_ranking_historyA | Compare the three published Harpd Rank board snapshots (overall / monthly / weekly) for one product, or side by side at board level. HONEST SCOPE WARNING: this repository publishes three LIVE period-scoped snapshots, each covering its current window. It does NOT contain a multi-month historical time series, so this tool cannot and will not return month-over-month trends. It returns the periods the datasets really expose plus an explicit statement of the limitation. CRITICAL: rankPoints are promotional placement bought with Credits on Harpd Rank, NOT an editorial quality score. Movement between boards reflects promotional placement, not a change in product quality. |
| get_ai_agentsA | Return AI-agent products from the Harpd AI Agent Index (334 records, Discovery Index slice where category = "agents"). This is a COVERAGE list derived from the Harpd Product Discovery Index, NOT a ranking: records carry no rank and no rankPoints, and their order implies nothing about quality. Each record includes its observed_at timestamp, discovery source and profile URL. Use this to find AI agent products, their domains, one-line titles and where they were discovered. Some records also appear on the Harpd Rank board (on_rank_board). Every record carries full provenance (source, dataset path, sourceUrl, updatedAt, license, attribution). |
| get_ai_toolsA | Return AI tooling products from the Harpd AI Tools Index (693 records, Discovery Index slice where category is "agents" or "ai-media"). This is a COVERAGE list derived from the Harpd Product Discovery Index, NOT a ranking: records carry no rank and no rankPoints, and their order implies nothing about quality. Each record includes its observed_at timestamp, discovery source and profile URL. Use this to retrieve the current AI tools dataset: name, domain, URL, category, title, description, discovery source and observation timestamp. Every record carries full provenance (source, dataset path, sourceUrl, updatedAt, license, attribution). |
| get_developer_toolsA | Return developer-tool products from the Harpd Developer Tools Index (1,918 records, Discovery Index slice where category = "developer"). This is a COVERAGE list derived from the Harpd Product Discovery Index, NOT a ranking: records carry no rank and no rankPoints, and their order implies nothing about quality. Each record includes its observed_at timestamp, discovery source and profile URL. Use this to find developer tools, SDKs, infra and dev platforms by name, domain or description. Every record carries full provenance (source, dataset path, sourceUrl, updatedAt, license, attribution). |
| get_researchA | Read Harpd research output: the published monthly research reports (5 records, one per family/month) and the AI Market Index (27 category rows with product counts, product share and rank-point share). IMPORTANT: pointsShare is a share of rankPoints, and rankPoints are promotional placement bought with Credits on Harpd Rank. They are NOT an editorial quality score. pointsShare is not a share of quality or of market merit. Reports exist only for closed months with enough ranked products in the family scope. Every record carries full provenance. |
| get_evidenceA | Query the Harpd Evidence Graph: every published Harpd claim resolved to its evidence, dataset, methodology, source and data timestamp, including the claims Harpd explicitly does NOT make. Use this to check whether a statement about Harpd data is actually supported before repeating it. IMPORTANT: the graph itself records that rankPoints are promotional placement bought with Credits, and that "a higher-ranked product is a better product" is NOT a supported claim. rankPoints are NOT an editorial quality score. Claims that fail the evidence chain are returned with their violations rather than hidden. Every record carries full provenance. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 11 tools
The catalog tools are clearly separated by mode (single lookup, free-text search, paged enumeration), and ranking, discovery-index, research, and evidence tools target distinct resources. The main overlap is between get_ai_agents and get_ai_tools, since one is a subset of the other's filter scope, but the descriptions do enough to clarify their different index purposes.
The naming pattern is mostly predictable: a get_ prefix followed by a domain noun, with search_products as the one clear exception. There is also some singular/plural inconsistency (get_product vs get_products, get_rankings vs get_category_ranking), but the overall convention remains readable and navigable.
Eleven tools is well within the ideal range and each tool maps to a meaningful data-access need: product lookup/search/enumeration, board reads, history comparison, three discovery-index slices, research, and evidence checking. None of the tools feel redundant or superfluous for the server's stated purpose.
The server covers the core read-only workflows for the Harpd domain: retrieving products, searching and enumerating them, reading rank boards, comparing snapshots, pulling discovery-index slices, and accessing research and evidence. Minor gaps include the lack of a dedicated category-list endpoint and the absence of search/detail operations within the discovery-index slices, but these are workable.