English Français العربية

Intentions MCP Server

Official registry AI and agents

Personalized timing intelligence for AI agents — ask 'should I do X on this date?'

Source code Website Documentation

What can you do with Intentions MCP Server?

  • 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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http intentions-mcp-server 'https://mcp.intentions.me/mcp' --header 'Authorization: <Bearer API key (format: itm_...). Generate one at https://intentions.me/account>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "intentions-mcp-server": {
            "type": "http",
            "url": "https://mcp.intentions.me/mcp",
            "headers": {
                "Authorization": "<Bearer API key (format: itm_...). Generate one at https://intentions.me/account>"
            }
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Intentions MCP Server
  2. What it does
  3. Tools
  4. Installation
  5. Authentication
  6. Pricing
  7. Links

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.

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

ToolWhat it answersTier
intentions_ask_yearA full calendar year as a wholeFree
intentions_ask_monthA specific month, a comparison, or the best month in a window (≤12 months)Free; scanning a window is Pro
intentions_ask_dayA 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_hourBest hour within a day; morning vs afternoonPro
intentions_energy_chartASCII chart overview — weekly (free for the past and coming week), yearly / hourly (Pro)Mixed
intentions_set_birth_infoRegister or update the user's birth date / time / genderFree
intentions_get_profileRead the currently stored birth infoFree

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

FreePro
Day / month / year readings5 per day (resets midnight UTC)Unlimited
Scanning and charting daysThe past week and the week ahead3 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.

Frequently asked questions

What is Intentions MCP Server?

Personalized timing intelligence for AI agents — ask 'should I do X on this date?'

How do I install Intentions MCP Server?

It runs as a remote server. In Claude Code: claude mcp add --transport http intentions-mcp-server 'https://mcp.intentions.me/mcp' --header 'Authorization: <Bearer API key (format: itm_...). Generate one at https://intentions.me/account>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Intentions MCP Server need an API key?

Yes. It expects Authorization, which you set in its configuration.

Is Intentions MCP Server open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains Intentions MCP Server?

It is published by intentions-me. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.