{
  "markdown": "<p align=\"center\">\n  <img src=\"./logo.png\" width=\"120\" height=\"120\" alt=\"Intentions\" />\n</p>\n\n<h1 align=\"center\">Intentions MCP Server</h1>\n\nPersonalized timing intelligence for AI agents. Ask *\"Should I do X on this date?\"* and\nget a 0–100 alignment score, a clear verdict, and the reasoning behind it — grounded in the\nuser's personal energy profile and the Five Elements framework.\n\nBuilt for agentic workflows: trip planning, product launches, content calendars,\ninterview/meeting scheduling, negotiation prep, and relationship/family timing.\n\n- **Homepage:** https://www.intentions.me\n- **MCP endpoint:** `https://mcp.intentions.me/mcp` (Streamable HTTP)\n\n---\n\n## What it does\n\nYou give it a decision and a time window; it returns a structured reading your agent can\nreason over and explain in plain language:\n\n- **Score** (0–100) and a **verdict** (e.g. *favorable*, *proceed with caution*, *wait*)\n- **Friction** (0–100) — an independent measure of execution resistance\n- **Element breakdown** and per-layer (year / month / day / hour) signals\n- **Adverse alerts** with actionable, behavioral guidance — never event predictions\n\nChain the tools to narrow from \"which year\" → \"which month\" → \"which day\" → \"which hour\".\n\n---\n\n## Tools\n\n| Tool | What it answers | Tier |\n|------|-----------------|------|\n| `intentions_ask_year` | A full calendar year as a whole | Free |\n| `intentions_ask_month` | A specific month, or the best month in a window (≤12 months) | Free |\n| `intentions_ask_day` | A specific date, comparison, or best day in a range (≤31 days) | Free |\n| `intentions_ask_hour` | Best hour within a day; morning vs afternoon | **Pro** |\n| `intentions_energy_chart` | ASCII chart overview — `weekly` / `yearly` (free), `hourly` (**Pro**) | Mixed |\n| `intentions_set_birth_info` | Register or update the user's birth date / time / gender | Free |\n| `intentions_get_profile` | Read the currently stored birth info | Free |\n\nAll timing inputs must fall within `currentYear − 1 … currentYear + 1`.\n\n---\n\n## Installation\n\nThe server is **remote** (Streamable HTTP) — nothing to install or self-host.\n\n1. Create an account at https://www.intentions.me\n2. Generate an API key from your account page (format: `itm_…`)\n3. Add the server to your MCP client using the config below\n\n### Claude Desktop / MCP client config\n\n```json\n{\n  \"mcpServers\": {\n    \"intentions\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.intentions.me/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer itm_your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n### claude.ai custom connector\n\nAdd a custom connector with:\n\n- **URL:** `https://mcp.intentions.me/mcp`\n- **Authentication:** Bearer token — paste your `itm_…` key\n\n---\n\n## Authentication\n\nEvery request authenticates with a Bearer API key in the `Authorization` header:\n\n```\nAuthorization: Bearer itm_0123456789abcdef0123456789abcdef\n```\n\nKeys are issued per account at https://www.intentions.me/account. Treat the key like a\npassword — it carries your quota and your stored energy profile.\n\n---\n\n## Pricing\n\n| | Free | Pro |\n|---|------|-----|\n| Day / month / year readings | 5 per day (resets midnight UTC) | Unlimited |\n| Hour-by-hour precision (`ask_hour`, hourly charts) | — | ✓ |\n| Weekly / yearly charts | ✓ | ✓ |\n\nThe free tier is enough to evaluate the server end-to-end. See\nhttps://www.intentions.me/pricing for current Pro pricing.\n\n---\n\n## Links\n\n- **Homepage:** https://www.intentions.me\n- **Pricing:** https://www.intentions.me/pricing\n\n---\n\n*This repository contains documentation only. The Intentions MCP Server is a hosted,\nproprietary service; the implementation source is not open source.*\n",
  "bytes": 3654,
  "sha": "1633ffa6f5b4e72e96ad0e5ce6f0496fe7fc97407b52bbde310a92cd13954098",
  "repo_slug": "intentions-me/intentions-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_intentions_me_intentions_mcp_a513e361/readme"
}