Memory for AI agents with the right context.

# Adds Alvia's memory tools and tells the agent to ask Alvia
# for team decisions before it searches or guesses.
# Finished conversations are saved to Alvia automatically.
# In Claude Code, /plugin runs the same steps and asks for the key.

claude plugin marketplace add alvia-ai/integrations
# Replace <API_KEY> with a key from the Alvia dashboard.
claude plugin install alvia-memory@alvia-integrations \
  --config api_key="<API_KEY>"

# Available across all Claude Code projects.
# API key is stored locally, never in source control.
# Replace <API_KEY> with a key from the Alvia dashboard.

claude mcp add \
  --scope user \
  --transport http \
  alvia https://api.alvia.ai/mcp \
  --header "Authorization: Bearer <API_KEY>"

# Run from your project's root directory.
# Each project can use its own Alvia API key.
# Configuration stays local and is never committed.
# Replace <API_KEY> with a key from the Alvia dashboard.

claude mcp add \
  --scope local \
  --transport http \
  alvia https://api.alvia.ai/mcp \
  --header "Authorization: Bearer <API_KEY>"

# Adds Alvia's memory tools and tells the agent to ask Alvia
# for team decisions before it searches or guesses.
# Finished conversations are saved to Alvia automatically.
# Set the key where Codex starts, such as your shell profile.
# Replace <API_KEY> with a key from the Alvia dashboard.
export ALVIA_API_KEY="<API_KEY>"

codex plugin marketplace add alvia-ai/integrations
codex plugin add alvia-memory@alvia

# Then start Codex, run /hooks and trust the five alvia-memory hooks.

[mcp_servers.alvia]
url = "https://api.alvia.ai/mcp"
# Replace <API_KEY> with a key from the Alvia dashboard.
http_headers = { "Authorization" = "Bearer <API_KEY>" }

# Adds Alvia's memory tools and tells the agent to ask Alvia
# for team decisions before it searches or guesses.
# Finished conversations are saved to Alvia automatically
# (local agents only).
agent plugin marketplace add https://github.com/alvia-ai/integrations

# Then open Plugins › Alvia Memory › Configure and enter the key.
# The hooks read the same key from a file only you can read.
# Replace <API_KEY> with a key from the Alvia dashboard.
mkdir -p ~/.alvia && (umask 077 && printf '%s' "<API_KEY>" > ~/.alvia/api-key)

{
  "mcpServers": {
    "alvia": {
      "url": "https://api.alvia.ai/mcp",
      "headers": { "Authorization": "Bearer <API_KEY>" }
    }
  }
}

# Adds Alvia's memory tools and tells the agent to ask Alvia
# for team decisions before it searches or guesses.
# Finished conversations are saved to Alvia automatically.
git clone https://github.com/alvia-ai/integrations
mkdir -p "${HERMES_HOME:-$HOME/.hermes}/plugins"
cp -R integrations/plugins/hermes/alvia \
  "${HERMES_HOME:-$HOME/.hermes}/plugins/alvia"

# Choose alvia, then enter a key from the Alvia dashboard.
hermes memory setup

# Adds Alvia's memory tools and tells the agent to ask Alvia
# for team decisions before it searches or guesses.
# Finished conversations are saved to Alvia automatically.
# The gateway reads the key from its env file.
# Replace <API_KEY> with a key from the Alvia dashboard.
echo 'ALVIA_API_KEY=<API_KEY>' >> ~/.openclaw/.env

git clone https://github.com/alvia-ai/integrations
openclaw plugins install ./integrations/plugins/openclaw

# Then restart the gateway.

{
  plugins: {
    entries: {
      "alvia-memory": {
        enabled: true,
        // Lets the plugin read the conversation it captures.
        hooks: { allowConversationAccess: true },
        config: { autoCapture: true },
      },
    },
  },
  // alsoAllow adds the two tools that change memory;
  // allow would hide every other tool.
  tools: { alsoAllow: ["alvia_remember", "alvia_forget_memory"] },
}

# Alvia's remote MCP server, over streamable HTTP
https://api.alvia.ai/mcp

# Authenticate every request with your API key.
# Replace <API_KEY> with a key from the Alvia dashboard.
Authorization: Bearer <API_KEY>

# Replace <API_KEY> with a key from the Alvia dashboard.
curl -X POST https://api.alvia.ai/v1/memories \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"content": "Atlas finished its move to PostgreSQL 17.", "occurred_at": "2026-09-23T14:00:00Z"}'

# Replace <API_KEY> with a key from the Alvia dashboard.
curl -X POST https://api.alvia.ai/v1/memories/import \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {"role": "user", "content": "Atlas finished its move to PostgreSQL 17 today."},
      {"role": "assistant", "content": "Noted: Atlas now runs on PostgreSQL 17."}
    ],
    "occurred_at": "2026-09-23T14:00:00Z"
  }'

# Replace <API_KEY> with a key from the Alvia dashboard.
curl -X POST https://api.alvia.ai/v1/memories/context \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"query": "What database does Atlas use?"}'

# {"context": "Atlas moved to PostgreSQL 17 on September 23, 2026."}

import requests

response = requests.post(
    "https://api.alvia.ai/v1/memories",
    # Replace <API_KEY> with a key from the Alvia dashboard.
    headers={"Authorization": "Bearer <API_KEY>"},
    json={"content": "Atlas finished its move to PostgreSQL 17.", "occurred_at": "2026-09-23T14:00:00Z"},
)

import requests

response = requests.post(
    "https://api.alvia.ai/v1/memories/import",
    # Replace <API_KEY> with a key from the Alvia dashboard.
    headers={"Authorization": "Bearer <API_KEY>"},
    json={
        "messages": [
            {"role": "user", "content": "Atlas finished its move to PostgreSQL 17 today."},
            {"role": "assistant", "content": "Noted: Atlas now runs on PostgreSQL 17."},
        ],
        "occurred_at": "2026-09-23T14:00:00Z",
    },
)

import requests

response = requests.post(
    "https://api.alvia.ai/v1/memories/context",
    # Replace <API_KEY> with a key from the Alvia dashboard.
    headers={"Authorization": "Bearer <API_KEY>"},
    json={"query": "What database does Atlas use?"},
)
print(response.json()["context"])
# Atlas moved to PostgreSQL 17 on September 23, 2026.

const response = await fetch("https://api.alvia.ai/v1/memories", {
  method: "POST",
  headers: {
    // Replace <API_KEY> with a key from the Alvia dashboard.
    Authorization: "Bearer <API_KEY>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ content: "Atlas finished its move to PostgreSQL 17.", occurred_at: "2026-09-23T14:00:00Z" }),
});

const response = await fetch("https://api.alvia.ai/v1/memories/import", {
  method: "POST",
  headers: {
    // Replace <API_KEY> with a key from the Alvia dashboard.
    Authorization: "Bearer <API_KEY>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    messages: [
      { role: "user", content: "Atlas finished its move to PostgreSQL 17 today." },
      { role: "assistant", content: "Noted: Atlas now runs on PostgreSQL 17." },
    ],
    occurred_at: "2026-09-23T14:00:00Z",
  }),
});

const response = await fetch("https://api.alvia.ai/v1/memories/context", {
  method: "POST",
  headers: {
    // Replace <API_KEY> with a key from the Alvia dashboard.
    Authorization: "Bearer <API_KEY>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ query: "What database does Atlas use?" }),
});
const { context } = await response.json();
// "Atlas moved to PostgreSQL 17 on September 23, 2026."

using System.Net.Http.Json;

var http = new HttpClient();
// Replace <API_KEY> with a key from the Alvia dashboard.
http.DefaultRequestHeaders.Add("Authorization", "Bearer <API_KEY>");

var response = await http.PostAsJsonAsync(
    "https://api.alvia.ai/v1/memories",
    new { content = "Atlas finished its move to PostgreSQL 17.", occurred_at = "2026-09-23T14:00:00Z" });

using System.Net.Http.Json;

var http = new HttpClient();
// Replace <API_KEY> with a key from the Alvia dashboard.
http.DefaultRequestHeaders.Add("Authorization", "Bearer <API_KEY>");

var response = await http.PostAsJsonAsync(
    "https://api.alvia.ai/v1/memories/import",
    new {
        messages = new[] {
            new { role = "user", content = "Atlas finished its move to PostgreSQL 17 today." },
            new { role = "assistant", content = "Noted: Atlas now runs on PostgreSQL 17." },
        },
        occurred_at = "2026-09-23T14:00:00Z",
    });

using System.Net.Http.Json;
using System.Text.Json;

var http = new HttpClient();
// Replace <API_KEY> with a key from the Alvia dashboard.
http.DefaultRequestHeaders.Add("Authorization", "Bearer <API_KEY>");

var response = await http.PostAsJsonAsync(
    "https://api.alvia.ai/v1/memories/context",
    new { query = "What database does Atlas use?" });
var body = await response.Content.ReadFromJsonAsync<JsonElement>();
Console.WriteLine(body.GetProperty("context"));
// Atlas moved to PostgreSQL 17 on September 23, 2026.

package main

import (
	"bytes"
	"encoding/json"
	"net/http"
)

func main() {
	body, _ := json.Marshal(map[string]any{"content": "Atlas finished its move to PostgreSQL 17.", "occurred_at": "2026-09-23T14:00:00Z"})
	req, _ := http.NewRequest("POST", "https://api.alvia.ai/v1/memories", bytes.NewReader(body))
	// Replace <API_KEY> with a key from the Alvia dashboard.
	req.Header.Set("Authorization", "Bearer <API_KEY>")
	req.Header.Set("Content-Type", "application/json")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

package main

import (
	"bytes"
	"encoding/json"
	"net/http"
)

func main() {
	body, _ := json.Marshal(map[string]any{
		"messages": []any{
			map[string]any{"role": "user", "content": "Atlas finished its move to PostgreSQL 17 today."},
			map[string]any{"role": "assistant", "content": "Noted: Atlas now runs on PostgreSQL 17."},
		},
		"occurred_at": "2026-09-23T14:00:00Z",
	})
	req, _ := http.NewRequest("POST", "https://api.alvia.ai/v1/memories/import", bytes.NewReader(body))
	// Replace <API_KEY> with a key from the Alvia dashboard.
	req.Header.Set("Authorization", "Bearer <API_KEY>")
	req.Header.Set("Content-Type", "application/json")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	body, _ := json.Marshal(map[string]any{"query": "What database does Atlas use?"})
	req, _ := http.NewRequest("POST", "https://api.alvia.ai/v1/memories/context", bytes.NewReader(body))
	// Replace <API_KEY> with a key from the Alvia dashboard.
	req.Header.Set("Authorization", "Bearer <API_KEY>")
	req.Header.Set("Content-Type", "application/json")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var out struct {
		Context string `json:"context"`
	}
	json.NewDecoder(resp.Body).Decode(&out)
	fmt.Println(out.Context)
	// Atlas moved to PostgreSQL 17 on September 23, 2026.
}