English Français العربية

Intentions MCP Server

السجل الرسمي الذكاء الاصطناعي والوكلاء

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

الشيفرة المصدرية الموقع التوثيق

ماذا يمكنك أن تفعل مع 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

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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>'
إعداد 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>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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.

الأسئلة الشائعة

ما هو Intentions MCP Server؟

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

كيف أثبّت Intentions MCP Server؟

يعمل كخادم بعيد. في 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 من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Intentions MCP Server إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل Intentions MCP Server مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون Intentions MCP Server؟

ينشره intentions-me. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.