# Intentions MCP Server

> Intentions MCP Server is a freemium MCP server for astrology. Date-timing scores and verdicts from a personal Five Elements profile. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web
- **Website:** https://intentions.me
- **Repository:** https://github.com/intentions-me/intentions-mcp
- **MCP Registry name:** io.github.intentions-me/intentions-mcp
- **Categories:** astrology, productivity
- **Listing updated:** 2026-11-15

## About

This is a hosted service that answers one kind of question: should you do something on a given date? It uses a stored birth date, time and gender to build a personal energy profile under the Five Elements framework, then returns a 0 to 100 alignment score, a verdict such as favorable, proceed with caution or wait, and a separate 0 to 100 friction measure for how hard execution may be.

The tools work at four levels. Year, month, day and hour readings can be chained to narrow from a year down to an hour, and an ASCII energy chart gives weekly, yearly or hourly overviews. Adverse alerts come with behavioral guidance, and the README says they are never event predictions. Inputs must fall within three years either side of the current year.

The README states the free tier allows five day, month or year readings a day. Hourly readings, month scanning, yearly charts and ranges beyond the past and coming week need Pro. The service is proprietary and the repository holds documentation only.

## Features

- **Alignment score and verdict:** Returns a 0 to 100 score and a plain verdict for a chosen date.
- **Friction measure:** An independent 0 to 100 score for execution resistance.
- **Year to hour drill-down:** Separate tools for year, month, day and hour readings.
- **Energy charts:** ASCII weekly chart free; yearly and hourly charts on Pro.
- **Stored birth profile:** Set and read the birth details used for readings.

## Good for

- Pick a day for a product launch or meeting
- Compare candidate dates for a trip
- Plan a content calendar around best days
- Prepare for a negotiation by checking the timing

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.intentions.me/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "intentions-mcp": {
      "type": "http",
      "url": "https://mcp.intentions.me/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "intentions-mcp": {
      "serverUrl": "https://mcp.intentions.me/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "intentions-mcp": {
      "type": "http",
      "url": "https://mcp.intentions.me/mcp"
    }
  }
}
```

## Tools

- `intentions_ask_year`: Reading for a full calendar year.
- `intentions_ask_month`: Reading for a month, a comparison, or the best month in a window of up to 12 months.
- `intentions_ask_day`: Reading for a date, a comparison, or the best day in a range of up to 31 days.
- `intentions_ask_hour`: Best hour within a day, or morning versus afternoon (Pro).
- `intentions_energy_chart`: ASCII energy chart, weekly, yearly or hourly.
- `intentions_set_birth_info`: Register or update birth date, time and gender.
- `intentions_get_profile`: Read the stored birth info.

## FAQ

### Is it free?

The free tier allows five day, month or year readings per day, resetting at midnight UTC; Pro removes the limit.

### What needs Pro?

Hourly readings, scanning months, yearly charts, and day ranges beyond the past week and week ahead.

### How do I authenticate?

Create an account, generate an itm_ API key and send it as a Bearer token.

### Is it open source?

No. The repository contains documentation only and the service is proprietary.

### What date range is allowed?

Inputs must fall within three years before or after the current year.

### Is Intentions MCP Server free?

Intentions MCP Server has a free plan, with paid plans for more usage or features.

### How do I add Intentions MCP Server to Claude Code?

Run this command in your terminal: claude mcp add --transport http intentions-mcp https://mcp.intentions.me/mcp

### What are the best alternatives to Intentions MCP Server?

The closest alternatives to Intentions MCP Server are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/intentions-mcp-server
