Vedika Astrology and Vastu

@vedika-io/mcp-server

Vedika Intelligence API 用の MCP サーバーです。ヴェーダ占星術、西洋占星術、KP、中国占術、タロット、易経、ヒューマンデザイン、数秘術、アーユルヴェーダの各分野における占星術、占術、ヴァーストゥの機能を、AI エージェント向けのセマンティックツールとして提供します。

このサーバーは、ドキュメント化された Vedika API の操作を呼び出します。計算および解釈の対応範囲は、ツールやアカウントプランによって異なります。

ディスカバリーメタデータ

server.json 記述子では、このパッケージを io.github.vedika-io/vedika-mcp-server として識別し、標準入出力トランスポートを使用します。必須のシークレット環境変数として VEDIKA_API_KEY を宣言しています。MCP クライアントのプライベートな環境設定にキーを指定してください。記述子にはキーの値は含まれていません。

クイックスタート

npm install -g @vedika-io/mcp-server

vedika.io/pricing で API キーを取得してください（月額 $12 から）。無料プランはありません。クエリごとに料金が発生します。

設定

どのクライアントを使うかより、キーをどこに置くかが重要です。

• クライアントのGit で無視されるローカル設定ファイルに指定し、共有設定ファイルには決して指定しないでください。コミット済みの設定に含まれるキーは、公開したキーです。
• バージョンを固定してください。 以下の例では @2.0.9 に固定しています。バージョンを指定せずに npx -y @vedika-io/mcp-server を実行すると、起動のたびに npm が現在 latest としているバージョンが解決されます。そのため、不正なリリースや乗っ取られたリリースが公開された瞬間に実行され、どのバージョンを使っていたかの記録も残りません。
• 2.0.4 より前のバージョンでは、キーは VEDIKA_BASE_URL が指定する任意の宛先に送信され、キーを付けたままリダイレクトにも従います。2.0.4 より前のバージョンに固定しないでください。
• キーは支払いに使われる認証情報です。クエリごとに料金が発生します。設定値ではなく、カード番号と同じように扱ってください。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "vedika": {
      "command": "npx",
      "args": ["-y", "@vedika-io/[email protected]"],
      "env": {
        "VEDIKA_API_KEY": "vk_live_your_key_here"
      }
    }
  }
}

Claude Code

.claude/settings.local.json に追加します。

.claude/settings.json ではありません。 そのファイルは共有され、チェックインされるファイルです。そこにキーを置くと、コミットされ、プッシュされ、履歴に永久に残ります。settings.local.json は Git で無視され、お使いのマシンに保持されます。この README では 2026-09-07 まで settings.json と記載されており、公開済みの 2.0.3 パッケージにもその記述が残っています。

{
  "mcpServers": {
    "vedika": {
      "command": "npx",
      "args": ["-y", "@vedika-io/[email protected]"],
      "env": {
        "VEDIKA_API_KEY": "vk_live_your_key_here"
      }
    }
  }
}

Cursor

Cursor の「設定」>「MCP Servers」に追加します。

{
  "vedika": {
    "command": "npx",
    "args": ["-y", "@vedika-io/[email protected]"],
    "env": {
      "VEDIKA_API_KEY": "vk_live_your_key_here"
    }
  }
}

Windsurf

~/.windsurf/mcp_config.json に追加します。

{
  "mcpServers": {
    "vedika": {
      "command": "npx",
      "args": ["-y", "@vedika-io/[email protected]"],
      "env": {
        "VEDIKA_API_KEY": "vk_live_your_key_here"
      }
    }
  }
}

環境変数

変数	必須	デフォルト	説明
VEDIKA_API_KEY	はい	—	API キー（形式：vk_live_*）。Authorization: Bearer として送信されます。
VEDIKA_BASE_URL	いいえ	https://api.vedika.io	https://api.vedika.io と無料のサンドボックス https://api.vedika.io/sandbox のみ使用できます。それ以外の値を指定するとサーバーの起動が停止するため、キーが別のホストに送信されることはありません。

---

ツール

コア

ツール	説明	費用
vedika_ai_chat	ヴェーダ、西洋占星術、KP を選択して自然言語で質問し、会話を続けられます。利用可能な操作と言語は、ルートとアカウントプランによって異なります。	現在の料金条件
vedika_conversation	複数ターンの会話を一覧表示、取得、削除、または継続します。	無料

ヴェーダ計算

ツール	種類	費用
vedika_birth_chart	kundli, birth-chart, planetary-positions, house-cusps, ascendant, birth-details	$0.016-0.028
vedika_dasha	vimshottari, mahadasha, antardasha, pratyantardasha, yogini	$0.016-0.028
vedika_doshas	mangal, kaal-sarp, pitru, nadi, all, sade-sati, sade-sati-advanced	$0.016-0.040
vedika_compatibility	guna-milan, kundali, nakshatra-porutham, thirumana-porutham	$0.040-0.048
vedika_panchang	full, tithi, nakshatra, yoga, karana	$0.012
vedika_muhurta	choghadiya, hora, rahu-kaal, gulika-kaal, yamaghanta, abhijit, brahma, durmuhurta, combined, auspicious	$0.012-0.020
vedika_divisional_charts	D2-D60（15チャート：Hora, Drekkana, Chaturthamsa, Saptamsa, Navamsa, Dashamsa, Dwadashamsa, Shodasamsa, Vimsamsa, Chaturvimsamsa, Bhamsa, Trimsamsa, Khavedamsa, Akshavedamsa, Shashtiamsa）	$0.005
vedika_predictions	daily, weekly, monthly, quarterly, yearly	$0.020-0.088
vedika_ashtakavarga	planet（Bhinnashtakavarga）、sarva（Sarvashtakavarga）	$0.025

西洋占星術

ツール	種類	費用
vedika_western_transits	chart, positions, aspects	$0.064
vedika_western_progressions	chart, positions, aspects	$0.092
vedika_western_solar_return	chart, positions, aspects	$0.120
vedika_western_relationship	synastry, synastry-aspects, composite, composite-aspects	$0.148

システム横断（3 ツール）

ツール	種類	費用
vedika_horoscope	ヴェーダ式の日次／週次／月次；西洋式の日次または高度な日次	現在の API 価格を確認してください
vedika_numerology	life-path, destiny, personality, soul-urge, personal-year, complete, compatibility	$0.003-0.010
vedika_varshaphal	ヴェーダ式の年次ソーラーリターン（Tajaka システム）	$0.006

補足

ツール	種類	費用
vedika_strength	chandra-bala, tara-bala, upagraha, planet-relationship, shadbala	$0.020
vedika_calendar	ritu, solstice, anandadi-yoga, auspicious-yoga, auspicious-period, inauspicious-period, gowri-nalla-neram, disha-shool, planet-transit, chandrashtama, chandrashtama-periods	$0.016-0.020

タロットと占術

ツール	説明	費用
vedika_tarot_draw	シングル、3 枚引き、ケルト十字、ホースシュー、恋愛、またはキャリアのスプレッドでタロットカードを引きます。Rider-Waite、Thoth、またはMarseilleのデッキを使用します。	$0.020-0.048
vedika_tarot_daily	意味、キーワード、毎日のガイダンスを含む今日のカード。日ごとにキャッシュされます。	$0.008
vedika_iching_cast	易の卦を立てます（蓍草法またはコイン法）。本卦＋変爻＋之卦を示します。	$0.012

中国占星術

ツール	説明	費用
vedika_chinese_zodiac	十二支の動物、五行、陰陽、ラッキーナンバー／カラー、相性のよい／悪い動物を示します。中国の旧正月の日付を考慮します。	$0.003
vedika_chinese_bazi	タイムゾーン情報のない日時から基本的な八字チャートを作成します：年／月／日／時の柱、日主、優勢な五行、五行のバランス。タイムゾーン情報を含む入力は、受け入れられる民間時刻、ゾーン時刻、または太陽時の意味が確定するまで保留されます。	現在の API 価格を確認してください

代替システム

ツール	説明	費用
vedika_human_design_chart	ヒューマンデザインのボディグラフ：タイプ、ストラテジー、オーソリティ、プロフィール、定義済み／未定義のセンター、チャネル、ゲート。	$0.040
vedika_crystals_recommend	星座、惑星、またはニーズに基づいて、クリスタルや宝石をおすすめします。ヴェーダのラトナ・シャーストラと現代のクリスタルヒーリングに基づきます。	$0.012

ヴェーダ占星術の拡張ツール

ツール	説明	料金
vedika_matrimony_match	クンダリー・マッチング：36ポイントのアシュタクータ、ダシャクータの概要、ドーシャの解消要因、総合判定。ポルッタムには southIndian: true を指定します。	現在の API 料金を確認してください
vedika_dasha_ashtottari	108年周期のアシュトッタリ・ダシャー（ヴィムショッタリの代替）。8つの惑星を対象とし、マハーダシャー／アンタルダシャー／プラティアンタルダシャーまで確認できます。	$0.020
vedika_lalkitab_remedies	凶作用を受けた惑星に対するラル・キタブの対処法。古典的な BPHS とは異なる独自のトトカ（実践的な対処法）を提示します。任意で負債（リナ）分析も利用できます。	$0.020
vedika_spiritual_mantra	古典文献に基づく、個人に合わせたマントラの推奨。サンスクリット語と IAST 翻字、ジャパの回数、ムフルタ、マーラーの素材を提示します。	$0.016

スピリチュアルとウェルネス

ツール	説明	料金
vedika_spiritual_deity	ナヴァーンシャにおけるアートマカーラカからイスhta・デーヴァター（個人の神格）を導きます。ダルマ、パーラナ、グル・デーヴァターも提示します。BPHS 第33章に基づきます。	$0.020
vedika_health_ayurvedic	出生図からアーユルヴェーダのプラクリティ（体質）を分析します。ヴァータ／ピッタ／カパのバランス、食事、ハーブ、季節ごとの推奨事項を提示します。	$0.024

バンドル

ツール	説明	料金
vedika_daily_bundle	1回の呼び出しで、その日の一般的なコンテンツを取得します：タロットカード、エンジェルナンバー、クリスタル、マントラ、月相、ルーン、易。星座ごとのホロスコープではありません。	現在の API 料金を確認してください
vedika_numerology_complete	数秘術の完全なレポート：ライフパス、デスティニー、ソウルアージ、パーソナリティ、マチュリティ、ピナクル、チャレンジ、カルマの負債／教訓。ピタゴラス式またはカルデア式です。	$0.010

ユーティリティ

ツール	説明	料金
vedika_usage	ウォレット残高、利用履歴、概要、モデル別内訳を確認します	無料

ヴァーストゥ

ツール	説明
vastu_reference	静的なヴァーストゥ参照表（マンダラのグリッド、方位、欠陥、対処法、色、素材、門の障害物）
vastu_audit_floor_plan	部屋の一覧を、各部屋が占めるコンパスゾーンと照合して監査します
vastu_room_placement	1つのゾーンにおける1種類の部屋の配置ガイダンス
vastu_mandala_project	敷地のポリゴン上にヴァーストゥ・プルシャ・マンダラのグリッドを投影します
vastu_generate_plan	敷地と部屋の構成から、ヴァーストゥに準拠したプランを生成します
vastu_declination	磁気偏角のおおまかな参照値
vastu_operation	パスのサフィックスを指定して、任意のヴァーストゥ操作を呼び出します。assessments/batch では、保持された idempotencyKey が必要です
vastu_job_submit, vastu_job_status, vastu_job_results, vastu_job_cancel, vastu_job_artifact	一括ヴァーストゥジョブと成果物（以下を参照）

---

入力パターン

出生情報（ほとんどのヴェーダ占星術／西洋占星術ツールで必須）

{
  "datetime": "1990-06-15T14:30:00",
  "latitude": 28.6139,
  "longitude": 77.2090,
  "timezone": "+05:30",
  "ayanamsa": "lahiri"
}

フィールド	型	必須	備考
datetime	string	はい	ISO 8601 形式。ハウス／アセンダントを正確に算出するには時刻が必要です。
latitude	number	はい	-90～90。緯度が66.5を超える極地は、ハウスの信頼性が低いため拒否されます。
longitude	number	はい	-180～180。
timezone	string	はい	UTC オフセットを推奨します（+05:30）。IANA 名も使用できます（Asia/Kolkata）。
ayanamsa	string	いいえ	デフォルト：lahiri。選択肢：lahiri、kp、raman、yukteshwar、fagan-bradley、true-chitra、true-revati、ss-citra。ヴェーダ占星術ツールでのみ使用されます。西洋占星術ツールでは無視されます。

ヴェーダ占星術の相性（男性／女性）

{
  "type": "guna-milan",
  "male": { "datetime": "1992-03-15T10:30:00", "latitude": 28.61, "longitude": 77.20, "timezone": "+05:30" },
  "female": { "datetime": "1994-07-22T08:15:00", "latitude": 19.07, "longitude": 72.87, "timezone": "+05:30" }
}

西洋占星術の相性（person1／person2――性別を問わない形式）

{
  "type": "synastry",
  "person1": { "datetime": "1990-01-15T14:30:00", "latitude": 40.71, "longitude": -74.00, "timezone": "-05:00" },
  "person2": { "datetime": "1992-08-22T09:45:00", "latitude": 34.05, "longitude": -118.24, "timezone": "-08:00" }
}

場所のみ（パンチャン、ムフルタ）

{
  "type": "choghadiya",
  "latitude": 28.6139,
  "longitude": 77.2090,
  "timezone": "+05:30"
}

すべての場所フィールドは任意です。デフォルトはデリー（28.6139, 77.2090, +05:30）です。

Zodiac Signs（予測、ホロスコープ）

英語とヒンディー語（ローマ字表記）の両方を受け付けます。

英語	ヒンディー語
aries	mesha
taurus	vrishabha
gemini	mithuna
cancer	karka
leo	simha
virgo	kanya
libra	tula
scorpio	vrishchika
sagittarius	dhanu
capricorn	makara
aquarius	kumbha
pisces	meena

Tarot Spreads

{
  "spread": "celtic-cross",
  "question": "What should I focus on this month?",
  "deck": "rider-waite"
}

Chinese Ba Zi

{
  "datetime": "1990-06-15T14:30:00"
}

婚姻相性（新婦／新郎）

{
  "bride": { "datetime": "1994-07-22T08:15:00", "latitude": 19.07, "longitude": 72.87, "timezone": "+05:30", "gender": "female" },
  "groom": { "datetime": "1992-03-15T10:30:00", "latitude": 28.61, "longitude": 77.20, "timezone": "+05:30", "gender": "male" }
}

---

出力例

vedika_birth_chart（type: "kundli"）

{
  "ascendant": { "sign": "Virgo", "degree": 14.23, "nakshatra": "Hasta", "pada": 2 },
  "planets": [
    { "name": "Sun", "sign": "Taurus", "house": 9, "degree": 0.85, "nakshatra": "Krittika", "pada": 4, "retrograde": false, "dignity": "Neutral" },
    { "name": "Moon", "sign": "Cancer", "house": 11, "degree": 22.14, "nakshatra": "Ashlesha", "pada": 3, "retrograde": false, "dignity": "Own" },
    { "name": "Mars", "sign": "Pisces", "house": 7, "degree": 6.52, "nakshatra": "Uttara Bhadrapada", "pada": 2, "retrograde": false, "dignity": "Neutral" }
  ],
  "houses": [
    { "house": 1, "sign": "Virgo", "degree": 14.23, "lord": "Mercury" },
    { "house": 2, "sign": "Libra", "degree": 12.15, "lord": "Venus" }
  ]
}

vedika_dasha（system: "vimshottari"）

{
  "currentDasha": {
    "mahadasha": { "planet": "Jupiter", "start": "2020-03-15", "end": "2036-03-15" },
    "antardasha": { "planet": "Saturn", "start": "2024-09-01", "end": "2027-03-15" },
    "pratyantar": { "planet": "Mercury", "start": "2025-11-20", "end": "2026-04-30" }
  },
  "dashaTimeline": [
    { "planet": "Ketu", "start": "1990-06-15", "end": "1997-06-15", "years": 7 },
    { "planet": "Venus", "start": "1997-06-15", "end": "2017-06-15", "years": 20 },
    { "planet": "Sun", "start": "2017-06-15", "end": "2023-06-15", "years": 6 }
  ]
}

vedika_tarot_draw（spread: "three-card"）

{
  "spread": "three-card",
  "cards": [
    { "position": "past", "card": "The Tower", "number": 16, "suit": "major", "reversed": false, "meaning": "Sudden upheaval, revelation, awakening" },
    { "position": "present", "card": "Two of Cups", "number": 2, "suit": "cups", "reversed": false, "meaning": "Partnership, harmony, mutual attraction" },
    { "position": "future", "card": "The Star", "number": 17, "suit": "major", "reversed": false, "meaning": "Hope, renewal, inspiration, serenity" }
  ],
  "deck": "rider-waite"
}

vedika_chinese_bazi

{
  "system": "chinese",
  "chart": {
    "yearPillar": { "stem": { "name": "Geng", "chinese": "庚", "element": "Metal", "polarity": "Yang" }, "branch": { "name": "Wu", "chinese": "午", "animal": "Horse", "element": "Fire", "polarity": "Yang" }, "label": "Geng Wu" },
    "monthPillar": { "stem": { "name": "Ren", "chinese": "壬", "element": "Water", "polarity": "Yang" }, "branch": { "name": "Wu", "chinese": "午", "animal": "Horse", "element": "Fire", "polarity": "Yang" }, "label": "Ren Wu" },
    "dayPillar": { "stem": { "name": "Xin", "chinese": "辛", "element": "Metal", "polarity": "Yin" }, "branch": { "name": "Hai", "chinese": "亥", "animal": "Pig", "element": "Water", "polarity": "Yin" }, "label": "Xin Hai" },
    "hourPillar": { "stem": { "name": "Yi", "chinese": "乙", "element": "Wood", "polarity": "Yin" }, "branch": { "name": "Wei", "chinese": "未", "animal": "Goat", "element": "Earth", "polarity": "Yin" }, "label": "Yi Wei" },
    "dayMaster": { "name": "Xin", "chinese": "辛", "element": "Metal", "polarity": "Yin" },
    "dominantElement": "Water",
    "elementBalance": { "Wood": 1, "Fire": 2, "Earth": 1, "Metal": 2, "Water": 2 }
  }
}

vedika_compatibility（type: "guna-milan"）

{
  "totalScore": 26,
  "maxScore": 36,
  "recommendation": "Good match",
  "factors": [
    { "name": "Varna", "score": 1, "maxScore": 1, "description": "Spiritual compatibility" },
    { "name": "Vashya", "score": 2, "maxScore": 2, "description": "Mutual attraction" },
    { "name": "Tara", "score": 3, "maxScore": 3, "description": "Birth star compatibility" },
    { "name": "Yoni", "score": 3, "maxScore": 4, "description": "Physical compatibility" },
    { "name": "Graha Maitri", "score": 5, "maxScore": 5, "description": "Mental compatibility" },
    { "name": "Gana", "score": 5, "maxScore": 6, "description": "Temperament" },
    { "name": "Bhakoot", "score": 7, "maxScore": 7, "description": "Health & wealth" },
    { "name": "Nadi", "score": 0, "maxScore": 8, "description": "Genetic compatibility" }
  ],
  "mangalDosha": { "male": false, "female": true, "compatible": true }
}

vedika_panchang（element: "full"）

{
  "date": "2026-03-13",
  "vara": { "name": "Friday", "deity": "Shukra" },
  "tithi": { "name": "Krishna Chaturdashi", "deity": "Shiva", "endTime": "2026-03-13T18:45:00+05:30" },
  "nakshatra": { "name": "Purva Bhadrapada", "lord": "Jupiter", "endTime": "2026-03-13T22:10:00+05:30" },
  "yoga": { "name": "Siddha", "endTime": "2026-03-13T15:30:00+05:30" },
  "karana": { "name": "Vanija", "endTime": "2026-03-13T18:45:00+05:30" },
  "sunrise": "06:28:00+05:30",
  "sunset": "18:22:00+05:30"
}

vedika_ai_chat

{
  "response": "Based on your birth chart, Jupiter is currently transiting your 7th house...",
  "conversationId": "conv_abc123",
  "tokens": { "input": 1250, "output": 480 },
  "cost": 0.012,
  "system": "vedic"
}

vedika_predictions（period: "daily"）

{
  "sign": "aries",
  "period": "daily",
  "date": "2026-03-13",
  "prediction": {
    "overall": "A favorable day for career decisions...",
    "career": "Professional growth opportunities emerge...",
    "love": "Venus influence brings harmony...",
    "health": "Focus on physical activity...",
    "finance": "Avoid impulsive spending..."
  },
  "luckyNumber": 7,
  "luckyColor": "Red"
}

vedika_western_transits（type: "aspects"）

{
  "transitAspects": [
    {
      "transitPlanet": "Saturn",
      "transitSign": "Pisces",
      "transitDegree": 22.5,
      "natalPlanet": "Moon",
      "natalSign": "Gemini",
      "natalDegree": 24.1,
      "aspect": "Square",
      "orb": 1.6,
      "applying": true,
      "influence": "challenging"
    }
  ]
}

vedika_usage（action: "wallet"）

{
  "walletBalance": 5456,
  "currency": "USD",
  "displayBalance": "$54.56",
  "plan": "professional",
  "subscriptionEndDate": "2026-04-01T00:00:00Z"
}

注： walletBalance は米ドルのセント単位です。ドル表示するには100で割ってください。

---

エラー処理

すべてのエラーは、内容を説明するメッセージとともに MCP ツールエラーとして返されます。

ステータス	意味	メッセージ例
400	入力が無効です	Bad Request: datetime is required
401	API キーが無効です	Invalid API key. Get one at https://vedika.io/pricing -- format: vk_live_*
402	残高不足	Insufficient wallet balance (required $0.016, available $0.005, deficit $0.011). Add funds at https://vedika.io/dashboard. Do not retry until the wallet is topped up. 再試行されません。
403	サブスクリプションが無効です	Subscription inactive or endpoint not included in your plan.
429	レート制限中	応答本文の code によって分類されます。RATE_LIMIT_EXCEEDED：Rate limited. Retry after 5s. DAILY_LIMIT_EXCEEDED：Daily call limit reached. Do not retry until the limit resets... 自動的には再試行されません。
422	冪等性キーが拒否されました	IDEMPOTENCY_NOT_SUPPORTED：エンドポイントはキーを受け付けず、課金も試みられていません。idempotencyKey を付けずに再送してください。
5xx	サーバーエラー	GET リクエスト、および呼び出し元の idempotencyKey を含む POST は、1秒のバックオフを設けて1回再試行されます。それ以外の POST は再試行されないため、課金対象の呼び出しが失敗しても二重請求されません。
タイムアウト	応答が遅すぎます	Request timed out after 30s -- /v2/astrology/kundli

タイムアウト設定

リクエストの種類	タイムアウト	再試行
AI チャット（vedika_ai_chat）	90s	再試行なし（すでに長めに設定されています）
POST 計算エンドポイント	30s	idempotencyKey がある場合のみ、5xx で1回再試行。それ以外は再試行なし
GET エンドポイント	15s	5xx で1回再試行

---

料金

無料プランはありません。クエリごとに料金が発生します。モックデータを使用する無料サンドボックス：VEDIKA_BASE_URL=https://api.vedika.io/sandbox を設定してください。vedika.io/sandbox も参照してください。

プラン	価格	月間ウォレットクレジット	レート制限
Starter	$12/mo	$12	60 req/min
Professional	$60/mo	$60	120 req/min
Business	$120/mo	$120	300 req/min
Enterprise	$240/mo	$240	600 req/min

API キーは vedika.io/pricing で取得してください。

---

技術詳細

• ランタイム：Node.js 20+
• トランスポート：stdio（MCP 標準）
• 依存関係：@modelcontextprotocol/sdk、zod（その他のランタイム依存関係はありません）
• HTTP：ネイティブの fetch（axios は使用しません）
• 冪等性：ツールで明示的に idempotencyKey を指定しない限り、冪等性ヘッダーやリクエスト ID ヘッダーは送信されません（Vastu バッチ、ジョブ、vastu_operation）。API は /v2 で呼び出し元が送信した x-request-id を冪等性の申告として読み取り、冪等性が保証されていないエンドポイントでは 422 で拒否します。
• リトライ：GET リクエストと、idempotencyKey を付けた POST リクエストでは、5xx エラー時に 1 秒のバックオフで 1 回リトライします。キーなしの課金対象 POST はリトライされません。402 や 429 を含む 4xx レスポンスはリトライされません。
• タイムアウト：AI チャットは 90 秒、POST の計算は 30 秒、GET エンドポイントは 15 秒
• モジュール形式：このパッケージは ESM 専用です（"type": "module"）。npx／vedika-mcp-server バイナリを介した実行（上記の通常の MCP クライアントのセットアップ）は、ご利用のプロジェクトのモジュール形式に関係なく動作します。CommonJS プロジェクトからライブラリとしてインポートする場合は、通常の require('@vedika-io/mcp-server') を使用するとエラーになります。代わりに動的インポートを使用してください：

  const { VedikaApiClient } = await import('@vedika-io/mcp-server');
  

リンク

• API ドキュメント
• API リファレンス
• 料金
• ダッシュボード
• MCP サーバーのページ
• サポート

ライセンス

MIT

Vastu のジョブとアーティファクト

vastu_job_submit を呼び出し、request.operation に assessments、plan-analyze、または plan-report を設定し、request.items に一意の {id, input} オブジェクトを含め、呼び出し元で保持する idempotencyKey を指定してください。レポートを引き渡す場合は input.format: "html" を使用してください。JSON レポートとプラン分析では、JSON アーティファクトが公開されます。送信すると、安定した jobId と maxCharge の見積もりが返されます。成功した各項目には既存の単項目料金が適用され、追加のジョブ料金はかかりません。無効な項目には課金されません。

vastu_job_status を使用して件数と料金をポーリングし、vastu_job_results を使用してページを読み取ります（nextCursor: null でページネーションが終了します）。vastu_job_artifact に jobId と itemId を指定すると、成果物と領収情報を正確に取得できます。同じアーティファクトは、vedika://vastu/jobs/{jobId}/items/{itemId} にある読み取り専用リソースとしても利用できます。item ID は URL エンコードしてください。結果とアーティファクトは 7 日後に期限切れとなります。vastu_job_cancel は未開始の項目を停止しますが、処理中の項目は完了して課金される場合があります。これらのツールを使用するには、パッケージバージョン 2.0.7 以降を使用し、アカウントでジョブが利用可能であることを確認してください。キーなしのサンドボックスはステートレスなプレビューを返します。ステータスの確認やアーティファクトの取得のためにジョブを保持することはできません。