# gleanyard (read-only)

> gleanyard (read-only) is an open-source MCP server for analytics and data. Read-only connector for the gleanyard source registry and public project records. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, self-hosted
- **Website:** https://kausalflow.github.io/gleanyard/concepts/no-install/
- **Repository:** https://github.com/kausalflow/gleanyard/tree/HEAD/connector
- **MCP Registry name:** io.github.kausalflow/gleanyard
- **Categories:** analytics and data, developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gleanyard-connector.leima.workers.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "gleanyard": {
      "url": "https://gleanyard-connector.leima.workers.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/gleanyard-read-only
