Log inSubmit server
Asktian logo

Asktian

by douglasgan

Adds Chinese metaphysics tools for daily readings, compatibility, name analysis, timing decisions, and market signals.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Asktian

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "douglasgan-asktian": {
      "command": "npx",
      "args": [
        "-y",
        "@asktian/mcp-server"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

douglasgan/asktian MCP server adds Chinese metaphysics readings and decision-support tools to MCP-compatible AI clients. It calls the live askTIAN backend for daily readings, compatibility, name analysis, and day energy, while timing and market tools have distinct local or preview behavior. Install the npm package for stdio use, or run it in streamable-HTTP mode for hosted agents. Reach for it when an agent needs culturally specific readings or concrete time-window suggestions rather than general advice.

Use cases

  • Request a personalized daily reading from a birthdate
  • Compare two people for relationship or career compatibility
  • Find favorable time windows for a conversation, launch, or negotiation
  • Analyze a baby, company, or product name
  • Generate a novelty metaphysical signal for a binary market question

Key features

  • Daily readings with five-element and stem-branch context
  • Birthdate-based compatibility analysis
  • Recommended time windows for actions
  • Name analysis for English and Chinese names
  • General daily energy readings
  • Deterministic novelty signals for binary market questions

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

9/9 checks healthy over the last 39d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 13h ago via OSV.dev · @asktian/mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars2Stargazers on the source repository.
npm downloads294Package downloads in the last 30 days.
Last commit4mo agoMost recent push to the default branch.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Asktian works

What douglasgan/asktian MCP server does

douglasgan/asktian MCP server exposes six MCP tools based on Chinese metaphysics concepts, including bazi, qimen, the five elements, and daily 干支 energy. It is designed for AI assistants that need to answer questions about personal daily guidance, relationships, names, action timing, or a binary prediction-market question.

The server can provide a personalized daily reading from a birthdate, optional birth time, and gender. It can compare two people across love, career, friendship, or general compatibility. It can also identify three recommended time windows for an action over a configurable number of days, with reasons and periods to avoid. Other tools describe the general energy of a date, analyze a name, or return a deterministic metaphysical signal for a yes/no market question.

How it works

The douglasgan/asktian MCP server communicates with clients through MCP over JSON-RPC. In its default form, an MCP client launches the npm-provided command as a subprocess and sends tool calls over stdio. A streamable-HTTP mode is also available for agents that connect to a network endpoint.

Most reading tools call the live askTIAN backend. They work without a key, subject to an approximate limit of 300 requests per 15 minutes per IP. An optional API key increases limits and enables the premium tian.* reading tier. The market-read tool is computed locally as a deterministic novelty signal, while the best-time tool currently returns a guided preview rather than using a backend endpoint.

Setup and configuration

Install the package globally with npm install -g @asktian/mcp-server, then register asktian-mcp in the MCP configuration for the chosen client. The README provides configurations for Claude Desktop, Cursor, Windsurf, and Zed. Other MCP clients can launch the same command as a subprocess.

The ASKTIAN_API_KEY variable is optional. Set it in the client environment when higher request limits or the premium reading tier are needed; omit it for the default no-key mode. For HTTP operation, set ASKTIAN_MCP_HTTP=1 and optionally choose a PORT; the example uses port 8080. The hosted endpoint is https://mcp.asktian.com/mcp, where the key is supplied as a Bearer authorization header.

Tools and capabilities

The douglasgan/asktian MCP server provides these tools:

  • asktian_daily_reading: Returns a personal daily reading with an archetype, stem-branch energy, favorable colors, direction, hours, and written guidance.
  • asktian_compatibility: Compares two birthdates and returns a qualitative relationship label, category, element flow, advice, and conditional score information.
  • asktian_best_time_for_action: Finds up to three recommended date-and-hour windows for an action and identifies windows to avoid.
  • asktian_today_energy: Describes a date's stem and branch plus its dominant five-element character; the date defaults to today.
  • asktian_name_analysis: Produces a short energetic profile for an English or Chinese name, with automatic language detection available.
  • asktian_market_read: Returns a yes, no, or neutral signal, score, confidence, reasoning, and disclaimer for a binary prediction-market question.

Limitations and notes

These outputs are metaphysical decision-support readings, not objective forecasts. The market tool is explicitly presented as entertainment and not financial advice. Its signal is deterministic and intended as a novelty that can be evaluated over time.

Compatibility scores below 60 may be hidden, with the qualitative label taking precedence. Clients should respect the response's should_show_score and note_for_ai guidance rather than exposing a suppressed number. The API is rate-limited without a key, and the best-time feature is currently a guided preview. LangChain and LlamaIndex support the server through their native MCP adapters, with setup examples supplied in the repository documentation.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Asktian

douglasgan/asktian is an MCP server that connects AI assistants to the live askTIAN backend and exposes tools for daily readings, compatibility, action timing, day energy, name analysis, and market signals. It supports stdio and streamable HTTP, with no API key required for its default rate-limited mode.

Install it with `npm install -g @asktian/mcp-server`, then configure `asktian-mcp` as an MCP subprocess in your client. The README includes setup examples for Claude Desktop, Cursor, Windsurf, and Zed.

Yes, douglasgan/asktian works with Cursor through its MCP configuration. Add an `asktian` entry using the `asktian-mcp` command in `~/.cursor/mcp.json`, and optionally provide `ASKTIAN_API_KEY` in the environment.

No, an API key is optional. Without one, the server returns live readings subject to an approximate 300-requests-per-15-minutes-per-IP limit; setting `ASKTIAN_API_KEY` raises limits and unlocks the premium `tian.*` tier.

Run `ASKTIAN_MCP_HTTP=1 PORT=8080 npx -y @asktian/mcp-server` to start streamable HTTP on port 8080. Remote clients can instead use `https://mcp.asktian.com/mcp` and send the API key as a Bearer authorization header.

Related MCP servers

All in Spirituality & Esoterica All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewAsktian AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/douglasgan-asktian?style=directory)](https://allmcps.com/mcp/douglasgan-asktian)
HTML Embed
<a href="https://allmcps.com/mcp/douglasgan-asktian"><img src="https://allmcps.com/api/badge/douglasgan-asktian?style=directory" alt="Asktian on AllMCPs" /></a>