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://www.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

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

Installation

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

1. Create an account at https://www.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://www.intentions.me/account. Treat the key like a password — it carries your quota and your stored energy profile.

Pricing

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

Links

• Homepage: https://www.intentions.me
• Pricing: https://www.intentions.me/pricing

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