
Asktian MCP server
online · 100% uptimeio.github.douglasgan/asktian·v0.3.3·1 starsChinese metaphysics (bazi, qimen, 5-element) as decision-support tools for AI agents.
1 stars87 downloads/wk
Reviews
Write oneNobody has reviewed Asktian yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Asktian tools (6)
write = sends, deletes, buys or postsasktian_best_time_for_actionFreeFind the most auspicious time windows in the next N days for a specific action. Use this when the user asks 'when should I do X', 'should I move this meeting', 'is tomorrow a good day to launch', 'when should I have the hard conversation', etc. Returns top 3 best windows and any windows to avoid. This is the most useful tool for real-time decision support inside any AI assistant — it lets you give specific scheduling advice instead of vague reflections.
asktian_compatibilityFreeCompute fate compatibility between two people via Chinese metaphysics (八字 pairing, 5-element generation/clash). Returns qualitative label first (e.g. '互补型 Complementary'), then a numeric score (hidden if <60 to avoid making low-compat feel like rejection — this is intentional per the asktian design principles). Useful when user asks about compatibility, fit, or 'will this person and I work'.
asktian_daily_readingFreeGet today's personalized Chinese metaphysics (八字 bazi + 干支 daily energy) reading for a person. Returns their archetype (one of 8 trigrams 八卦), today's energy, favorable colors/direction/hours, headline advice, and any caution. Use this when the user asks how today will be for them, what colors to wear, where to face their desk, or for general daily guidance.
asktian_market_readFreeGet a Chinese-metaphysics signal on a binary prediction-market question (Polymarket/Kalshi style yes/no outcomes). Use when a user — or a trading agent — wants an UNCORRELATED, for-fun read on a market: 'will X happen by date Y'. Returns a lean (yes/no/neutral), a confidence, the 五行 reasoning from the resolution date's energy, and a mandatory disclaimer. This is ENTERTAINMENT and a falsifiable ritual — NOT financial advice. Always present it as a novelty signal, never as a recommendation to place a bet.
asktian_name_analysisFreeQuick energetic profile of a name (姓名学 name-analysis). Useful when the user asks about someone's name, a baby name, a company name, or 'what kind of person is X' when no birthdate is available. Returns a one-line vibe + dominant element guess.
asktian_today_energyFreeGet today's GENERAL energy (no person needed) — the 干支 (stem + branch) and the dominant 5-element character of the day. Useful when the user asks 'what kind of day is it', 'what's the energy today', or when an AI agent wants to add cosmic context to a generic suggestion without needing the user's birthdate.
Public scan report
scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it
- Code scan29 source files scanned25/25
- Live reliabilityremote reachable in 2562ms17/20
- Tool poisoning6 tool descriptions checked15/15
- Auth qualityopen endpoint, read-only tools10/15
- Maintenancelast push 98 days ago8/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Asktian compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 65% of 48,255 servers
- Tools
- 6
- the typical server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- Uptime
- 100%
- of our recent checks; the typical remote server answers 100%
- Response time
- 740 ms
- faster than 18% of 30,031 servers
- GitHub stars
- 1
- more than 65% of 28,688 servers
- Downloads a week
- 87
- more than 60% of 12,191 servers with a package
What its tools let an agent do: 6 read
Install Asktian in Claude Code, Cursor or VS Code
claude mcp add --transport http asktian https://mcp.asktian.com/mcp
What the publisher says
From the Asktian repository's README, as published. We do not edit it. Read it on GitHub
asktian MCP server
Chinese metaphysics inside your AI assistant.
不知道就问天 · Ask tian when you don't know.
Adds 4000 years of Chinese metaphysical traditions (bazi / 八字, qimen / 奇门, five elements, daily 干支 energy) as callable tools for any AI agent that speaks the Model Context Protocol — Claude Desktop, Claude Code, Cursor, Windsurf, Zed, and any MCP-compatible client.
When you ask your AI assistant a timing, person, or decision question, it can quietly consult asktian before answering.
The decision layer for AI agents. Agents already plug in search, memory, and payments — askTIAN is the layer that gives them a stance: a specific, falsifiable call instead of "it depends." → Why it sells · 2-min quickstart
### ✨ Real readings, no key needed.
The tools call the live askTIAN backend and return real results — daily almanac, fate
compatibility, name analysis, day energy — straight out of the box. The read endpoints are
public and rate-limited (~300 requests / 15 min). An optional ASKTIANAPIKEY
(api.asktian.com) raises the limit and unlocks the **premium
tian. reading tier. marketread is a deterministic local novelty signal; besttime
returns a guided preview (no backend endpoint yet).
You: "I have a hard conversation with my boss tomorrow at 3pm. Should I move it?"
Claude (with asktian MCP):
→ calls asktian_best_time_for_action({ birthdate, action: "difficult_conversation" })
→ "Friday 10am scores much higher. Tomorrow 3pm is your clash hour.
Want me to draft a message to reschedule?"Install
npm install -g @asktian/mcp-serverThen add to your client's MCP config:
Claude Desktop
Edit ~/Library/Application Support/Claude/claudedesktopconfig.json (macOS) or %APPDATA%\Claude\claudedesktopconfig.json (Windows):
{
"mcpServers": {
"asktian": {
"command": "asktian-mcp",
"env": {
"ASKTIAN_API_KEY": "at_live_xxxxxxxxxxxxxxxx"
}
}
}
}Restart Claude Desktop. Look for the 🔌 icon — asktian should appear with 6 tools.
Cursor
Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"asktian": {
"command": "asktian-mcp",
"env": {
"ASKTIAN_API_KEY": "at_live_xxxxxxxxxxxxxxxx"
}
}
}
}Windsurf
Add to ~/.codeium/windsurf/mcp_config.json — same shape as above.
Zed
Add to your Zed settings under assistant.mcp_servers — same command + env.
Any other MCP client
Run asktian-mcp as a subprocess; it speaks JSON-RPC over stdio per the MCP spec.
Remote / hosted (streamable-HTTP)
For LangChain, LlamaIndex, Fetch.ai, or any agent that connects to a hosted MCP endpoint, run the server in HTTP mode instead of stdio:
ASKTIAN_MCP_HTTP=1 PORT=8080 npx -y @asktian/mcp-server
# → streamable-HTTP on :8080/mcp (health check: GET :8080/health)Hosted at https://mcp.asktian.com/mcp. Pass your key as a Bearer header: Authorization: Bearer YOURASKTIANAPI_KEY.
LangChain & LlamaIndex
Both have native MCP adapters — askTIAN works with zero integration code. Copy-paste snippets in docs/langchain-llamaindex.md.
API key
The key is optional — readings are real either way.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Asktian: common questions
- Is Asktian MCP server safe?
- Mostly: it is graded B (83/100). Read the Asktian safety report
- How do I install Asktian?
- It runs remotely at mcp.asktian.com. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does Asktian need an API key?
- Yes. The registry entry asks for
ASKTIAN_API_KEY. - Is Asktian maintained?
- The last commit was 137 days ago (2026-06-20). The latest release is v0.3.3.
- Is Asktian up?
- 100% of our last 28 checks got an answer. We check remote servers about four times a day.
- How does Asktian compare with other MCP servers?
- safety score 83/100 (higher than 65% of 48,255 servers); tools 6 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.