Point-in-Time Reasoning for AI^™

# 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>"

[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>" }

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

# 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.
}