timepoint-mcp

Name: Timepoint MCP
Author: timepointai

Timepoint AI 時間的知識プラットフォーム用のMCPサーバー。

ライブURL: mcp.timepointai.com

これは何ですか？

AIエージェントがTimepointエコシステムに構造化されたアクセスを行うための、ホスト型 Model Context Protocol サーバーです：

検索と閲覧：紀元前700年から2026年までの3,900以上の歴史的瞬間と500万以上のエッジを持つ因果グラフ
タイムポイントの生成 — 物語、キャラクター、対話、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リクエスト/分
Explorer	$7.99/月	100	60リクエスト/分
Creator	$19.99/月	300	300リクエスト/分
Studio	$49.99/月	1,000	1,000リクエスト/分

クレジットパックの買い切り購入も可能です。

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キーによるリクエスト認証、Billingによるユーザープランの解決、Gatewayによるクレジット残高の確認、適切なバックエンドへのツール呼び出しのルーティング、およびプランごとのレート制限の適用を行います。クレジットやサブスクリプションの保存は行いません（GatewayとBillingが管理します）。

技術スタック

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	オープンソース	timepoint-flash	Reality Writer — 純粋な生成エンジン (認証なし), 根拠のある歴史的瞬間をレンダリング
Clockchain	オープンソース	timepoint-clockchain	時間的因果グラフ — 3,900以上のノード, 500万以上のエッジ, MCPエンドポイント, 24時間365日成長中
Pro	オープンソース	timepoint-pro	SNAGシミュレーションエンジン — 時間シミュレーション, TDF出力, 学習データ
Proteus	オープンソース	proteus	決済レイヤー — レンダリングされた未来のための予測市場
TDF	オープンソース	timepoint-tdf	データ形式 — 全サービス間でのJSON-LD交換
SNAG Bench	オープンソース	timepoint-snag-bench	品質認証 — レンダリング全体での因果解像度を測定
Billing	非公開	timepoint-billing	決済処理 — Apple IAP + Stripe
MCP	公開	timepoint-mcp	MCPサーバー — FlashおよびClockchainへのAIエージェントアクセス
Web App	非公開	timepoint-web-app	app.timepointai.comでのブラウザクライアント
Landing	非公開	timepoint-landing	timepointai.comでのマーケティングサイト
iPhone App	非公開	timepoint-iphone-app	iOSクライアント — モバイルでの合成タイムトラベル
Skip Meetings	非公開	skipmeetingsai	Flashを活用した会議インテリジェンスSaaS

Timepoint MCP