HelloBooks AI Agents

HelloBooks パブリック MCP サーバー

AI エージェントが、古いウェブ情報に頼ることなく、料金、連携機能、対応国、コンプライアンスフレームワークなど、HelloBooks に関する質問に正確に回答できるようにする、公開の読み取り専用Model Context Protocol サーバーです。

これはパブリックサーバーです。公開情報に基づくマーケティングデータのみを公開します。 顧客の帳簿を読み取る認証済み MCP サーバーは、 AI-MCP-Hellobooks にあります。

開発者ポータル

HelloBooks Developer Portal を使って連携機能を構築できます。 API ドキュメントでは、 アプリの登録、OAuth を使った会社との接続、インドのサンドボックスを使ったテストについて説明しています。 以下のパブリック MCP エンドポイントは AI エージェントに製品情報を提供します。会社の API アクセスは Developer Portal を通じて設定します。

インストール

Claude Code / Claude Desktop / Cursor

claude mcp add --transport http hellobooks https://agents.hellobooks.ai/mcp

または、ローカルで開発する場合：

claude mcp add hellobooks-local node /path/to/HelloBooks-MCP-Public/dist/stdio.js

ツール

ツール	説明
list_plans	HelloBooks のすべてのプラン（Free、Starter、Pro、Business、Scale、Partner Program）と、Warehouse／Manufacturing アドオンを一覧表示します。任意の country および plan フィルターを指定できます。価格が設定されていない対応国では、メタデータとともに USD／デフォルトの価格が返されます。
list_integrations	銀行、決済、給与計算、時間管理、配送、税務コンプライアンス、会計同期、E コマース、CRM、ストレージ（Drive／OneDrive）、フリーランス（Upwork）を一覧表示します。任意の category、country、status フィルターを指定できます。
country_support	公開されている 187 の国別ハブすべての国別サポート一覧を表示します。個別に整備されている国については、詳細なコンプライアンス項目も含まれます。
compliance_capabilities	指定した国でサポートされているコンプライアンスフレームワークと、そのバージョンおよび認証情報を表示します。
list_competitors	競合製品（QuickBooks、Xero、FreshBooks、Wave、Zoho Books、Tally）の位置づけを表示します。HelloBooks が優位な点、競合製品が優位な点、価格に関する注記が含まれます。任意の country、tier、id フィルターを指定できます。
compliance_deadlines	国ごとの法定申告および給与関連の提出期限を表示します。IN（GSTR-1／3B／9／9C、CMP-08、Form 24Q、Form 16、PF ECR、ESI）、AU（BAS、STP、Super Guarantee）、GB（VAT MTD、RTI、Self Assessment）、US（1099-NEC／MISC、W-2、Form 941／940）、CA（T4、GST／HST）に対応しています。任意の country、frequency、form フィルターを指定できます。日付は毎年更新され、すべての応答には、期限ごとの source URL を含む免責事項が付記されます。
local_payment_methods	現地の銀行決済ネットワーク／ウォレット決済方法（UPI、BACS、PayID、BPAY、ACH、RTP、Zelle、PayNow、FAST、Interac、…）を、決済ネットワークの処理速度、用途、管轄機関、HelloBooks のサポートレベルとともに表示します。任意の country、useCase、rail、id フィルターを指定できます。
feature_search	マーケティング機能カタログ、プランの機能、連携機能、国別機能、コンプライアンスフレームワーク、競合製品の位置づけ、法定期限、現地の決済方法、公開記事を横断してフリーテキスト検索します。vs Xero、QuickBooks alternative、when is GSTR-3B due、UPI invoice cap、do you have a blog on 1099、agentic accounting などのクエリでは、一致する項目が最上位に表示されます。
list_features	マーケティング機能カタログの全 96 機能を表示します。category、tier、status、marketedOnly、または部分一致の query で絞り込めます。
list_feature_categories	マーケティングサイトに掲載されている 13 の機能カテゴリを、ステータス（live／beta／planned）ごとのカテゴリ別件数とともに表示します。
list_articles	hellobooks.ai で公開されているコンテンツを表示します。比較記事、国別ガイド、厳選された主要記事、サイトマップから検出されたブログ記事が含まれます。任意の country、tag、query、limit フィルターを指定できます。
list_tax_rates	法域ごとの法定税率区分を表示します。対象は、IN GST（5／12／18／28＋ゼロ税率＋免税＋組成制度の商人／製造業者／レストラン）、UK VAT（20／5／ゼロ税率／免税）、AU GST（10／GST 非課税）、US 州ごとの税務管理に関する概要、CA GST＋HST（ON、Atlantic）、SG GST 9％、NZ GST 15％、AE VAT 5％です。country、taxType（GST／VAT／Sales-Tax／HST／…）、または scheme（standard／reduced／zero／exempt／composition／cess）で絞り込めます。各項目には適用開始日と source URL が含まれます。引用する前に必ず確認してください。
lookup_tax_rate	正確な id（例：IN-standard-18）、または country とフリーテキストの category（例：「事務用品」、「レストラン」、「輸出」）を指定して、単一の法定税率を検索します。一致した税率、スコア、参照元 URL を返します。

リソース

URI	説明
hellobooks://about	Markdown 形式の製品概要です。
hellobooks://changelog	最近のリリースノートを JSON 形式で表示します。
hellobooks://feature-catalog	マーケティング機能カタログ全体（13 カテゴリにわたる 96 以上の機能）を JSON 形式で表示します。

セキュリティ体制

• 設計上、読み取り専用です。 どのツールも状態を変更しません。顧客のシステムに接続するツールもありません。
• 公開データのみを使用します。 カタログのコンテンツはすべて、公開されているマーケティングサイトから取得しています。
• 認証はありません。 ナレッジエンドポイントとして意図的に認証を設けていません。
• レート制限を設けています。 IP あたり 120 リクエスト／分、セッションあたり 60 リクエスト／分です。
• 監査ゲートを設けています。 npm run audit:public-data は、src/data/ に PII や認証トークンの文字列が含まれている場合、デプロイをブロックします。

開発

npm install
npm run dev         # HTTP server on :8080 with watch mode
npm run dev:stdio   # stdio transport for local MCP client testing
npm test            # node:test runner
npm run build
npm run audit:public-data

プロジェクト構成

src/
  data/             # Static catalogs — plans, integrations, countries, articles, about
  tools/            # One file per MCP tool
  resources/        # MCP resource registry
  server.ts         # MCP server factory (wires tools + resources)
  http.ts           # Streamable HTTP transport with rate limiting
  stdio.ts          # stdio transport entry point
test/
  tools.test.ts
  resources.test.ts
  public-data.test.ts  # Audit gate
scripts/
  audit-public-data.ts  # CI-callable audit

デプロイ

コンテナ化されています。Dockerfile を参照してください。TLS 終端を担うロードバランサーの背後での実行を想定しています。 環境変数で PORT と HOST を設定してください。

匿名の使用状況テレメトリ（レイヤー 2 のサーバーサイド分析）は、GA4_MEASUREMENT_ID と GA4_API_SECRET の両方が設定されている場合、Measurement Protocol 経由で GA4 に送信されます。 .env.example と src/analytics.ts を参照してください。これらを設定しない場合、テレメトリは完全に無効の状態でサーバーが実行されます。顧客データ、リクエスト本文、ツール引数の値、IP アドレスは一切送信されず、匿名の集計値のみが送信されます。戦略ドキュメント 73 を参照してください。

docker build -t hellobooks-mcp-public .
docker run -p 8080:8080 hellobooks-mcp-public

見つけやすさ

• MCP レジストリに登録されています。
• マーケティングサイトのフッターと /mcp ページからリンクされています。
• https://hellobooks.ai/llms.txt で参照されています。

ライセンス

MIT — LICENSE を参照してください。