Divine API - Documentation MCP Server

A public, read-only MCP server that answers "how do I use the DivineAPI REST API". It serves the already-public developer documentation: every endpoint, its parameters, its response fields, the global auth and error rules, and real captured example responses.

This server does NOT call the astrology APIs and needs NO credentials. It is a reference, not a data source. To actually run astrology requests, use the divineapi SDK or the data MCP servers:

• Indian / Vedic: https://mcp.divineapi.com/indian/mcp

• Western: https://mcp.divineapi.com/western/mcp

• Horoscope, Tarot and Numerology: https://mcp.divineapi.com/horoscope/mcp

Public endpoint

https://mcp.divineapi.com/docs/mcp

No API key, no auth token, no OAuth. Just connect.

Related MCP server: mcp-agno

Tools (5)

Data sources

• docs-pack.txt is fetched live at startup from https://developers.divineapi.com/docs-pack.txt (10s timeout); on failure the server falls back to the bundled snapshot shipped in this repo.

• examples.json is a map of normalized_path -> example response body, generated from the published Postman collection by build_examples.py. Regenerate it with:

python3 build_examples.py "/path/to/DivineAPI_Collection_with_examples_Final Version.json"

Run locally

python -m venv .venv && source .venv/bin/activate
pip install ".[http]"

# stdio (for Claude Desktop, Cursor, etc.)
divineapi-docs-mcp

# HTTP (streamable-http on :8000)
MCP_TRANSPORT=http uvicorn server:app --host 0.0.0.0 --port 8000

Deploy

Mirrors the DivineAPI data MCPs. The container runs uvicorn server:app on port 8000; docker-compose maps host port 8004 -> 8000.

docker compose up -d --build

Documentation: https://developers.divineapi.com