mcp-legiti

@codespar/mcp-legiti

非推奨：稼働中のエンドポイントはありません。 2026-09-27に、2つの公開 DNS リゾルバー（8.8.8.8 と 1.1.1.1）を使って確認したところ、このサーバーが呼び出すホスト collection-prod.inspcdn.net は DNS で名前解決できませんでした。このサーバーのツールは、どれもサービスに接続できません。このパッケージは npm で非推奨となっており、参照用としてこのリポジトリに残されています。動作するエンドポイントをお持ちの場合は、LEGITI_BASE_URL を使ってサーバーの接続先を変更してください。パッケージを復活させるには、プロバイダーが公開しているベース URL を添えて、mcp-dev-latam にイシューを作成してください。

Legiti 用の MCP サーバーです。ブラジルの不正防止サービスで、チケット販売に特化し、シンプルな同期評価 API を備えています。

CodeSpar の fraud カテゴリーにおける 4 つ目の項目で、@codespar/mcp-clearsale、@codespar/mcp-konduto、@codespar/mcp-sift に続くものです。Legiti（旧称 Inspetor、サンパウロ）は中堅規模のブラジル市場に位置し、ClearSale より公開情報が少なく、チケット販売／イベント分野では Konduto より深い垂直性を持ち、Sift よりシンプルな API を提供します。

位置付け

	強み	典型的な適用先
ClearSale	ブラジルの先駆者（2001年）、豊富なチャージバック実績	ブラジル大手小売の標準選択肢
Konduto	ブラジル、API ファースト、行動・デバイス情報	デジタルネイティブなブラジルの E コマース
Legiti (this)	ブラジル、チケット販売に特化、同期評価	ブラジルのチケット販売マーケットプレイス、中堅小売
Sift	グローバル、複数の不正タイプに対応する ML、ワークフロー	国際的なエンタープライズ

ブラジルの加盟店は、最適なサービスを組み合わせてスコアリングするため、これらのうち 2～3 種類をまとめて導入することがよくあります。チケット販売に特化したシグナルには Legiti、汎用的な不正対策レイヤーには ClearSale または Konduto、クロスボーダーのフローには Sift を利用します。

ツール（18）

ツール	目的
evaluate_order	v2 注文エンドポイントを介して、リアルタイムの不正評価のために注文を Legiti に送信します。
update_order	既存の注文のステータス変更を Legiti に通知します（例：
mark_order_fraudulent	確定したチャージバック／不正の結果を Legiti に報告します。
evaluate_sale	POST /evaluation を介した、旧式の単発販売評価です。
track_account	アカウントのライフサイクルイベント（作成／更新／削除）を Legiti に通知します。
track_event	イベント（コンサート、ショー、試合、セッション）のライフサイクル変更を Legiti に通知します。
track_sale	販売の状態変更（作成／更新）を Legiti に通知します。
track_auth	認証またはパスワード関連イベント（ログイン試行、ログアウト、パスワード復旧リクエスト、パス…）を Legiti に通知します。
track_login	ログイン試行（成功または失敗）を Legiti に通知します。
track_logout	ログアウトイベントを Legiti に通知します。
track_signup	新しいアカウントの作成を Legiti に通知します。
track_account_update	アカウントのプロフィール変更（メールアドレス、電話番号、CPF、住所）を Legiti に通知します。
track_password_recovery	パスワード復旧リクエスト（「パスワードを忘れた場合」のクリック）を Legiti に通知します。
track_event_view	ユーザーがイベント／ショーのページを閲覧したことを Legiti に通知します。
track_payment	支払い方法レベルのイベント（与信試行、売上確定、返金、取消）を Legiti に通知します。
get_decision	注文に対する最新の Legiti 判定を取得します。
update_decision_status	注文に対する Legiti の判定を手動で上書きします。通常は、i…に到達した販売を承認または却下するために使用します。
mark_dispute_resolution	チャージバック紛争の結果を Legiti に報告します。つまり、

インストール

npm install @codespar/mcp-legiti@alpha

環境

LEGITI_API_KEY="eyJhbGciOi..."   # JWT bearer token; required
LEGITI_BASE_URL="..."             # optional; defaults to https://collection-prod.inspcdn.net

認証

Bearer トークン（JWT 形式）：

Authorization: Bearer <LEGITI_API_KEY>

Legiti では、sandbox キーと production キーが別々に発行されます。sandbox キーを使うと、すべてのリクエストがテストデータとして記録されるため、ML モデルの学習には使用されません。sandbox キーを使って開発と統合テストを行ってください。テストデータを使って production にアクセスすると、モデルのデータが汚染されます。

判定値

evaluate_order と evaluate_sale は、次の 3 種類の判定を返します。

• approve — 発送します
• reject — 販売をブロックします
• manual — 手動レビューに回します

評価は同期的に行われます。応答には最大約 20 秒かかる場合があります。

一般的なフロー（チケット販売）

1. サインアップ／ログイン時に、track_account（作成／更新）と track_auth（ログイン／ログアウト、パスワード回復、パスワードリセット）を呼び出します。成功・失敗を問わず、すべての認証試行がアカウント乗っ取りの検知に役立つシグナルとなります。
2. プラットフォームで新しいイベント（コンサート、ショー、試合）を公開したら、track_event（作成）を呼び出します。価格、収容人数、日付が変更された場合は更新します。
3. チェックアウト時に、販売情報、アカウント情報、支払い情報、CPF、および主となる event_date_id を指定して evaluate_order を呼び出します。返された判定に従って処理します。approve → 発送、reject → ブロック、manual → 人によるレビュー。
4. 注文の進行に応じて（支払い済み、発送済み、配達済み、キャンセル、返金）、update_order を呼び出します。
5. 発行会社によるチャージバックが確定したら、mark_order_fraudulent を呼び出します。これは Legiti にとって主要な ML フィードバックチャネルです。報告されなかったチャージバックは、類似する購入者に対する今後の判定精度を低下させます。

一般的なフロー（チケット販売以外の E コマース）

track_event はスキップします。evaluate_order の event_date_id フィールドは省略可能になります。Legiti は引き続きアカウント、販売、支払いのシグナルに基づいて評価を行いますが、チケット販売向けの特徴量は使用されません。

Alpha に関する注記

0.1.0-alpha.1 としてリリースされています。Legiti の公開ドキュメントは ClearSale や Konduto よりも対象範囲が限定されています。

• オープンソースの github.com/legiti/docs-backend に記載： POST /evaluation、および Collection API（account、event、sale、transfer、auth、password）の形式と Authorization: Bearer 方式。
• docs.legiti.com の統合ガイドに記載： v2 の注文関連エンドポイント（POST /v2/order、PUT /v2/order、POST /v2/order/mark_fraudulent）。
• 元のカテゴリ仕様から削除： create_rule／list_rules／update_rule／delete_rule。Legiti には公開されたカスタムルールのインターフェースがありません。顧客との契約で利用できる場合は、0.2.0 に昇格してください。

v2 の注文ペイロードスキーマが production で確認できたら、0.1.0 に昇格してください。

実行

# stdio (default — for Claude Desktop, Cursor, etc)
npx @codespar/mcp-legiti

# HTTP (for server-to-server testing)
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-legiti

カテゴリ

fraud — ClearSale、Konduto、Sift に続く、この CodeSpar カテゴリの 4 番目のサーバーです。不正対策サーバーは、決済とは異なる共通の構成（分析 → 判定 → フィードバック）を備えているため、異なるアクワイアラー間の切り替えよりも、プロバイダー間（ClearSale ↔ Konduto ↔ Legiti）の切り替えが容易です。

Enterprise

エージェントによる支払いにガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、支払いルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT