drumsergio/biblical-atlas-mcp repository overview

⁠biblical-atlas-mcp

biblical-atlas-mcp is an MCP server that gives AI agents the biblical-atlas⁠ Bible atlas as ten read-only tools: people, places, events, reigns, letters, journeys and Bible passages. Answers carry the atlas id, a link to the record's card on the atlas site⁠ where the record has one, and links to its sources: a list answer carries the first one and the total, and get_record returns them all. The atlas is in Spanish, and the server returns its names and summaries as they are.

⁠Features

• Search every record by its Spanish name; accents and case are ignored ("jerusalen" finds Jerusalén).
• Read one record in full: family and relations in both directions, offices, coordinates and candidate sites, what happened at a place.
• List events by year or range, person, place, role, kind or Bible book, in date or story order.
• Ask who was alive, ruling or active in a year, with the evidence for each person.
• Look up a Bible reference ("Hch 16:1", "Hch 16", "Rut") and get the events, people, places and records that cite it.
• Find the shortest chain of family ties, succession and companionship between two people.
• Find places within a radius of a place or a coordinate.
• Years are signed in both directions: -607 means 607 a.e.c.
• No database and no atlas data in the package: the server downloads the atlas's public data file, caches it and refreshes it hourly with a conditional request.

⁠Quick start

Needs Node.js 18 or newer. The npm package downloads the release binary for your platform on first run and checks it against the checksums published with the package.

{
  "mcpServers": {
    "biblical-atlas": { "command": "npx", "args": ["-y", "biblical-atlas-mcp"] }
  }
}

{
  "servers": {
    "biblical-atlas": { "type": "stdio", "command": "npx", "args": ["-y", "biblical-atlas-mcp"] }
  }
}

[mcp_servers.biblical-atlas]
command = "npx"
args = ["-y", "biblical-atlas-mcp"]

Then ask "who was alive in 607 a.e.c.?". The container image for HTTP clients, release binaries and every setting are in Getting started⁠.

⁠Tools

All ten tools are read only: they never write, delete or call anything but the atlas's own data file, so there is no read-only mode to switch on. Each declares an output schema and returns its answer both as structuredContent and as JSON text.

⁠Protocol

The server speaks MCP 2026-07-28 and every earlier revision down to 2024-11-05, on stdio and on streamable HTTP. Clients that still start with initialize (Claude Code, Claude Desktop, Cursor and VS Code today) work as before; clients on 2026-07-28 get server/discover, stateless requests and cacheable tool lists from the same binary.

⁠Documentation

• Getting started⁠: every install path and a first call
• Configuration⁠: every variable, flag and client config
• Usage⁠: the ten tools, their parameters and what they return
• How it works⁠: download, cache, refresh and offline use
• Development⁠: build, test and release

⁠Related projects

The data belongs to biblical-atlas⁠, the atlas this server reads. It stays on the atlas site with its sources; this server only fetches and indexes it. Other MCP servers in the family: telegram-archive-mcp⁠.

⁠License

MIT⁠