# BotShelf Vampire

> BotShelf Vampire is an open-source MCP server for agent tooling. Read-only MCP server to search and read free items from the BotShelf Vampire shelf. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, vscode
- **Website:** https://botshelfvampire.com/mcp/
- **Repository:** https://github.com/botshelfvampire/botshelf-mcp
- **MCP Registry name:** com.botshelfvampire/botshelf
- **Categories:** agent tooling
- **Listing updated:** 2026-11-18

## About

The README says this is a remote Model Context Protocol server pointed at the public shelf at botshelfvampire.com, which holds free AI teams, recipes, agent toolkits, unofficial Grok Bot tools, trading tools and guides. An MCP-compatible client connects to one address over Streamable HTTP and gets three tools: keyword search, single-item lookup, and paged browsing in shelf order.

Only free items with a plain file open without sign-up return full text; paid listings appear as cards linking to their pages. The server writes nothing and keeps no account or query history, though it does count calls per caller in memory to limit abuse. Item text is user-authored and is meant to be treated as data by the client.

It suits people who already use an MCP client such as Claude Code, Codex, Cursor or VS Code and want to pull shelf items into their session without leaving the tool. The site notes that most items are marked Untested, and that only one client has been run end to end so far.

## Features

- **Keyword search with filters:** Searches shelf items by every word in a query, with optional filters for kind, runtime, topic, access and check status.
- **Full text retrieval:** Returns the full text of free items that have a plain file open without sign-up, with long text split into parts.
- **Paged shelf listing:** Lists items in shelf order a page at a time and reports how many items each kind holds.
- **Read-only operation:** Offers no tools that post, purchase, sign in or modify anything on the site.
- **No account required:** Connects with a single address and no API key or sign-up.

## Good for

- Pull a free code review prompt or team recipe into an AI coding session
- Search a shared shelf of agent toolkits from inside an MCP client
- Browse Grok Bot tool guides without leaving the editor
- Check which free items are marked as tested before using them

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http botshelf https://botshelfvampire.com/api/mcp
```

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

```sh
https://botshelfvampire.com/api/mcp
```

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

```json
{
  "mcpServers": {
    "botshelf": {
      "url": "https://botshelfvampire.com/api/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "botshelf": {
      "type": "http",
      "url": "https://botshelfvampire.com/api/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "botshelf": {
      "serverUrl": "https://botshelfvampire.com/api/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "botshelf": {
      "type": "http",
      "url": "https://botshelfvampire.com/api/mcp"
    }
  }
}
```

## Tools

- `search_items`: Search shelf items by words, with optional filters for kind, runtime, topic, access and check status.
- `get_item`: Fetch one item by id, with its card and full text when a plain free file exists.
- `list_items`: List items in shelf order, one page at a time, with per-kind counts.

## FAQ

### Does the server need an account or API key?

No. The README and site state there is no account, cookie or API key; the client just needs the server address.

### Can it change anything on the shelf?

No. The README says all three tools are marked read-only and the server writes nothing.

### Are paid items readable through it?

No. Paid listings come back as a card with a link to their page, and their text is not served.

### Which clients have been tested?

The site reports one client run, Codex CLI on macOS, with search, get and list calls completed. Other client setups are based on their documentation and have not been run.

### Is BotShelf Vampire free?

Yes. BotShelf Vampire is open source, so you can use and self-host it for free.

### How do I add BotShelf Vampire to Claude Code?

Run this command in your terminal: claude mcp add --transport http botshelf https://botshelfvampire.com/api/mcp

### What are the best alternatives to BotShelf Vampire?

The closest alternatives to BotShelf Vampire are Agent interoperability design — Atom, Agent context packaging — Atom, Zero trust evaluation verdict — Atom, Zero knowledge claim audit — Atom and Network exposure audit — Atom.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Agent interoperability design — Atom](https://ai-powered.com/mcp/agent-interoperability-design-atom): Agent interoperability design — Atom is an MCP server for design and media.
- [Agent context packaging — Atom](https://ai-powered.com/mcp/agent-context-packaging-atom): Agent context packaging — Atom is an MCP server for agent tooling.
- [Zero trust evaluation verdict — Atom](https://ai-powered.com/mcp/zero-trust-evaluation-verdict-atom): Zero trust evaluation verdict — Atom is an MCP server for ai models and llm tooling.
- [Zero knowledge claim audit — Atom](https://ai-powered.com/mcp/zero-knowledge-claim-audit-atom): Zero knowledge claim audit — Atom is an MCP server for security.
- [Network exposure audit — Atom](https://ai-powered.com/mcp/network-exposure-audit-atom): Network exposure audit — Atom is a paid MCP server for security.
- [BotMarket](https://ai-powered.com/mcp/botmarket): BotMarket is a free MCP server for agent tooling.
- [WritersLogic agent-infra](https://ai-powered.com/mcp/writerslogic-agent-infra): WritersLogic agent-infra is a paid MCP server for agent tooling.
- [WritersLogic verifiable AI agents](https://ai-powered.com/mcp/writerslogic-verifiable-ai-agents): WritersLogic verifiable AI agents is a paid MCP server for agent tooling.

---
Source: https://ai-powered.com/mcp/botshelf-vampire
