Intentions MCP Server

by @intentions-me · io.github.intentions-me/intentions-mcp

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

OnlineRemote
Category
Cloud and DevOps
Connection
Remote (HTTP)
Tools
7 reported
Status
Online

Connect it to your AI

Claude Code

claude mcp add --transport http intentions-mcp https://mcp.intentions.me/mcp

Claude, ChatGPT, Cursor and other apps

Add it as a custom connector with this URL (Streamable HTTP):

https://mcp.intentions.me/mcp

This server expects extra headers, usually an API key from its maker.

Cursor, VS Code and other apps (mcp.json)

{
  "mcpServers": {
    "intentions-mcp": {
      "url": "https://mcp.intentions.me/mcp"
    }
  }
}

Tools it offers

7 tools, as the server itself reported during our check on Oct 31, 2026.

  • intentions_ask_dayCall 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
  • intentions_ask_hourCall 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
  • intentions_ask_yearCall 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_monthCall 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 pla
  • intentions_energy_chartCall 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
  • intentions_set_birth_infoCall 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:
  • intentions_get_profileFetch 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,

Questions

What is the Intentions MCP server?

Personalized timing intelligence for AI agents — ask 'should I do X on this date?'. It is made by @intentions-me and listed in the official MCP Registry as io.github.intentions-me/intentions-mcp. MCP (Model Context Protocol) is the open standard that lets AI apps like Claude, ChatGPT and Cursor use outside tools.

How do I add Intentions to Claude?

In the Claude app or claude.ai, open Settings, then Connectors, choose "Add custom connector" and paste https://mcp.intentions.me/mcp. In Claude Code, run: claude mcp add --transport http intentions-mcp https://mcp.intentions.me/mcp

How do I add Intentions to ChatGPT?

ChatGPT can use remote MCP servers as connectors. In ChatGPT settings, under Apps and Connectors, turn on developer mode if asked, create a new connector and paste https://mcp.intentions.me/mcp.

How do I add Intentions to Cursor?

Open Cursor settings, go to MCP, choose "Add new MCP server" (or edit ~/.cursor/mcp.json) and add: { "mcpServers": { "intentions-mcp": { "url": "https://mcp.intentions.me/mcp" } } }

Does Intentions work right now?

Yes. It responded when we last checked on 31 Oct 2026. We check remote MCP servers every day.

What can Intentions do?

It gives your AI 7 tools, including intentions_ask_day, intentions_ask_hour, intentions_ask_year, intentions_ask_month, intentions_energy_chart. The full list is on this page.

Is this your server? Get the badge for your README
chen.media/mcp badge

Markdown (GitHub README)

[![Listed on chen.media/mcp](https://chen.media/mcp/badge/github-intentions-me-intentions-mcp.svg)](https://chen.media/mcp/github-intentions-me-intentions-mcp)

HTML (switches to dark mode on its own)

<a href="https://chen.media/mcp/github-intentions-me-intentions-mcp"><picture><source media="(prefers-color-scheme: dark)" srcset="https://chen.media/mcp/badge/github-intentions-me-intentions-mcp.svg?theme=dark"><img src="https://chen.media/mcp/badge/github-intentions-me-intentions-mcp.svg" alt="Listed on chen.media/mcp" height="40"></picture></a>

More in Cloud and DevOps

See all