Skip to main content
Glama
Intentions MCP Server

Intentions MCP Server

Official

Personalized timing intelligence for AI agents. Ask "Should I do X on this date?" and get a 0–100 alignment score, a clear verdict, and the reasoning behind it — grounded in the user's personal energy profile and the Five Elements framework.

Built for agentic workflows: trip planning, product launches, content calendars, interview/meeting scheduling, negotiation prep, and relationship/family timing.


What it does

You give it a decision and a time window; it returns a structured reading your agent can reason over and explain in plain language:

  • Score (0–100) and a verdict (e.g. favorable, proceed with caution, wait)

  • Friction (0–100) — an independent measure of execution resistance

  • Element breakdown and per-layer (year / month / day / hour) signals

  • Adverse alerts with actionable, behavioral guidance — never event predictions

Chain the tools to narrow from "which year" → "which month" → "which day" → "which hour".


Related MCP server: OpenFate Bazi MCP

Tools

Tool

What it answers

Tier

intentions_ask_year

A full calendar year as a whole

Free

intentions_ask_month

A specific month, a comparison, or the best month in a window (≤12 months)

Free; scanning a window is Pro

intentions_ask_day

A specific date, comparison, or best day in a range (≤31 days)

Free; a range beyond the past week and the week ahead is Pro

intentions_ask_hour

Best hour within a day; morning vs afternoon

Pro

intentions_energy_chart

ASCII chart overview — weekly (free for the past and coming week), yearly / hourly (Pro)

Mixed

intentions_set_birth_info

Register or update the user's birth date / time / gender

Free

intentions_get_profile

Read the currently stored birth info

Free

All timing inputs must fall within currentYear − 3 … currentYear + 3.


Installation

The server is remote (Streamable HTTP) — nothing to install or self-host.

  1. Create an account at https://intentions.me

  2. Generate an API key from your account page (format: itm_…)

  3. Add the server to your MCP client using the config below

Claude Desktop / MCP client config

{
  "mcpServers": {
    "intentions": {
      "type": "http",
      "url": "https://mcp.intentions.me/mcp",
      "headers": {
        "Authorization": "Bearer itm_your_api_key_here"
      }
    }
  }
}

claude.ai custom connector

Add a custom connector with:

  • URL: https://mcp.intentions.me/mcp

  • Authentication: Bearer token — paste your itm_… key


Authentication

Every request authenticates with a Bearer API key in the Authorization header:

Authorization: Bearer itm_0123456789abcdef0123456789abcdef

Keys are issued per account at https://intentions.me/account. Treat the key like a password — it carries your quota and your stored energy profile.


Pricing

Free

Pro

Day / month / year readings

5 per day (resets midnight UTC)

Unlimited

Scanning and charting days

The past week and the week ahead

3 years either side of today

Scanning months, yearly charts

—

✓

Hour-by-hour precision (ask_hour, hourly charts)

—

✓

The free tier is enough to evaluate the server end-to-end. See https://intentions.me/pricing for current Pro pricing.



This repository contains documentation only. The Intentions MCP Server is a hosted, proprietary service; the implementation source is not open source.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to perform Chinese metaphysics calculations including BaZi charts, Tong Shu indicators, solar terms, and more, using a verified engine with 740+ tests.
      8
      8
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to calculate deterministic Bazi (Four Pillars) charts with True Solar Time and Earthly Branch interactions, avoiding LLM hallucination of calendrical math.
      6
      161 npm
      162
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Provides Chinese metaphysical tools (bazi, qimen, five elements) as MCP tools for AI agents to give personalized advice on timing, compatibility, and daily energy.
      5
      82 npm
      2
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to cast deterministic BaZi, Zi Wei Dou Shu, and Western astrology natal charts from birth details, with no setup or API key.
      1
      68 npm
      MIT