Biblical Atlas
Spanish Bible atlas as MCP tools: people, places, events, passages, each linked to its source
What can you do with Biblical Atlas?
- 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.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
biblical-atlas-mcpclaude mcp add biblical-atlas -e 'BIBLICAL_ATLAS_DATA_URL=<BIBLICAL_ATLAS_DATA_URL>' -e 'BIBLICAL_ATLAS_DATA_FILE=<BIBLICAL_ATLAS_DATA_FILE>' -e 'BIBLICAL_ATLAS_CACHE_DIR=<BIBLICAL_ATLAS_CACHE_DIR>' -e 'BIBLICAL_ATLAS_REFRESH=<BIBLICAL_ATLAS_REFRESH>' -e 'BIBLICAL_ATLAS_TIMEOUT=<BIBLICAL_ATLAS_TIMEOUT>' -- npx -y biblical-atlas-mcp@0.2.0
{
"mcpServers": {
"biblical-atlas": {
"command": "npx",
"args": [
"-y",
"biblical-atlas-mcp@0.2.0"
],
"env": {
"BIBLICAL_ATLAS_DATA_URL": "<BIBLICAL_ATLAS_DATA_URL>",
"BIBLICAL_ATLAS_DATA_FILE": "<BIBLICAL_ATLAS_DATA_FILE>",
"BIBLICAL_ATLAS_CACHE_DIR": "<BIBLICAL_ATLAS_CACHE_DIR>",
"BIBLICAL_ATLAS_REFRESH": "<BIBLICAL_ATLAS_REFRESH>",
"BIBLICAL_ATLAS_TIMEOUT": "<BIBLICAL_ATLAS_TIMEOUT>"
}
}
}
}
Environment variables
BIBLICAL_ATLAS_DATA_URLData file URL (default https://biblical-atlas.geiser.cloud/data.json)BIBLICAL_ATLAS_DATA_FILEPath to a local copy of the data file; no network when setBIBLICAL_ATLAS_CACHE_DIRDisk cache directory, or offBIBLICAL_ATLAS_REFRESHHow long a copy is served before asking again (default 1h, 0 = never)BIBLICAL_ATLAS_TIMEOUTLimit for one download, a Go duration from 1s to 5m (default 30s)
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
biblical-atlas-mcp
biblical-atlas-mcp is an MCP server that gives AI agents the biblical-atlas Bible atlas as nine 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
With Node.js 18 or newer, add the server to Claude Code with claude mcp add biblical-atlas -- npx -y biblical-atlas-mcp, or to any client that starts stdio servers:
{
"mcpServers": {
"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.
Documentation
- Getting started: every install path and a first call
- Configuration: every variable, flag and client config
- Usage: the nine 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
Frequently asked questions
What is Biblical Atlas?
Spanish Bible atlas as MCP tools: people, places, events, passages, each linked to its source
How do I install Biblical Atlas?
It runs on your machine. In Claude Code: claude mcp add biblical-atlas -e 'BIBLICAL_ATLAS_DATA_URL=<BIBLICAL_ATLAS_DATA_URL>' -e 'BIBLICAL_ATLAS_DATA_FILE=<BIBLICAL_ATLAS_DATA_FILE>' -e 'BIBLICAL_ATLAS_CACHE_DIR=<BIBLICAL_ATLAS_CACHE_DIR>' -e 'BIBLICAL_ATLAS_REFRESH=<BIBLICAL_ATLAS_REFRESH>' -e 'BIBLICAL_ATLAS_TIMEOUT=<BIBLICAL_ATLAS_TIMEOUT>' -- npx -y biblical-atlas-mcp@0.2.0. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Biblical Atlas need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is Biblical Atlas open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Biblical Atlas?
It is published by GeiserX. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.