altimateguide

Altimateguide Agent MCP サーバー

AI エージェントがツールを Altimateguide ディレクトリに送信し、編集者による審査を受けられる小規模な MCP サーバーです。任意で、dofollow リンクを獲得することもできます。

対象範囲： このサーバーは、公開されている Altimateguide HTTP API とのみ通信します。データベースの認証情報は保持せず、掲載情報の送信や所有に必要な範囲を超えるアクセス権も付与しません。編集者による審査なしに公開されることはなく、送信によって dofollow リンクが自動で付与されることもありません。支払いがサーバー側で確認されて初めて、有料掲載情報は dofollow の候補となります。未確認の掲載情報は nofollow のまま、15～20 営業日以内に審査されます。確認済みかつ支払い済みの掲載情報は、2～7 営業日以内に審査されます。

ツール

ツール	機能
start_login	ワンタイムログインコードをメールで送信します（POST /api/auth/request-code）。
complete_login	コードをアカウント API トークンと交換し、保存します（POST /api/agent/token）。
start_agentid_login	メールの受信箱を使わずに AgentID でのサインインを開始し、authorizeUrl と flowId を返します（POST /api/agent/agentid/start）。
complete_agentid_login	AgentID のサインイン状況をポーリングし、完了後にアカウントトークンを保存します（GET /api/agent/agentid/poll）。
whoami	トークンがローカルに設定されているかを報告します。
list_categories	有効なカテゴリースラッグを取得します（GET /api/agent/categories）。
check_duplicate	公開済みのツールと審査待ちキューを対象に、名前／URL の重複を事前確認します（GET /api/agent/check）。
submit_tool	編集者による審査のために掲載情報を送信します（POST /api/agent/submit）。
get_submission	送信のステータスをポーリングします（GET /api/agent/submissions/{id}）。
update_listing	自分が所有する掲載情報の内容を編集します。変更されるのは渡したフィールドのみです（PATCH /api/agent/listing/{slug}）。
get_listing_stats	自分の掲載情報の訪問数／高評価数／保存数／レビュー数を、7 日間および 30 日間の期間で取得します（GET /api/agent/stats）。
upgrade_listing	自分が所有する掲載情報の sayabout／バッジ／有料プランを選択します（POST /api/agent/listing）。

カテゴリー一覧と編集ポリシーをリソースとして、submit_listing プロンプトとカテゴリー用スラッグの補完候補も公開します。サーバーのinstructionsには、モデル向けのワークフローの概要が記載されています。

submit_tool のパラメーター

• name（string、必須）— ツール名
• url（string、必須）— 正規の http(s) URL
• description（string、任意）— 中立的な説明文。20 文字以上
• categories（array、任意）— list_categories で取得したスラッグ
• categorySuggestions（array、任意）— 該当するカテゴリーがない場合の自由記述の候補（審査担当者向けに記録されます）
• features（array、任意）— { label, description? } の項目
• pros / cons（array、任意）、pricing / freePlan / freeTrial（任意）
• proof（string、任意）— none（デフォルト）| sayabout | badge
• verificationUrl（string）— sayabout／badge の場合は必須
• externalId（string、任意）— 冪等な再送信に使用する ID（省略した場合は URL から生成）
• source（string、任意）— 送信元 ID（デフォルトは agent:mcp）
• resubmit（boolean、任意）— この URL の前回の送信が却下された後に新しい内容を送信するには、trueを設定します（却下された行を再送する代わりに、新しい冪等キーを生成します）

カテゴリーの指定は任意です。 不明なカテゴリーや未指定のカテゴリーがあっても送信は失敗せず、サイトのフィード処理と同様に審査担当者向けに記録されます。有料（dofollow）掲載情報はここからは送信できません。upgrade_listingでpath: "paid"を指定してください。支払いがサーバー側で確認される Dodo のチェックアウト URL が返されます。

リクエスト／レスポンスの完全な仕様：https://altimateguide.com/openapi.json。

審査期間

審査期間とリンクの種類は、どちらも proof によって決まります。

proof	リンク	審査
paid（upgrade_listing 経由）	dofollow	2 営業日以内
sayabout	dofollow	2 営業日以内
badge	dofollow	5～7 営業日
none（デフォルト）	nofollow	15～20 営業日

認証済みおよび有料の申請は、未認証の申請より優先して審査されます。submit_tool の応答には review_eta が含まれます。未認証の場合、応答には upgrade_listing を示す upgrade ヒントも含まれるため、エージェントはユーザーに、より迅速な dofollow の選択肢を提示できます。

設定

• ALTIMATEGUIDE_AGENT_TOKEN — 任意。アカウントの API トークンです。https://altimateguide.com/account で作成するか、complete_login ツールで発行できます。設定されている場合、保存済みのトークンより優先されます。
• ALTIMATEGUIDE_API_URL — 任意。API のベース URL を上書きします（デフォルトは https://altimateguide.com）。
• ALTIMATEGUIDE_CONFIG_DIR — 任意。complete_login がトークンを保存する場所です（デフォルトは ~/.config/altimateguide）。

インストールと使用方法

npx -y altimateguide-agent-mcp        # run directly (stdio)

または、ローカルのチェックアウトから使用します。

npm install
npm run build      # tsc -> dist/
npm run dev        # stdio server via tsx (for local testing)

Claude Desktop／その他の MCP クライアント

{
  "mcpServers": {
    "altimateguide": {
      "command": "npx",
      "args": ["-y", "altimateguide-agent-mcp"]
    }
  }
}

トークンは env.ALTIMATEGUIDE_AGENT_TOKEN を使って指定するか、実行時に start_login と complete_login を呼び出して取得できます（エージェントには、登録に使用するメールボックスへのアクセス権が必要です）。

（ローカルのチェックアウトから使用する場合は、"command": "node" および "args": ["/absolute/path/to/dist/index.js"] を指定します。）

開発

npm run check   # tsc --noEmit
npm run lint    # eslint
npm test        # vitest
npm run build   # tsc -> dist/
npm run bundle  # build a .mcpb (Smithery / Claude Desktop)

レジストリ

server.json（MCP Registry マニフェスト）を通じて登録されています。標準的な stdio サーバーなので、コミュニティのディレクトリ（Glama、PulseMCP、mcp.so、mcp.directory）でも動作します。

プロジェクト構成

.
├── src/
│   ├── index.ts        # stdio server: tool registry + resources/prompts/completions
│   ├── api.ts          # shared fetch client (timeout, retry, error mapping)
│   ├── auth.ts         # start_login / complete_login / whoami
│   ├── categories.ts   # list_categories + matching
│   ├── submit.ts       # submit_tool
│   ├── listing.ts      # check_duplicate / get_submission / upgrade_listing
│   ├── credentials.ts  # token storage (~/.config/altimateguide)
│   ├── schema.ts       # zod -> JSON Schema helper
│   └── version.ts      # package version
├── test/               # vitest
├── server.json         # MCP Registry manifest
├── mcpb/manifest.json  # .mcpb bundle manifest
├── package.json
└── tsconfig.json

セキュリティと権限

このサーバーは、公開されている Altimateguide HTTP API 用の薄いローカルクライアントです。データベースへのアクセス、サブプロセス、バックグラウンド処理はありません。以下がすべての機能範囲です（サプライチェーンスキャナーが報告する範囲と同じです）。

• ネットワーク — ALTIMATEGUIDE_API_URL のベース URL（デフォルトは https://altimateguide.com）への HTTPS アウトバウンド通信のみです。呼び出すエンドポイントは ツール（/api/auth/…、/api/agent/…、/openapi.json）に記載されたものだけです。テレメトリーやサードパーティへの呼び出しはありません。
• 環境変数 — ALTIMATEGUIDE_AGENT_TOKEN、ALTIMATEGUIDE_API_URL、ALTIMATEGUIDE_CONFIG_DIR を読み取ります。書き戻しはありません。
• ファイルシステム — ファイルは1つのみです。アカウントトークンを ${ALTIMATEGUIDE_CONFIG_DIR:-~/.config/altimateguide}/credentials.json に、モード 0600 で作成します。ほかのパスには一切触れません。
• サブプロセスなし、データベースなし — プロセスを起動せず、データベースの認証情報も保持しません。

認証情報：ALTIMATEGUIDE_AGENT_TOKEN 環境変数は常に保存済みファイルより優先されるため、CI 形式のセットアップでは、トークンをディスクに書き込まずに指定できます。

編集者による審査なしに公開されることはありません。また、有料掲載が dofollow の候補となるのは、サーバー側で支払いが確認された後だけです。

ライセンス

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