timepoint-mcp

Name: Timepoint MCP
Author: timepointai

MCP-сервер для платформы темпоральных знаний Timepoint AI.

Работает по адресу: mcp.timepointai.com

Что это такое?

Размещенный сервер Model Context Protocol, который предоставляет AI-агентам структурированный доступ к экосистеме Timepoint:

Поиск и просмотр причинно-следственного графа из более чем 3900 исторических моментов и 5 млн+ связей, охватывающих период с 700 г. до н.э. по 2026 г.
Генерация временных точек — насыщенные исторические сцены с повествованием, персонажами, диалогами и AI-изображениями (Фаза 2 — в разработке)
Навигация во времени — перемещение вперед/назад от любого момента, чтобы узнать, что было до и после (Фаза 2 — в разработке)
Общение с историческими персонажами — контекстные беседы с личностями, соответствующими эпохе (Фаза 2 — в разработке)
Запуск симуляций — темпоральные сценарии с участием множества сущностей через движок SNAG (Фаза 3 — запланировано)

Работает с Claude Desktop, Cursor, Windsurf, VS Code Copilot, Anthropic Agent SDK и любым MCP-совместимым клиентом.

Получение API-ключа

Посетите timepointai.com или свяжитесь с нами в X @timepointai, чтобы запросить доступ.

Инструменты чтения Clockchain (поиск, просмотр, детали момента) работают без аутентификации с ограничением 30 запросов в минуту. Инструменты генерации и симуляции требуют API-ключ и кредиты.

Быстрый старт

Claude Desktop

Добавьте в ваш claude_desktop_config.json:

{
  "mcpServers": {
    "timepoint": {
      "url": "https://mcp.timepointai.com/mcp",
      "headers": {
        "X-API-Key": "tp_mcp_..."
      }
    }
  }
}

Cursor / Windsurf

Добавьте в .cursor/mcp.json или эквивалентный файл:

{
  "mcpServers": {
    "timepoint": {
      "url": "https://mcp.timepointai.com/mcp",
      "headers": {
        "X-API-Key": "tp_mcp_..."
      }
    }
  }
}

Anthropic Agent SDK

from claude_agent_sdk import Agent
from claude_agent_sdk.mcp import MCPServerRemote

agent = Agent(
    model="claude-sonnet-4-6",
    mcp_servers=[
        MCPServerRemote(
            url="https://mcp.timepointai.com/mcp",
            headers={"X-API-Key": "tp_mcp_..."},
        )
    ],
)
result = agent.run("What happened in Rome in 44 BC?")

Локальная разработка

git clone https://github.com/timepointai/timepoint-mcp.git
cd timepoint-mcp
pip install -e .

# stdio transport (for Claude Desktop local)
python -m app.server --transport stdio

# HTTP transport (for remote testing)
python -m app.server --transport http --port 8000

Доступные инструменты

Фаза 1 (уже работает) — Инструменты чтения Clockchain

Инструмент	Авторизация	Описание
`search_moments`	Опционально	Поиск исторических событий в темпоральном причинно-следственном графе
`get_moment`	Опционально	Получение полной информации об историческом моменте по его каноническому пути
`browse_graph`	Опционально	Просмотр иерархии графа — год, месяц, день, местоположение, событие
`get_connections`	Опционально	Получение причинно-следственных/тематических связей: что вызвало это, что оно вызвало
`today_in_history`	Ключ	События, произошедшие в текущую дату во всех эпохах
`random_moment`	Ключ	Случайный исторический момент для неожиданных открытий
`graph_stats`	Опционально	Количество узлов/связей, диапазон дат, распределение источников

Фаза 2 (скоро) — Инструменты генерации

Инструмент	Кредиты	Описание
`generate_timepoint`	5-10	Генерация исторической временной точки со сценой, персонажами, диалогом, изображением
`temporal_navigate`	2	Перемещение вперед/назад во времени от существующей временной точки
`chat_with_character`	1	Общение с историческим персонажем в контексте
`get_timepoint`	0	Получение ранее сгенерированной временной точки
`list_my_timepoints`	0	Список ваших сгенерированных временных точек
`get_credit_balance`	0	Проверка кредитов и использования

Фаза 3 (запланировано) — Инструменты симуляции

Инструмент	Кредиты	Описание
`run_simulation`	10	Запуск темпоральной симуляции SNAG
`get_simulation_result`	0	Получение результатов симуляции

Тарифы

Уровень	Цена	Ежемесячные кредиты	Лимит запросов
Анонимный	Бесплатно	—	30 зап./мин (только чтение)
Бесплатный	Бесплатно	5 кредитов при регистрации	60 зап./мин
Исследователь	$7.99/мес	100	60 зап./мин
Создатель	$19.99/мес	300	300 зап./мин
Студия	$49.99/мес	1000	1000 зап./мин

Пакеты кредитов также доступны для разовой покупки.

HTTP-эндпоинты

В дополнение к протоколу MCP по адресу /mcp, сервер предоставляет:

Метод	Путь	Описание
GET	`/`	Лендинг (JSON для агентов, редирект для браузеров)
GET	`/health`	Проверка работоспособности сервиса
GET	`/account/status`	Статус авторизации и информация об уровне
POST	`/admin/create-key`	Создание API-ключа (требуется ключ администратора)

Архитектура

MCP Clients (Claude Desktop, Cursor, agents, SDKs)
        |
        | Streamable HTTP + X-API-Key
        v
   timepoint-mcp (mcp.timepointai.com)
   FastMCP + Starlette + asyncpg
        |
   -----+------+----------+
   |           |           |
   v           v           v
 Clockchain  Flash      Billing
 (graph)    (writer)   (Stripe/IAP)

MCP-сервер — это тонкий координационный слой. Он аутентифицирует запросы через API-ключи, определяет уровни пользователей через биллинг, проверяет баланс кредитов через шлюз, направляет вызовы инструментов в соответствующий бэкенд и обеспечивает соблюдение лимитов запросов для каждого уровня. Он никогда не хранит кредиты или подписки — за это отвечают шлюз и биллинг.

Технологический стек

Python 3.11+ с FastMCP, Starlette, httpx, asyncpg
Транспорт: Streamable HTTP (продакшн), stdio (локальная разработка)
База данных: PostgreSQL (API-ключи + логи использования)
Развертывание: Railway (Docker)

Переменные окружения

# Downstream services
FLASH_URL=https://api.timepointai.com
FLASH_OUTBOUND_KEY=...  # key sent to Flash as X-Service-Key (was FLASH_SERVICE_KEY)
FLASH_ADMIN_KEY=...
CLOCKCHAIN_URL=...
CLOCKCHAIN_SERVICE_KEY=...
BILLING_URL=...
BILLING_SERVICE_KEY=...

# Database
DATABASE_URL=postgresql://...

# Server
PORT=8000

Пакет Timepoint

Визуализируйте прошлое. Симулируйте будущее. Оценивайте предсказания. Накапливайте граф.

Сервис	Тип	Репозиторий	Роль
API Gateway	Приватный	timepoint-api-gateway	Центр авторизации — JWT, OAuth (Apple/Google/GitHub), кредиты, лимиты запросов на api.timepointai.com
Flash	Open Source	timepoint-flash	Писатель реальности — чистый движок генерации (без авторизации), визуализирует обоснованные исторические моменты
Clockchain	Open Source	timepoint-clockchain	Темпоральный причинно-следственный граф — 3900+ узлов, 5 млн+ связей, MCP-эндпоинт, растет 24/7
Pro	Open Source	timepoint-pro	Движок симуляции SNAG — темпоральная симуляция, вывод TDF, обучающие данные
Proteus	Open Source	proteus	Уровень расчетов — рынки предсказаний для визуализированных будущих событий
TDF	Open Source	timepoint-tdf	Формат данных — обмен JSON-LD между всеми сервисами
SNAG Bench	Open Source	timepoint-snag-bench	Сертификатор качества — измеряет причинно-следственное разрешение визуализаций
Billing	Приватный	timepoint-billing	Обработка платежей — Apple IAP + Stripe
MCP	Публичный	timepoint-mcp	MCP-сервер — доступ AI-агентов к Flash и Clockchain
Web App	Приватный	timepoint-web-app	Браузерный клиент на app.timepointai.com
Landing	Приватный	timepoint-landing	Маркетинговый сайт на timepointai.com
iPhone App	Приватный	timepoint-iphone-app	iOS-клиент — синтетические путешествия во времени на мобильных устройствах
Skip Meetings	Приватный	skipmeetingsai	SaaS для анализа встреч на базе Flash

Лицензия

Проприетарная. Авторское право 2026 Timepoint AI.

Timepoint MCP