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
Chain the tools to narrow from "which year" → "which month" → "which day" → "which hour".
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.
- Create an account at https://intentions.me
- Generate an API key from your account page (format:
itm_…) - Add the server to your MCP client using the config below
Claude Desktop / MCP client config```json
{
"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.
Links
- Homepage: https://intentions.me
- Pricing: https://intentions.me/pricing
This repository contains documentation only. The Intentions MCP Server is a hosted,
proprietary service; the implementation source is not open source.
