English Français العربية

Intentions MCP Server

Registre officiel IA et agents

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

Code source Site web Documentation

Que pouvez-vous faire avec 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

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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>'
Configuration JSON (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

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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.

Questions fréquentes

Qu'est-ce que Intentions MCP Server ?

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

Comment installer Intentions MCP Server ?

Il fonctionne comme serveur distant. Dans 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>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Intentions MCP Server ?

Oui. Il attend Authorization, à renseigner dans sa configuration.

Intentions MCP Server est-il open source ?

Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.

Qui maintient Intentions MCP Server ?

Il est publié par intentions-me. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.