Numeral MCP by usefulapi

usefulapi の Numeral MCP

Claude、Cursor、または任意の MCP クライアントから、Numeral の売上税コンプライアンスを管理できます — 売上税と VAT の計算、取引と返金の記録、商品と顧客の管理が可能です。 ホスト型で、ローカルへのインストールは不要です。Numeral API キーを使って接続します。

ライブエンドポイント： https://numeral.usefulapi.io/mcp · ホームページ： https://usefulapi.io

接続

• Claude（claude.ai、Desktop）：Customize → Connectors を開き、+ Add → Add custom connector をクリックして、https://numeral.usefulapi.io/mcp を貼り付けます。
• Claude Code： claude mcp add --transport http numeral https://numeral.usefulapi.io/mcp を実行し、その後 /mcp を実行してログインします。
• VS Code： VS Code に追加。
• Cursor およびその他のクライアント： URL をリモート MCP サーバーとして追加します。

{
  "mcpServers": {
    "numeral": {
      "url": "https://numeral.usefulapi.io/mcp"
    }
  }
}

URL のみを追加してください。クライアント設定には Authorization ヘッダーや API キーを追加しないでください。サーバーが OAuth でログインし、ログインページで Numeral の認証情報を入力します。

手順ごとの設定方法、認証情報の確認場所、よくある質問：https://usefulapi.io/numeral/

初回接続時に、Numeral ダッシュボードから取得した Numeral API キー を貼り付けます。このキーは検証され、ユーザーごとに保存され、本人のみが使用できます。設定ファイルにキーを記載する必要はありません。

ツール

ツール	種類	機能
numeral_ping	read	Ping（ヘルスチェック）
numeral_calculate_tax	read	税額を計算
numeral_get_transaction	read	取引を取得
numeral_list_transaction_refunds	read	取引の返金一覧を取得
numeral_list_products	read	商品一覧を取得
numeral_get_product	read	商品を取得
numeral_get_customer	read	顧客を取得
numeral_create_transaction	write	取引を作成
numeral_create_refund	write	返金を作成
numeral_create_product	write	商品を作成
numeral_create_customer	write	顧客を作成
numeral_usage_status	meta	使用状況（無料枠の利用量）
numeral_request_feature	meta	不足している機能をリクエスト
numeral_upgrade	meta	Pro にアップグレード（無制限*）
numeral_cancel_subscription	meta	Pro サブスクリプションをキャンセル

read ツールは読み取り専用です。write ツールはデータを変更します（クライアントは実行前に確認する必要があります）。meta ツールは使用状況を報告し、サブスクリプションを管理するか、機能リクエストを送信します。

料金

プラン	料金	上限
Free	$0	月あたり 50 回のツール呼び出し
Pro（ユーザーごと）	月額 $9 または 年額 $90（2 か月分無料）	無制限*

*Pro のこのサーバーでの公正利用上限は、月あたり 10,000 回のツール呼び出しです。それ以上をご希望の場合は、[email protected] までお問い合わせください。

Pro が適用されるのはこのサーバーのみです。numeral_upgrade で登録してください（Stripe Checkout のリンクが返されます）。numeral_cancel_subscription でいつでもキャンセルできます。Pro は支払い済み期間の終了まで利用でき、現行期間の返金はありません。その前に numeral_upgrade を実行すると、キャンセルは取り消されます。[email protected] へのお問い合わせも可能です。

ライセンス

MIT — LICENSE をご覧ください。ドキュメントのみです。サーバーはホスト型です。