RoxyAPI
Quick StartPlaygroundSDKMCP SetupFree TemplatesAGENTS.md

Vastu Shastra API

Directional design with the verse behind every verdict.

Vastu ShastraVastu EntranceVastu Purusha MandalaAyadi ShadvargaGriha Pravesh Muhurta …and so much more

Get API KeyRead Docs
MCP DocsOpenAPI Schema
Rated 4.5 by 127 developers
99.95%+uptime
Includedwith every plan(at no extra cost)
AstrologyVedicForecastHuman DesignChinese AstrologyFeng ShuiMesoamericanNumerologyKabbalahTarotBiorhythmAyurveda+5 more
11,693 tests per deploy, 2801 NASA JPL verified10 open source templatesllms.txt for AI agents18 domains, 1 API keyAll 18 domains from $39/mo

Start building in seconds.

Want to try without writing code? Try this domain live in API playground →

Terminal
npm install @roxyapi/sdk
import { createRoxy } from '@roxyapi/sdk'

const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.vastu.get(/* ... */)
SDK docs

Want to ship faster? Clone a free template and go from zero to production in 30 minutes.

Building with Cursor, Claude Code, or Bolt? Use our AI prompts to generate a complete app in minutes.

Building on WordPress? Install the RoxyAPI plugin and drop a shortcode, no code required.

POST /api/v2/vastu/entrance
{
  "pada": 3,
  "side": "East",
  "startCorner": "Northeast",
  "ordinalOnSide": 3,
  "square": 3,
  "cell": {
    "rowFromNorth": 3,
    "columnFromWest": 9
  },
  "devata": {
    "id": "jayanta",
    "name": "Jayanta",
    "padaCount": 2
  },
  "effect": "Great wealth.",
  "auspiciousness": "auspicious",
  "reading": "The main entrance falls on pada 3 of the East side, counted from the Northeast corner. That pada is the square of Jayanta. Great wealth.",
  "recommendedPadas": [
    3,
    4
  ],
  "source": {
    "text": "Brihat Samhita",
    "chapter": 53,
    "verse": "72",
    "translation": "N. Chidambaram Iyer",
    "year": 1884,
    "publicDomain": true
  },
  "conventions": {
    "grid": "81-pada"
  }
}

Structured JSON with documented fields. Not hallucinated text. See all endpoints

Works with your stack

Claude CodeCursorAntigravityChatGPTWindsurfVS Code CopilotOpenAI AgentsGeminiLangChainCrewAIVercel AI SDK

Vastu Shastra API for directional home and plot analysis: entrance padas with the classical effect of each of the 32 perimeter positions, the Vastu Purusha Mandala projected over a real plot on the 81 pada or the 64 pada grid, room placement checks over a closed room enum, Ayadi shadvarga across three text families, plot shape and ground level under two schools that genuinely disagree, and griha pravesh dates composed over a verified panchang. Every verdict carries the chapter and verse it rests on as a typed field, or says plainly that it is convention. Directional design from Indian architecture, sitting beside our feng shui endpoints on one key, with Remote MCP and typed SDKs.

Every Vastu calculation is covered by 11,693 automated tests per deploy, 2,801 of them gold-standard tests locked to named external references such as NASA JPL Horizons, with a public MIT benchmark repo anyone can clone and re-run. See how we test.

Multi-language API responses

DeutschEnglishEspanolFrancaisHindiPortuguesRusskiyTurkce

Key Features

Everything you need from our Vastu Shastra API, built for production:

Every verdict carries a typed source object naming the text, chapter, verse, translator and edition year, or the literal value convention with the practice it rests on, so a printed report can show which half of it is classical

The Vastu Purusha Mandala projected over a real plot on either the 81 pada Paramasayika or the 64 pada Manduka grid, with the devata of every square, the brahmasthan as a polygon you can draw, the marma points, the six vamsa diagonals named by their devatas and the nine atimarma crossings

All 32 entrance padas with the classical effect of each, resolved from a door coordinate or a fraction along the facing side, plus the favourable padas on the same side to move a door toward

Ayadi shadvarga across three text families that disagree, with the multiplier, divisor, product and remainder shown for every varga so the arithmetic can be checked by hand rather than trusted

A typed cubit: the unit and the hasta length are inputs rather than hidden constants, because every Ayadi remainder is unit sensitive and a silent default makes a stored reading unreproducible

Ground level read under two schools at once, the classical verses and the widely taught modern rule, which contradict each other on a slightly higher east or north, so a practitioner can reconcile our verdict with their teacher instead of arguing with it

Room placement over a closed enum of twelve room types, with the four the chapter actually places carrying a verse and the other eight labelled convention, and a composite score whose weights are published on the response

Griha pravesh date search composed over our own verified panchang, reading the nakshatra, tithi, weekday and solar position at sunrise, with the rules a date search cannot settle published rather than quietly dropped

Two Muhurta texts as a typed switch, one admitting eight nakshatras and the other twelve, because they are independent witnesses and the difference is worth exposing rather than averaging

Direction identifiers shared with the feng shui and I Ching endpoints, so a Vastu quarter and a flying star palace compare without a lookup table

All 10 Endpoints

Every one is live in the public OpenAPI spec and callable as an MCP tool. Click any endpoint to view detailed documentation, parameters, and response examples.

Calculate entrance pada - Vastu main door direction APIVastu entrance analysis for a main door: send the plot and where the door sits, and the API returns which of the 32 perimeter padas it falls on, the devata of that square, the effect the classical chapter gives that pada, and the favourable padas on the same side to move toward. Every verdict carries the chapter and verse it comes from as a typed field, and the reading holds on either the 81 pada or the 64 pada division. Built for property and interior design tools, practitioner reports, and any product that has to say whether a front door is well placed.Generate Vastu Purusha Mandala - 81 pada and 64 pada grid APIVastu Purusha Mandala projected over a real plot: send the ground and the API returns every square with the devata holding it, the brahmasthan as a polygon you can draw, the marma points, the six vamsa diagonals named by their devatas and the nine atimarma crossings. Choose the 81 pada Paramasayika or the 64 pada Manduka, and the response says which verses each part rests on. Built for floor plan overlays, practitioner reports and any tool that has to place rooms against the classical grid.Analyse a plot - Vastu land and site assessment APIVastu plot analysis from typed geometry: send the outline, the facing, where the ground falls and where the water is, and the API returns a verdict on the shape, the proportion, the ground level under two schools, each corner extension and cut, the road and the water. Every verdict names the chapter and verse behind it, or says plainly that it is convention, which matters because the ground level verses and the widely taught modern rule genuinely disagree. Built for listing and land assessment tools, practitioner site reports and buyer facing checks.Calculate Ayadi shadvarga - Vastu proportion and yoni calculator APIAyadi shadvarga calculator for a building or a room: send the dimensions and the API returns all six proportional formulas with the multiplier, the divisor and the remainder shown, the member each remainder names, and the two verdict rules the texts state. Choose between three text families, which genuinely disagree, and choose your own cubit length, because every remainder is unit sensitive. Built for practitioner tools, plan checking software and anyone who has to justify a dimension rather than assert it.Check room placement - Vastu room direction compliance APIVastu room direction check for a whole floor plan: send the plot and a list of rooms, by quarter or by outline, and the API returns a verdict per room with the quarters it belongs in, the quarters to keep it out of, a remedy when it is misplaced, and a composite score with the weights published. Four of the twelve room types carry a chapter and verse and the other eight are labelled convention, so a report can say which half of it is classical. Built for floor plan tools, listing checks and practitioner reports.Find griha pravesh dates - Vastu house warming muhurta APIGriha pravesh muhurta search over a date window: send the window and the place, and the API returns every day that clears the classical day-level rules, with the nakshatra, tithi, weekday and solar position that qualified it and the rule ids that admitted it. Two Muhurta texts disagree on the admissible nakshatras and you choose which one leads, and the rules a date search cannot settle are published rather than dropped. Built for house warming date pickers, practitioner scheduling and agent assistants that have to answer when a family should move in.List the eight directions - Vastu dikpala and direction reference APIReference table of the eight Vastu directions: the dikpala who rules each quarter of the horizon, the squares of the mandala it covers with their devatas, what the chapter places on that side, and what standing water there brings. A pure reference endpoint with no plot required, for building a picker or a directions guide. Every row says which verse each part comes from and labels the element as the later convention it is.Look up one direction - Vastu dikpala reference APILook up one Vastu direction: its dikpala, the mandala squares it covers with their devatas, what the chapter places there, and what standing water in that quarter brings. Case and punctuation in the id are folded, so north-east, northeast and NorthEast all resolve to the same entry, and the id space is the one the feng shui and I Ching endpoints use.List the 45 devatas - Vastu Purusha Mandala reference APIReference table of the 45 devatas of the Vastu Purusha Mandala: which squares of the 81 pada grid each one holds, which ring and which side, how many padas, and the verses that place it. A pure reference endpoint with no plot required, for building a mandala diagram or a glossary. Where the sources contradict each other, and they do on several rows, the row says so instead of quietly picking a side.Look up one devata - Vastu mandala devata reference APILook up one devata of the Vastu Purusha Mandala: the squares it holds, its ring and side, its pada count, the entrance pada it governs where it sits on the perimeter, and the verses that place it. Case and punctuation in the id are folded, so indra-outer, Indra_Outer and INDRA OUTER all resolve.

What You Can Build with Vastu Shastra API

Real-world applications and use cases for integrating Vastu Shastra API into your projects:

Property and interior design tools: plot verdicts, mandala overlays on a floor plan and room by room compliance

Real estate listing platforms: a directional check on a plot or a plan from typed geometry, with no drawing upload

Practitioner and consultation software: Ayadi proportions, mandala geometry and citations a client report can print

House warming and scheduling features: griha pravesh dates over a season, with the limb that qualified each day

AI assistants and chatbots: directional answers over Remote MCP with the classical effect text behind them

Content and editorial platforms: devata, direction and pada reference lookups for explainer pages and structured libraries

What developers are saying

DM

Dhani M.

Indie App Developer

Shipped an astrology app over a long weekend. Birth charts, nakshatras, KP cusps, significators. I verified the Lahiri ayanamsha values independently and they line up with my reference. One API key for all of it.

Email feedback
TH

Tom H.

Senior Developer

The OpenAPI spec is the most complete I have seen in this space. Generated a type-safe TypeScript client from it in seconds. Every field has descriptions and examples. Production-grade documentation.

Email feedback
CW

Chris W.

Backend Engineer

Response times consistently under 50ms for numerology and tarot endpoints. The API returns structured JSON with every field documented. Integrated it into our platform in an afternoon.

Email feedback
Read all 127 reviews

Do not take our word for it. Ask the agents.

The receipts are public: the testing methodology, the open MIT benchmark, the transparency report, and the live API playground. Let ChatGPT, Perplexity, or Claude search the web and tell you what they find about RoxyAPI accuracy, MCP, SDKs, and pricing.

Ask ChatGPTAsk PerplexityAsk Claude

Opens a live web search in a new tab.

Getting started with Vastu Shastra API.

From zero to production in 3 steps. No signup required for testing.

3 Steps to Ship

1Install the SDKnpm i @roxyapi/sdk
2Get your API keyView Plans
3Make your first callView Docs

Agent-Ready Infrastructure

MCP

Remote MCP, llms.txt, and AGENTS.md. The full agent-readiness stack for 18+ domains under one key.

  • Remote MCP server — every endpoint auto-discovered as a tool by Claude, ChatGPT, Cursor over Streamable HTTP. No Docker.
  • Token-optimized responses — opt-in compact mode returns the same data with each field name sent once, cutting the tokens your agent reads per call by roughly 40 to 52 percent. Lossless, and one call still counts as one request.
  • llms.txt — AI-native discovery surface for ChatGPT, Perplexity, and Gemini citation
  • AGENTS.md — 2026 execution playbook for Cursor, Codex, Windsurf, Aider, Claude Code, Gemini CLI. Bundled in the SDK.
MCP DocsAGENTS.mdLLMs.txtAI Prompts

From your AI agent to a verified Vastu answer.

Your AI agentyour model, your voice
Remote MCPauto-discovered, no local setupToken-optimized
Roxy Ephemeris11,693 tests, 2801 vs NASA JPL
Verified result18 domains, one flat rate

Your agent grounds every answer in verified calculations and replies in your own voice, so it never hallucinates a chart, date, or reading. No local setup, no AGPL, no hosted-AI markup.

Audit it yourself: every Vastu endpoint runs live in the API playground

Vastu Shastra API FAQ

Which direction should the main entrance face?

The classical answer is not a direction but a pada. The perimeter of the plot divides into 32 positions, eight to a side, and each one carries its own stated effect, so a north facing door on a poor pada is worse than a south facing one on a good pada. Send the plot and where the door sits and the entrance endpoint returns the pada, the devata of that square, the effect and the favourable padas on the same side to move toward.

What is the brahmasthan and why does it matter?

The brahmasthan is the central block of the mandala, nine squares of the eighty one or four of the sixty four, held by Brahma. It is the part of a plan kept open, and the chapter is blunt about a gate that faces it. The mandala endpoint returns it as a polygon in your own plot coordinates, so it can be drawn straight onto a plan and checked against what stands there.

What is Ayadi and what does the calculator return?

Ayadi shadvarga is a set of six proportional formulas applied to the dimensions of a building, each multiplying a measure and taking the remainder of a division. The API returns the multiplier, divisor, product and remainder for every one of the six, the member each remainder names where a source names one, and the two verdict rules the texts state. Where the aya and vyaya names are not printed in any public domain source, it returns the remainder and the group size and no invented name.

Why does the ground level verdict differ from what a consultant told me?

Because the classical verses and the modern teaching genuinely disagree, and the API returns both rather than choosing. The verses call a higher north-east a loss and expressly allow a slightly higher east or north where level ground is unavoidable; the widely taught modern rule wants the north-east lowest and permits neither. Send the school you want to lead with and the other reading comes back beside it, each with its verse or with a plain statement that it rests on teaching practice.

Does any of this need a birth chart?

No. Every route takes geometry, a facing and, for the date search, a place and a window. There is no owner chart route and no numerological facing route, because no primary text ties a birth nakshatra or a radical number to a house facing, and a route that invented one would be the least defensible thing in the domain. The date search does apply owner independent rules and publishes the owner dependent ones it cannot settle.

Does it work outside India?

Yes. The mandala is geometry aligned to the compass, so it projects over a plot in Lisbon exactly as it does over one in Chennai, and the direction identifiers are the same ones the feng shui endpoints use. The date search takes any latitude, longitude and offset and reads every limb at local sunrise, and it falls back to local midnight rather than refusing inside a polar night.

Start using Vastu Shastra API today.

Directional design with the verse behind every verdict.

All 18 domains included with every plan. Every endpoint, MCP server, SDK, and starters.

Plans from $39/mo, starting at $1.80 per domain on annual billing. No credit card required for testing.

View Pricing & Get API Key