Rival Regulatory Toolkit

Rival 規制対応ツールキット

AI エージェントを、Rival の出典に基づく規制情報取得 API に接続するためのオープンソース SDK、CLI、MCP サーバー、スキーマです。

• 公開サイト：https://tryrival.ai
• エージェント向けアクセス：https://tryrival.ai/for-agents
• 管理対象 API のデフォルト：https://api.tryrival.ai

このリポジトリは、Rival の開発者およびエージェント向け接続レイヤーです。初回リリースでは意図的に読み取り専用としており、エージェントは検索、出典テキストの取得、引用の追跡、規制当局の一覧表示、最近の申請の確認を行えます。ワークスペースの操作、文書レビュー、証拠の請求、申請、タスクの作成は、管理対象の Rival アクセスと人間によるレビューのゲートを通じてのみ利用できます。

含まれるもの

• Rival の読み取り専用規制情報取得 API の OpenAPI コントラクト。
• 出典文書、検索結果、引用、規制当局、最近の申請の JSON スキーマ。
• サーバーサイドアプリケーションおよび内部ツール向けの TypeScript クライアント。
• シェルでの使用と自動化向けの CLI。
• Model Context Protocol に対応したエージェントクライアント向けの MCP サーバー。
• Rival API キーなしでチームが連携機能を評価できるフィクスチャモード。
• 管理されたチーム環境で MCP サーバーを実行するための Dockerfile。

インストール

npm install @rival-intelligence/regulatory-toolkit

ソースからローカル開発する場合：

npm install
npm run build

環境

export RIVAL_API_KEY="rv_live_..."
export RIVAL_API_BASE_URL="https://api.tryrival.ai"

API にアクセスせずローカルで評価する場合：

export RIVAL_FIXTURE_MODE=true

TypeScript クライアント

import { RivalRegulatoryClient } from '@rival-intelligence/regulatory-toolkit';

const rival = new RivalRegulatoryClient({
  apiKey: process.env.RIVAL_API_KEY,
});

const results = await rival.searchRegulatoryCorpus({
  query: '49 CFR 195.573',
  limit: 5,
});

console.log(results.results[0]?.source.citation);

CLI

rival-regulatory search "49 CFR 195.573"
rival-regulatory source "cfr-49-195-573"
rival-regulatory trace "49 CFR 195.573"
rival-regulatory authorities

フィクスチャモード：

rival-regulatory search "pipeline corrosion" --fixture

MCP サーバー

直接実行する場合：

npx @rival-intelligence/regulatory-toolkit mcp

MCP クライアントの例：

{
  "mcpServers": {
    "rival-regulatory": {
      "command": "npx",
  "args": ["-y", "@rival-intelligence/regulatory-toolkit", "mcp"],
      "env": {
        "RIVAL_API_KEY": "rv_live_...",
        "RIVAL_API_BASE_URL": "https://api.tryrival.ai"
      }
    }
  }
}

利用可能な MCP ツール：

• search_regulatory_corpus
• retrieve_source_text
• trace_citation
• list_authorities
• get_recent_filings

Docker

多くのコンプライアンス、法律、コンサルティング、エネルギー、インフラのチームが、管理された環境内でエージェントツールを実行するため、Docker はこのリポジトリに含まれています。このイメージは MCP サーバーを実行し、環境変数から認証情報を読み込みます。

docker build -t rival-regulatory-toolkit .
docker run --rm -i \
  -e RIVAL_API_KEY="$RIVAL_API_KEY" \
  -e RIVAL_API_BASE_URL="https://api.tryrival.ai" \
  rival-regulatory-toolkit

フィクスチャモード：

docker run --rm -i -e RIVAL_FIXTURE_MODE=true rival-regulatory-toolkit

デプロイに関する注意事項は、docs/self-hosting.md をご覧ください。

API コントラクト

API コントラクトには、次の 5 つの読み取り専用エンドポイントが含まれます。

• GET /api/v1/search
• GET /api/v1/sources/{source_id}
• GET /api/v1/citations/trace
• GET /api/v1/authorities
• GET /api/v1/filings/recent

コントラクトは openapi/rival-regulatory-api.yaml にあります。

安全性の境界

このツールキットは、申請の提出、コンプライアンス記録の変更、是正措置の完了、証拠の削除、ワークスペースの操作を行いません。エージェントおよび開発者向けシステムのための、出典取得および引用レイヤーです。規制対象の業務には、引き続き有資格者によるレビューが必要です。

このツールキットは、法律、エンジニアリング、環境、安全、コンプライアンスに関する助言を提供するものではありません。適用可能性、義務、申請、運用上の判断を有資格の専門家とともに検証する責任は、各チームにあります。

開発

npm install
npm run build
npm test

ライセンス

Apache-2.0