# Notanda (Beta)

> Notanda (Beta) is an open-source MCP server for analytics and data. Local MCP server that searches OpenAlex and stores each search as checkable evidence. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://notanda.io
- **Repository:** https://github.com/rudiregenwurm/open-access-api-harvester/tree/HEAD/mcp
- **MCP Registry name:** io.github.RudiRegenwurm/notanda
- **Categories:** analytics and data
- **Listing updated:** 2026-11-15

## About

Each search leaves a receipt behind. The server saves the request, the provider's answer, the returned result and their hashes under one evidence ID, so a literature search can be verified months later without asking OpenAlex again.

It exposes two tools. `search_literature` looks for open-access works that have a DOI, and its `receipt` is the SHA-256 of the saved manifest. `get_evidence` checks the stored hashes and returns the original result by evidence ID; if you hold on to the receipt, it can also detect payloads that were swapped together with their manifest. Tool descriptions and responses warn that titles and metadata are unverified third-party content, not instructions.

The server runs locally over stdio and needs Python 3.11 or 3.12, an OpenAlex API key and a writable evidence folder. It does not download full texts, write to the Notanda corpus, or run as a network service. It is a beta, and the project says an external installation test is still pending.

## Features

- **Evidence ID per search:** Request, provider response, result and checksums are stored together under one ID.
- **Receipt hash:** The receipt is the SHA-256 of the manifest, which you can keep to detect tampering.
- **Verify without re-querying:** get_evidence checks hashes and returns the original result without repeating the OpenAlex call.
- **Open-access works with DOI:** search_literature limits results to OpenAlex works that are open access and have a DOI.
- **Local only:** Runs over stdio on your own computer and exposes no network server.

## Good for

- Keeping an auditable record of literature searches run by an AI assistant
- Re-checking months later what a search returned
- Gathering open-access references with DOIs for a review
- Detecting whether stored search results were altered

## Install

### Claude Code (Terminal)

```sh
claude mcp add notanda --env HARVESTER_OPENALEX_API_KEY='<HARVESTER_OPENALEX_API_KEY>' -- uvx notanda-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "notanda": {
      "command": "uvx",
      "args": [
        "notanda-mcp"
      ],
      "env": {
        "HARVESTER_OPENALEX_API_KEY": "<HARVESTER_OPENALEX_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "notanda": {
      "command": "uvx",
      "args": [
        "notanda-mcp"
      ],
      "env": {
        "HARVESTER_OPENALEX_API_KEY": "<HARVESTER_OPENALEX_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "notanda": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "notanda-mcp"
      ],
      "env": {
        "HARVESTER_OPENALEX_API_KEY": "<HARVESTER_OPENALEX_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "notanda": {
      "command": "uvx",
      "args": [
        "notanda-mcp"
      ],
      "env": {
        "HARVESTER_OPENALEX_API_KEY": "<HARVESTER_OPENALEX_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "notanda": {
      "command": "uvx",
      "args": [
        "notanda-mcp"
      ],
      "env": {
        "HARVESTER_OPENALEX_API_KEY": "<HARVESTER_OPENALEX_API_KEY>"
      }
    }
  }
}
```

## Tools

- `search_literature`: Search OpenAlex for open-access works with a DOI and store the request, provider observation, result and hashes under one evidence ID.
- `get_evidence`: Verify stored hashes and return the original result by evidence ID without repeating the provider request.

## FAQ

### What does it need to run?

Python 3.11 or 3.12, an OpenAlex API key set as HARVESTER_OPENALEX_API_KEY, and a local evidence directory.

### Does it download full texts?

No. It only searches OpenAlex and stores the evidence; it does not fetch full text or write to the Notanda corpus.

### How do I install it?

Install the notanda-mcp package from PyPI (version 0.1.0b3), or run it with uvx and an absolute evidence path.

### Is it production ready?

It is labelled beta, and the README says an external developer's installation test is still pending.

### Is Notanda (Beta) free?

Yes. Notanda (Beta) is open source, so you can use and self-host it for free.

### How do I add Notanda (Beta) to Claude Code?

Run this command in your terminal: claude mcp add notanda --env HARVESTER_OPENALEX_API_KEY='<HARVESTER_OPENALEX_API_KEY>' -- uvx notanda-mcp

### What are the best alternatives to Notanda (Beta)?

The closest alternatives to Notanda (Beta) are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/notanda-beta
