Skip to content
MCP server

gleanyard (read-only)

Read-only connector for the gleanyard source registry and public project records

Install
Pricing
Open source
Platforms
API, self-hosted
Runs
Remotely
Version
0.14.0
Listing updated
3 days ago

About gleanyard (read-only)

gleanyard (read-only) is an open-source MCP server for analytics and data. It runs as a hosted remote server, so there is nothing to install locally.

gleanyard collects data into GitHub repos on a schedule using per-site recipes. This connector is the part that only reads. It looks up recipes in the shared source registry (their schema, tier and health) and reads what public gleanyard projects have already published: source health from status.json, a rights-filtered export searchable by text and source, and a change feed. An example question from the docs is which family events in a Berlin events project mention theater, or whether any of its sources are failing.

It cannot create, change or run sources and never fetches the sites a project collects from. It reads only the registry's site and raw.githubusercontent.com, so private repos stay invisible. Setting up sources is done through the template repo, Claude Code on the web, Codespaces or the GitHub Action instead.

The whole server is one dependency-free worker.js file for Cloudflare Workers, stateless over Streamable HTTP with no auth, caching responses for ten minutes. You can deploy your own copy on the free Workers plan.

Install

Run in a terminal

claude mcp add --transport http gleanyard https://gleanyard-connector.leima.workers.dev/mcp

Add to Settings → Connectors → Add custom connector

https://gleanyard-connector.leima.workers.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "gleanyard": {
      "url": "https://gleanyard-connector.leima.workers.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "gleanyard": {
      "type": "http",
      "url": "https://gleanyard-connector.leima.workers.dev/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "gleanyard": {
      "serverUrl": "https://gleanyard-connector.leima.workers.dev/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "gleanyard": {
      "type": "http",
      "url": "https://gleanyard-connector.leima.workers.dev/mcp"
    }
  }
}

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

get_started
How to start a gleanyard project
search_recipes
Search the source registry: recipes, schema, tier and health
get_recipe
One recipe's source file, notes and terms evidence
get_schema
A schema the registry's recipes are written for
project_status
Health of each source in a public project repo
search_records
Search a public project's rights-filtered export
recent_changes
A public project's change feed

What it does

Recipe search
Searches the source registry by recipe, schema, tier and health.
Recipe detail
Reads one recipe's source file, notes and terms evidence.
Project health
Shows the health of each source in a public project.
Record search
Searches a public project's rights-filtered export by text and source.
Change feed
Reads a project's recent changes.
Self-deployable
One-file Cloudflare Worker you can run on your own account.

Good for

  • Check whether any sources in a public gleanyard project are failing
  • Search a project's published records for a topic
  • Find an existing recipe before writing a new source
  • Follow what changed in a collected dataset recently

Pricing

Open source

Free to use; self-hostable on Cloudflare Workers

Prices change. Check kausalflow.github.io before you buy.

gleanyard (read-only) FAQ

Can it modify projects?

No. It is read-only by design and cannot create, change or run sources.

Does it scrape websites?

No. It reads only the registry's site and raw.githubusercontent.com, never the sites projects collect from.

Does it need sign-in?

No. The server is stateless with no sessions and no auth.

Can I host it myself?

Yes. It is a single worker.js for Cloudflare Workers, and the free plan's 100,000 requests a day is described as plenty.

Is gleanyard (read-only) free?

Yes. gleanyard (read-only) is open source, so you can use and self-host it for free.

How do I add gleanyard (read-only) to Claude Code?

Run this command in your terminal: claude mcp add --transport http gleanyard https://gleanyard-connector.leima.workers.dev/mcp

What are the best alternatives to gleanyard (read-only)?

The closest alternatives to gleanyard (read-only) are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to gleanyard (read-only)

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data