fastino-personalization-mcp-server/README.md

MCP server for Fastino Personalization API - Connect Claude to user memory and context management

# Fastino Personalization MCP Server

Connect Claude directly to your Fastino Personalization API for seamless AI-powered user memory and context management.

## What This Does

This MCP (Model Context Protocol) server allows Claude (via the Claude Desktop app) to directly interact with your Fastino Personalization API. Once configured, you can ask Claude to:

- Register and manage user profiles
- Ingest user activity and documents
- Query user memory and preferences
- Retrieve contextual information about users

## Prerequisites

- Node.js 18 or higher
- A Fastino API key (get yours at [fastino.ai](https://fastino.ai))
- Claude Desktop app ([download here](https://claude.ai/download))

## Configuration

### Step 1: Add to Claude Desktop

1. Open your Claude Desktop app configuration file:
   - Go to **Settings** → **Developer** → **Edit Config**
   
   Or manually locate the file at:
   - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
   - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

2. Add the Fastino MCP server configuration:
```json
{
  "mcpServers": {
    "fastino-personalization-mcp-server": {
      "command": "npx",
      "args": [
        "fastino-personalization-mcp-server"
      ],
      "env": {
        "FASTINO_API_KEY": "pio_sk_your_api_key_here"
      }
    }
  }
}
```

3. Replace `pio_sk_your_api_key_here` with your actual Fastino API key (get yours at [fastino.ai](https://fastino.ai))

4. Restart Claude Desktop

### Step 2: Verify Installation

Open Claude Desktop and ask:

> "What Fastino Personalization tools do you have access to?"

Claude should list all available Fastino tools.

## Usage Examples

Once configured, you can use natural language with Claude:

### Register a User

> "Register a new user with email me@fastino.ai, name Ash Lewis, and timezone America/New_York. He is the founder of Fastino and likes concise responses"

### Ingest Data

> "Ingest an email event for user Ash Lewis: the CEO sent an email at 9am today saying 'Let's move our weekly sync to Tuesdays at 2pm'"

### Query User Memory

> "Query user Ash Lewis: Who does this user meet with most frequently?"

### Get User Summary

> "Get a work-style summary for user Ash Lewis"

### Retrieve Context Chunks

> "Retrieve relevant context chunks for user Ash Lewis about their meeting preferences"

## Available Tools

| Tool | Description |
|------|-------------|
| `register_user` | Create or update user profiles |
| `delete_user` | Remove all user data (GDPR compliant) |
| `ingest_data` | Feed user activity and documents |
| `query_user` | Ask questions about user memory |
| `get_summary` | Get deterministic user summaries |
| `retrieve_chunks` | Get relevant context snippets |

## Troubleshooting

### "FASTINO_API_KEY environment variable is required"

Make sure you've added your API key to the `claude_desktop_config.json` file and restarted Claude Desktop.

### Tools not appearing in Claude

1. Ensure the config file is in the correct location
2. Verify the JSON is properly formatted (no trailing commas)
3. Restart Claude Desktop completely (quit and reopen)

## Support

- **Fastino API Documentation**: [docs.fastino.ai](https://fastino.ai/api-reference/register-a-user)
- **MCP Protocol**: [modelcontextprotocol.io](https://modelcontextprotocol.io)

---

Built with ❤️ by Fastino