Skip to main content
Glama
harpd-dev

harpd-mcp

Official
by harpd-dev

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
HARPD_CACHE_DIRNoCache location.~/.cache/harpd-mcp
HARPD_DATA_BASENoWhere 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_MSNoOn-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

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.2/5.0

Scored across 11 tools

Disambiguation4/5

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.

Naming Consistency4/5

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.

Tool Count5/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo issues