Biblical Atlas

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