NestDaddy

Intentions MCP Server

io.github.intentions-me/intentions-mcp · v0.1.2

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

Connect Remote server

Terminal
claude mcp add --transport http intentions-mcp https://mcp.intentions.me/mcp --header "Authorization: Bearer <YOUR_API_KEY>"
~/.cursor/mcp.json
{
  "mcpServers": {
    "intentions-mcp": {
      "url": "https://mcp.intentions.me/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "intentions-mcp": {
      "type": "http",
      "url": "https://mcp.intentions.me/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}
Claude Desktop
Settings > Connectors > Add custom connector
URL: https://mcp.intentions.me/mcp

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools 7 found in our last check

  • intentions_ask_day

    Call when the user asks about timing a decision for a specific date, or wants to pick the best day from a multi-day window. Covers trip dates, launch days, interview/meeting days, publish/send dates, travel, negotiation windows, relationship moments — any "when to X" question wh…

  • intentions_ask_hour

    Call when the user asks about timing within a specific day — best hour to act, morning vs afternoon, when during the day ("best time today to X", "morning or afternoon for Y", "几点去见面好"). Use for interview slots, meeting times, send/publish times, departure times, workout windows…

  • intentions_ask_year

    Call when the user asks about a full calendar year as a whole ("how is 2026", "今年怎么样", "what's next year like overall"). Returns year-level score, verdict, adverse alerts, and element dimensions. For month precision use `intentions_ask_month`; for day use `intentions_ask_day`. W…

  • intentions_ask_month

    Call when the user asks at month granularity or wants the best month from a multi-month window ("how is next month", "best month in 2026 to X", "下个月适合吗"). Use for trip-month selection, launch months, content-calendar planning, quarterly/annual decisions. Modes: single month, com…

  • intentions_energy_chart

    Call when the user wants a visual overview rather than a narrative answer ("show me this week", "chart for today", "next 12 months", "看一下图"). Returns an ASCII chart: `hourly` = 12 two-hour blocks of one day, `weekly` = 7 days, `yearly` = 12 months. The `hourly` mode emits the sa…

  • intentions_set_birth_info

    Call once to register the user's birth date/time/gender. Each call is a complete replacement — all 6 fields must be supplied. For fields the user does not know or prefers not to share, pass `null` explicitly (e.g. `hour: null` for unknown birth time, `gender: null` for unspecifi…

  • intentions_get_profile

    Fetch the user's currently stored birth info. Use this before `intentions_set_birth_info` when updating an existing profile so you can send back a complete merged payload. Returns { hasProfile, birthInfo: { year, month, day, hour, minute, gender } | null, profileChanges: { remai…

Headers

NameDescription
Authorization
Required, secret
Bearer API key (format: itm_...). Generate one at https://intentions.me/account

Details

Endpointhttps://mcp.intentions.me/mcp (Streamable HTTP)
First published18 Oct 2026
Last updated18 Oct 2026
Registry nameio.github.intentions-me/intentions-mcp

More ai and media servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.