Asktian
by douglasgancommunityv0.3.3
This MCP server exposes Chinese metaphysics readings and decision tools to MCP-compatible AI clients. It provides live daily readings, compatibility checks, auspicious timing, today’s energy, name analysis, and a novelty market signal, with optional API-key access for higher limits and premium readings.
From the registry: Chinese metaphysics (bazi, qimen, 5-element) as decision-support tools for AI agents.
Install & configure
Prerequisites
- requiredInstall the npm package globallyInstall the Asktian MCP server package so the `asktian-mcp` command is available.
$ npm install -g @asktian/mcp-server - optionalOptional: Get an Asktian API keyOptional for higher rate limits and access to the premium `tian.*` reading tier. The server works without a key using public rate-limited endpoints.https://api.asktian.com
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `asktian` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install the npm package globally** — Install the Asktian MCP server package so the `asktian-mcp` command is available. Run: `npm install -g @asktian/mcp-server`
Optional prerequisites:
- Optional: Get an Asktian API key — Optional for higher rate limits and access to the premium `tian.*` reading tier. The server works without a key using public rate-limited endpoints. (https://api.asktian.com)
Canonical MCP server config (stdio transport):
- command: `asktian-mcp`
- args: []
- optional environment variables:
- `ASKTIAN_API_KEY`: Optional Asktian API key for higher rate limits and premium `tian.*` readings. Omit to use the public rate-limited backend. (example: `<your-asktian-api-key>`)
Note: The README also documents HTTP mode. For hosted/remote use, run with `npx -y @asktian/mcp-server` and set `ASKTIAN_MCP_HTTP=1` plus `PORT`; the endpoint is served at `/mcp`. A hosted endpoint is available at `https://mcp.asktian.com/mcp` and can use an `Authorization: Bearer <your-asktian-api-key>` header. Per the portability rule, the canonical config uses the simpler stdio setup with the installed `asktian-mcp` command.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: The README also documents HTTP mode. For hosted/remote use, run with `npx -y @asktian/mcp-server` and set `ASKTIAN_MCP_HTTP=1` plus `PORT`; the endpoint is served at `/mcp`. A hosted endpoint is available at `https://mcp.asktian.com/mcp` and can use an `Authorization: Bearer <your-asktian-api-key>` header. Per the portability rule, the canonical config uses the simpler stdio setup with the installed `asktian-mcp` command.
Tools (6)
asktian_daily_reading
Returns a personalized daily energy reading for a person, including archetype, stem-branch energy, favorable colors/directions/hours, and advice.
asktian_compatibility
Evaluates fate compatibility between two people and returns a qualitative label, category, element flow, advice, and a score if shown.
asktian_best_time_for_action
Finds the best time windows over the next N days for a specific action such as a difficult conversation, negotiation, or launch.
asktian_today_energy
Returns the general energy of a day, including stem-branch, dominant element, and a description.
asktian_name_analysis
Analyzes a name for its energetic profile, dominant element guess, tone, and a short interpretation.
asktian_market_read
Gives a deterministic Chinese-metaphysics signal for a binary prediction-market question, with lean, score, confidence, reasoning, and disclaimer.
Environment variables
ASKTIAN_API_KEYOptional API key for higher rate limits and access to the premium tian.* reading tier.ASKTIAN_MCP_HTTPEnables HTTP/streamable-HTTP mode instead of stdio when set to 1.PORTPort used when running the server in HTTP mode.Packages
@asktian/mcp-server
npmv0.3.3transport: stdio
Remote Endpoints
https://mcp.asktian.com/mcp
type: streamable-http
Details
- Language
- TypeScript
- License
- MIT
- Released
- Jun 20, 2026
- Last commit
- Jun 20, 2026
- Registry name
- io.github.douglasgan/asktian
Related Servers
Claude Flow
AI orchestration with hive-mind swarms, neural networks, and 87 MCP tools for enterprise dev.
64.6k
Codebase Memory Mcp
Persistent codebase knowledge graph. Survives session restarts and context compaction.
31.9k
Serena
A powerful toolkit for coding, providing semantic retrieval and editing capabilities.
26.5k