# come.rent — The City

> The King James Bible as a queryable frequency database. 31,102 verses, 12,548 words, 9 cipher systems, Tesla resonance analysis, and an AI-powered biblical speech coach.

The API returns JSON when you send `Accept: application/json` or append `?format=json` to any GET endpoint.

## API Endpoints

### Name Decode
GET /name/{name}?depth=ankles|knees|loins|swimming
Decode any name through KJV gematria. Returns gematria value, digital root, Tesla resonance, letter breakdown.

### Verse Lookup
GET /verse/{ref}
Lookup any verse by canonical reference (e.g., GEN.1.1, JHN.3.16). Returns full text, word count, gematria, 7-layer Tesla signature and score.

### Word Analysis
GET /word/{word}
Analyze any word from the KJV. Returns frequency, gematria across 9 cipher systems (ordinal, reduction, reverse, reverse_red, sumerian, hebrew, chaldean, primes, fibonacci), digital root, Tesla status, and twin words sharing the same frequency.

### Gematria Lookup
GET /gematria/{value}?cipher=ordinal
Find all words and names matching a gematria value. Supports all 9 ciphers: ordinal (default), reduction, reverse, reverse_red, sumerian, hebrew, chaldean, primes, fibonacci.

### Full-Text Search
GET /search?q={query}&testament=OT|NT&limit=20
Search all 31,102 verses using FTS5 with Porter stemming. Returns matching verses with Tesla scores. Max 100 results.

### Today's Resonance Verse
GET /today
Returns one of 1,098 perfect Tesla verses (7/7 layers resonant) deterministically selected by date. Same verse all day.

### Mathematical Fingerprint
GET /fingerprint
Returns the 20-number mathematical proof of KJV structure: verse count, book count, word tokens, distinct words, perfect Tesla verses, hapax legomena, Tesla rates under successive multiplications, and the amplification formula tau(n) = 1 - (2/3)^n.

### Oracle (Speech Coach)
POST /oracle
Content-Type: application/json
Body: {"message": "your text", "mode": "converse|grade", "voice": "jesus|david|solomon"}
Grades speech on 7 biblical metrics (frequency, resonance, authority, alignment, purity, direction, substance). In "converse" mode, responds with biblical guidance and a refined version of the input. In "grade" mode, returns metrics only (no LLM call).

### SQL Query (for agents)
POST /api/query
Content-Type: application/json
Body: {"sql": "SELECT ..."}
Execute read-only SQL against the KJVEL database. SELECT and WITH only. Max 200 rows. See /llms-full.txt for the complete database schema.

## Key Concepts

- **Gematria**: Each letter A-Z maps to a number (A=1, B=2, ... Z=26). A word's gematria is the sum of its letters.
- **Digital Root (DR)**: Repeatedly sum digits until single digit (e.g., 74 → 7+4 = 11 → 1+1 = 2).
- **Tesla Resonance**: A value is Tesla-resonant when its digital root is 3, 6, or 9.
- **Tesla Score**: Each verse has a 7-layer Tesla signature testing DR of (verse#, word_count, letter_count, v×w, ch×v×w, v×l, ch×v×l). Score 0-7.
- **Perfect Tesla**: A verse scoring 7/7 — all layers resonant. 1,098 of 31,102 verses qualify.
- **9 Ciphers**: ordinal, reduction (pythagorean), reverse ordinal, reverse reduction, sumerian (×6), hebrew (transliterated), chaldean, primes, fibonacci.

## Key Numbers
- JESUS = 74, CHRIST = 77, NAME = GATE = SEED = 33, TABERNACLE = 81
- Total verses: 31,102. Total words: 791,154. Distinct words: 12,548.
- Perfect Tesla canon: 1,098 verses. Hapax legomena: 4,784.