mcp-grantiq

GrantIQ MCP

AI エージェントが、公開中のすべての米国連邦政府助成金と契約案件に、即座に構造化された形でアクセスできる有料 MCP サーバーです。 Grants.gov と SAM.gov を基盤とし、24 時間の SQLite キャッシュ、キーごとの 1 日あたりの上限、Stripe に対応したアップグレード用フックを備えています。

https://mcp.grantiq.us/mcp/

---

MCPize 掲載用文面

タイトル： GrantIQ MCP — AI エージェント向け米国連邦政府の助成金・契約案件

サブタイトル： あらゆる LLM から、ツール呼び出し 1 回で、SAM.gov と Grants.gov の公開中案件をすべて検索、照合、監視できます。

GrantIQ MCP は、複雑な米国政府の資金調達情報を、すっきりと整理されたエージェント対応 API に変換します。8 つの型付きツールで、幅広いキーワード検索や NAICS コードによる契約案件の検索から、締め切りの確認、過去の受注履歴の検索まで、あらゆる用途に対応します。両方のデータソースの応答を統一した形式に整え、プレーンな JSON として返します。また、同じクエリを繰り返しても上流の機関のレート制限を消費しないよう、24 時間キャッシュします。

調達コパイロット、助成金検索エージェント、B2G 営業ツール向けに構築された GrantIQ MCP には、無料プラン（1 日あたり 50 回の呼び出し）が用意されており、開発者は 15 秒で Claude や Cursor に導入できます。月額 19 ドルで Pro にアップグレードして呼び出し回数を無制限にするか、負荷が一時的に高まる場合は 1 回の呼び出しにつき 0.02 ドルをお支払いください。単一の webhook でキーを無料プランから Pro に切り替えられるため、アプリを書き換える必要はありません。

---

料金

プラン	料金	上限
無料	$0	1 キーあたり 1 日 50 回の呼び出し
Pro	$19 / 月	無制限
従量課金	$0.02 / 呼び出し	無制限

---

インストール

claude mcp add grantiq-mcp --url https://mcp.grantiq.us/mcp/

次に、Claude が使用する API キーを追加します。

claude mcp env grantiq-mcp X-API-Key=your-api-key

共通の公開キーはありません。以下の管理者エンドポイントでキーを発行し（無料プランは 1 日あたり 50 回の呼び出し）、クライアント設定または環境変数に保存してください。

---

ツールリファレンス

ツール	引数	戻り値
search_grants	keyword、agency、amount_min、amount_max、status、limit	条件に一致する助成金の一覧
get_grant_details	opportunity_id	助成金オブジェクト全体
search_contracts	keyword、naics_code、agency、set_aside、limit	SAM 契約案件の一覧
get_contract_details	notice_id	契約オブジェクト全体
match_opportunities	org_description、org_type、focus_areas	マッチ度上位 10 件の案件（助成金＋契約案件）
get_agencies	type（grants / contracts / both）	公開中の案件がある機関を件数順に表示
get_deadlines	days_ahead	N 日以内に締め切られる案件
search_awards	recipient_name、agency、year	過去の SAM 受注履歴

各ツールは、次のいずれかを返します。

{ "success": true,  "cached": false, "data": { ... } }

失敗した場合は、次の内容を返します。

{ "success": false, "error": "..." }

1 日あたりの上限に達すると、HTTP レイヤーは本文とともに 429 を返します。

{ "error": "Limit reached. Upgrade at mcpize.com/grantiq-mcp" }

---

curl の例

MCP エンドポイントは JSON-RPC のストリーミング可能な HTTP プロトコルに対応しており、MCP クライアント経由での利用が最適です。便宜上、すべてのツールには /tools/<tool> に REST ミラーも用意されています。

# Search grants
curl -s https://mcp.grantiq.us/tools/search_grants \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: your-api-key' \
  -d '{"keyword":"renewable energy","limit":5}'

# Get grant details
curl -s https://mcp.grantiq.us/tools/get_grant_details \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: your-api-key' \
  -d '{"opportunity_id":"345678"}'

# Search SAM.gov contracts (cyber, small-business set-aside)
curl -s https://mcp.grantiq.us/tools/search_contracts \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: your-api-key' \
  -d '{"keyword":"cybersecurity","set_aside":"SBA","limit":5}'

# Get contract details
curl -s https://mcp.grantiq.us/tools/get_contract_details \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: your-api-key' \
  -d '{"notice_id":"abc123"}'

# Match opportunities to an org profile
curl -s https://mcp.grantiq.us/tools/match_opportunities \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: your-api-key' \
  -d '{"org_description":"Battery storage R&D startup","org_type":"for-profit","focus_areas":["energy","battery","storage"]}'

# Top agencies right now
curl -s https://mcp.grantiq.us/tools/get_agencies \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: your-api-key' \
  -d '{"type":"both"}'

# Deadlines in the next 14 days
curl -s https://mcp.grantiq.us/tools/get_deadlines \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: your-api-key' \
  -d '{"days_ahead":14}'

# Past award history
curl -s https://mcp.grantiq.us/tools/search_awards \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: your-api-key' \
  -d '{"recipient_name":"Acme Corp","year":2025}'

---

運用者向けエンドポイント

新しいキーを発行します（無料または Pro）。

curl -s https://mcp.grantiq.us/admin/keys \
  -H 'X-Admin-Token: $GRANTIQ_ADMIN_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"tier":"free","daily_limit":50}'

無料キーを Pro にアップグレードします（Stripe のチェックアウト成功 webhook から呼び出します）。

curl -s https://mcp.grantiq.us/billing/upgrade \
  -H 'X-Admin-Token: $GRANTIQ_ADMIN_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"key":"grantiq_xxxxx"}'

---

ローカル開発

python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
# Replace the placeholders, then export them. The process refuses to start
# until GRANTIQ_ADMIN_TOKEN is a real value (not the example placeholder).
set -a && source .env && set +a
python server.py        # http://localhost:8000
pytest -v               # 31 tests, hermetic with respx mocks

---

Railway へのデプロイ

リポジトリには nixpacks.toml が含まれています。railway init の後に railway up を実行するだけです。Railway はシェルを介さずに [start].cmd を実行するため、開始コマンドには python server.py を指定します（uvicorn ... ではありません）。server.py は os.getenv で $PORT を読み取り、uvicorn をプログラムから起動します。

Railway サービスに次の値を設定します。

• SAM_API_KEY — SAM.gov のキー（契約ツールは、キーがない場合はフェイルクローズします）
• GRANTIQ_ADMIN_TOKEN — 起動時に必要な、長くランダムな文字列
• GRANTIQ_DB_PATH — Volume をマウントする場合は /data/grantiq.db（キャッシュとキーをデプロイ後も保持できるため推奨）

このディレクトリには、そのまま実行できる deploy.sh が含まれています。

---

注意事項

• SAM.gov の受賞履歴は、ptype=a（Award Notice）でフィルタリングした機会 API を通じて公開されます。より詳細な受賞分析（CFDA レベルの合計、受領者別の集計）には、USAspending.gov のほうが適しており、v2 での追加が考えられます。
• キャッシュ TTL は全体共通（24 時間）です。期限が重要なワークフローでは、エージェントが異なるクエリ引数を渡すか、/admin/keys を呼び出してキャッシュを回避するキーを発行する必要があります（まだ公開されていません。TODO を参照）。
• マッチスコアの算出は、タイトルと機関のトークンに基づく決定論的なジャッカード係数です。高速で無料です。同じインターフェースの背後に LLM による再ランキングを追加できます。
• Stripe の連携は一方向です（/billing/upgrade）。MCP サーバー自体はチェックアウトページをホストせず、そのページはマーケティングサイトにあります。