Intentions MCP Server

intentions-me/intentions-mcp

Connects Claude to a hosted timing intelligence API built on Five Elements theory and personal energy profiles. You get seven tools: query alignment scores (0-100) for decisions across year, month, day, or hour windows, visualize energy charts at weekly/yearly/hourly granularity, and store birth info for personalized readings. Returns structured verdicts (favorable, proceed with caution, wait) plus friction scores and adverse alerts you can chain into agentic workflows. Useful when you're building trip planners, launch schedulers, or meeting optimization agents that need to factor in personal timing beyond just calendar availability. Free tier gives you five day/month/year readings daily; Pro unlocks hourly precision and unlimited queries. Remote only, authenticate with a Bearer token from intentions.me.

GitHub stars: 1
tools: 7
auth: Secret needed
transport: HTTP
last updated: Oct 18, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://mcp.intentions.me/mcp --name intentions-mcp --header 'Authorization: Bearer ${API_TOKEN}'

Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http intentions-mcp https://mcp.intentions.me/mcp --header 'Authorization: YOUR_AUTHORIZATION'

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 7 tools

Verified live against the running server on Nov 6, 2026.

intentions_ask_dayCall when the user asks about timing a decision for a specific date, or wants to pick the best day from a multi-day window. Covers trip dates, launch days, interview/meeting days, publish/send dates, travel, negotiation windows, relationship moments — any "when to X" question...6 params

Call when the user asks about timing a decision for a specific date, or wants to pick the best day from a multi-day window. Covers trip dates, launch days, interview/meeting days, publish/send dates, travel, negotiation windows, relationship moments — any "when to X" question...

Parameters* required

birthInfoobject

Optional override. If provided, all 6 fields required: { year, month, day, hour, minute, gender } — use null for unknown hour/minute/gender. Omit entirely to use the stored profile.

categorystring

Decision domain — tunes the analysis weighting. Default: general.one of career · relationship · health · finance · travel · general

compareDatesarray

Up to 4 additional YYYY-MM-DD dates to compare against targetDate

dateRangeobject

Find best dates in range. Max 31 days — use ask_month for longer windows. Free tier: the past week and the week ahead only.

question*string

The decision or action being considered

targetDatestring

YYYY-MM-DD. Default: today

intentions_ask_hourCall when the user asks about timing within a specific day — best hour to act, morning vs afternoon, when during the day ("best time today to X", "morning or afternoon for Y", "几点去见面好"). Use for interview slots, meeting times, send/publish times, departure times, workout windo...7 params

Call when the user asks about timing within a specific day — best hour to act, morning vs afternoon, when during the day ("best time today to X", "morning or afternoon for Y", "几点去见面好"). Use for interview slots, meeting times, send/publish times, departure times, workout windo...

Parameters* required

bestInDayobject

Find best hours within a single day. Each entry carries an explicit `window` span.

birthInfoobject

Optional override. If provided, all 6 fields required: { year, month, day, hour, minute, gender } — use null for unknown hour/minute/gender. Omit entirely to use the stored profile.

categorystring

Decision domain — tunes the analysis weighting. Default: general.one of career · relationship · health · finance · travel · general

compareHoursarray

Up to 4 additional (date, clock-hour 0..23) pairs to compare against targetDate+targetHour. Pairs that resolve to the same 2-hour block (e.g. hours 7 and 8 on the same date) are deduplicated — subm...

question*string

The decision or action being considered

targetDatestring

YYYY-MM-DD. Default: today (single mode only)

targetHourinteger

Clock hour 0..23. Auto-rounded to the containing 2-hour block. 23:XX rolls the effective day forward by one.

intentions_ask_yearCall when the user asks about a full calendar year as a whole ("how is 2026", "今年怎么样", "what's next year like overall"). Returns year-level score, verdict, adverse alerts, and element dimensions. For month precision use `intentions_ask_month`; for day use `intentions_ask_day`....4 params

Call when the user asks about a full calendar year as a whole ("how is 2026", "今年怎么样", "what's next year like overall"). Returns year-level score, verdict, adverse alerts, and element dimensions. For month precision use `intentions_ask_month`; for day use `intentions_ask_day`....

Parameters* required

birthInfoobject

Optional override. If provided, all 6 fields required: { year, month, day, hour, minute, gender } — use null for unknown hour/minute/gender. Omit entirely to use the stored profile.

categorystring

Decision domain — tunes the analysis weighting. Default: general.one of career · relationship · health · finance · travel · general

question*string

The decision or action being considered

targetYearinteger

YYYY. Default: current year. Allowed: currentYear-3 .. currentYear+3.

intentions_ask_monthCall when the user asks at month granularity or wants the best month from a multi-month window ("how is next month", "best month in 2026 to X", "下个月适合吗"). Use for trip-month selection, launch months, content-calendar planning, quarterly/annual decisions. Modes: single month, c...6 params

Call when the user asks at month granularity or wants the best month from a multi-month window ("how is next month", "best month in 2026 to X", "下个月适合吗"). Use for trip-month selection, launch months, content-calendar planning, quarterly/annual decisions. Modes: single month, c...

Parameters* required

birthInfoobject

Optional override. If provided, all 6 fields required: { year, month, day, hour, minute, gender } — use null for unknown hour/minute/gender. Omit entirely to use the stored profile.

categorystring

Decision domain — tunes the analysis weighting. Default: general.one of career · relationship · health · finance · travel · general

compareMonthsarray

Up to 4 additional YYYY-MM months to compare against targetMonth

monthRangeobject

Find best months in range. Max 12 months. Inclusive on both ends. Free inside last year and this year; Pro further out.

question*string

The decision or action being considered

targetMonthstring

YYYY-MM. Default: current month

intentions_energy_chartCall when the user wants a visual overview rather than a narrative answer ("show me this week", "chart for today", "next 12 months", "看一下图"). Returns an ASCII chart: `hourly` = 12 two-hour blocks of one day, `weekly` = 7 days, `yearly` = 12 months. The `hourly` mode emits the...3 params

Call when the user wants a visual overview rather than a narrative answer ("show me this week", "chart for today", "next 12 months", "看一下图"). Returns an ASCII chart: `hourly` = 12 two-hour blocks of one day, `weekly` = 7 days, `yearly` = 12 months. The `hourly` mode emits the...

Parameters* required

birthInfoobject

Optional override. If provided, all 6 fields required: { year, month, day, hour, minute, gender } — use null for unknown hour/minute/gender. Omit to use the stored profile.

datestring

YYYY-MM-DD. Default: today

period*string

Which chart to render: `hourly` = 12 two-hour blocks of one day (Pro), `weekly` = 7 days from `date` (free inside the past week and the week ahead), `yearly` = the 12 months of the year of `date` (...one of hourly · weekly · yearly

intentions_set_birth_infoCall once to register the user's birth date/time/gender. Each call is a complete replacement — all 6 fields must be supplied. For fields the user does not know or prefers not to share, pass `null` explicitly (e.g. `hour: null` for unknown birth time, `gender: null` for unspeci...8 params

Call once to register the user's birth date/time/gender. Each call is a complete replacement — all 6 fields must be supplied. For fields the user does not know or prefers not to share, pass `null` explicitly (e.g. `hour: null` for unknown birth time, `gender: null` for unspeci...

Parameters* required

birthPlacestring

City of birth, optionally with region or country ("Portland, Maine"). Ask the user for it. Omit or null only to keep the stored birthplace.

birthTimeFoldinteger

Only after a birth_time_needs_confirming error: 0 = the earlier of the two possible moments, 1 = the later.one of 0 · 1

day*integer

Birth day of month, 1–31.

gender*string

null if unspecifiedone of M · F

hour*integer

null if unknown

minute*integer

null if unknown; requires hour to also be non-null

month*integer

Birth month, 1–12.

year*integer

Birth year, 1920–2030.

intentions_get_profileFetch the user's currently stored birth info. Use this before `intentions_set_birth_info` when updating an existing profile so you can send back a complete merged payload. Returns { hasProfile, birthInfo: { year, month, day, hour, minute, gender } | null, profileChanges: { rem...

Fetch the user's currently stored birth info. Use this before `intentions_set_birth_info` when updating an existing profile so you can send back a complete merged payload. Returns { hasProfile, birthInfo: { year, month, day, hour, minute, gender } | null, profileChanges: { rem...

No parameters. Call it with no arguments.

Readme

Intentions

Intentions MCP Server

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.

Homepage: https://intentions.me
MCP endpoint: https://mcp.intentions.me/mcp (Streamable HTTP)

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

View the full README on GitHub

Details

Repository: github.com/intentions-me/intentions-mcp
Website: intentions.me
Transport: HTTP
Auth: Required
Registry: MCP registry, active
Tools verified: Nov 6, 2026