Poi MCP Server

English | 日本語

A server that exposes Poi's public API as MCP (Model Context Protocol) tools. From compatible LLM clients (Claude Code / Claude Desktop, etc.), you can call file upload/download, comment read/post, and free license key issuance as "tools".

About Poi

Poi is a simple hosting service for temporarily publishing static web content — no server setup required. Upload a ZIP (a multi-file site), a single HTML file, or a Markdown document, and you instantly get a public URL of the form https://s.poi-plane.com/s/<slug>/.

• Instant publishing — a drag-and-drop or API upload returns a shareable URL right away.

• Supported content — .zip (a whole site), .html/.htm (a single page), and .md/.markdown (rendered to a styled page; the original .md stays downloadable).

• Auto-expiry — every published page is automatically deleted after 7 days.

• Visitor comments — each public site has a comment area that visitors can read and post to.

• Not indexed — pages carry noindex, so search engines don't list them (but anyone who knows the URL can view them).

• License keys — uploading requires a license key (LIC-…). A paid key costs 300 JPY per year; free keys can also be issued (see poi_issue_free_license).

• Limits — up to 200 MB and 2,000 files per upload; no server-side execution (PHP/CGI) and no password protection.

This MCP server lets an LLM client drive all of the above through tools.

Under the hood it calls Poi's public API:

• poi_upload → POST /api/v1/upload.php

• poi_download → GET /api/v1/download.php

• poi_check_license → GET /api/v1/license.php

• poi_list_comments → GET /api/v1/comments.php

• poi_post_comment → POST /api/v1/comments.php

• poi_issue_free_license → POST /api/v1/issue-free.php

Related MCP server: harness_to_mcp

Tools

Setup

It is published on npm, so cloning or npm install is not required. Just specify npx -y poi-mcp as your client's launch command and it will be downloaded and started automatically on first run.

• Requirements: Node.js 18 or later (npx is enough; uses fetch / FormData / Blob)

• To pin a version, specify it like npx -y poi-mcp@1.

Only if you want to develop or modify it locally, clone the repository, run cd mcp && npm install, and replace the launch command with node src/index.mjs.

Try it for free

You can try everything without buying a license. The issue password below is deliberately public for trial use — use it to issue your own free license key:

QyOvsWFAw4upl2a1ULJXc9EMKNZh5ozq

1. Set it as POI_ISSUE_PASSWORD (see the client examples below), or pass it per call via the password argument.

2. Ask your LLM client to run poi_issue_free_license() — it returns a LIC-… key.

3. Use that key as POI_API_KEY (or poi_upload's apiKey) to upload.

• Free keys are valid for 30 days; issuance is rate-limited per IP.

• Published sites still expire after 7 days as usual.

• You can also get a free key in the browser at poi-plane.com.

Environment variables

POI_API_KEY / POI_ISSUE_PASSWORD can also be overridden per call via tool arguments (apiKey / password).

Registering with a client

Claude Code (CLI)

claude mcp add poi \
  --env POI_BASE_URL=https://poi-plane.com \
  --env POI_API_KEY=LIC-XXXX-XXXX-XXXX-XXXX \
  --env POI_ISSUE_PASSWORD=your-issue-password \
  -- npx -y poi-mcp

Claude Desktop / config file (.mcp.json or claude_desktop_config.json)

{
  "mcpServers": {
    "poi": {
      "command": "npx",
      "args": ["-y", "poi-mcp"],
      "env": {
        "POI_BASE_URL": "https://poi-plane.com",
        "POI_API_KEY": "LIC-XXXX-XXXX-XXXX-XXXX",
        "POI_ISSUE_PASSWORD": "your-issue-password"
      }
    }
  }
}

Manual verification

You can check interactively with the MCP Inspector:

npx @modelcontextprotocol/inspector node src/index.mjs

Usage examples (instructions to the LLM)

• "Upload site.zip bundling ./dist to Poi and tell me the URL" → poi_upload({ path: "./site.zip" })

• "Publish this HTML as page.html" → poi_upload({ content: "<h1>hi</h1>", filename: "page.html" })

• "Download 9KwR7jgeDfPr to my machine" → poi_download({ slug: "9KwR7jgeDfPr" }) (Markdown sites save .md, others save .zip)

• "Check whether this license key is still valid" → poi_check_license({ key: "LIC-XXXX-XXXX-XXXX-XXXX" }) → { valid, expires_at, days_left, ... }

• "List the comments on 9KwR7jgeDfPr" → poi_list_comments({ slug: "9KwR7jgeDfPr" })

• "Post 'Nice!' as a comment on 9KwR7jgeDfPr" → poi_post_comment({ slug: "9KwR7jgeDfPr", body: "Nice!" }) (omit author for anonymous)

• "Get a free key for uploading" → poi_issue_free_license() (uses the issue password from env vars)

API keys and issue passwords are secrets (the trial issue password above is an exception — it is public by design). In shared environments, pass them via environment variables and be careful not to leave them in logs or conversations.

Publishing (for maintainers)

To make npx -y poi-mcp work, publish this mcp/ to npm.

cd mcp
npm login
npm version patch        # bump the version as needed
npm publish --access public

• If the package name poi-mcp is already taken, change name in package.json to a scoped name (e.g. @you/poi-mcp), and read poi-mcp in the README and docs accordingly.

• Only files (src and README.md) are published. node_modules is not included.

Poi MCP サーバー（日本語）

English | 日本語

Poiの外部公開 API を MCP（Model Context Protocol）ツールとして公開するサーバーです。 対応する LLM クライアント（Claude Code / Claude Desktop など）から、ファイルのアップロード・ ダウンロード、コメントの取得・投稿、無料ライセンスキーの発行を「ツール」として呼び出せます。

Poi とは

Poi は、静的な Web コンテンツを手軽に一時公開できるホスティングサービスです。 サーバーの用意は不要。ZIP（複数ファイルのサイト）・単体 HTML・Markdown をアップロードすると、 https://s.poi-plane.com/s/<slug>/ 形式の公開 URL がその場で発行されます。

• すぐ公開 — ドラッグ&ドロップ、または API でアップロードすると共有 URL がすぐ返ります。

• 対応コンテンツ — .zip（サイト一式）・.html/.htm（単体ページ）・.md/.markdown （整形済みページとして表示。原本 .md もダウンロード可能）。

• 自動失効 — 公開ページは 7 日で自動的に削除されます。

• 訪問者コメント — 各公開サイトに、訪問者が読み書きできるコメント欄があります。

• 検索非対象 — ページには noindex が付き、検索エンジンには載りません（URL を知っていれば誰でも閲覧可）。

• ライセンスキー — アップロードにはライセンスキー（LIC-…）が必要です。有料キーは 1 年間 300 円、無料キーの発行も可能です（poi_issue_free_license を参照）。

• 上限 — 1 回のアップロードで最大 200 MB・2,000 ファイル。サーバー実行（PHP/CGI）やパスワード保護は非対応。

この MCP サーバーは、上記のすべてを LLM クライアントからツールとして操作できるようにします。

内部では Poi の公開 API を叩きます:

• poi_upload → POST /api/v1/upload.php

• poi_download → GET /api/v1/download.php

• poi_check_license → GET /api/v1/license.php

• poi_list_comments → GET /api/v1/comments.php

• poi_post_comment → POST /api/v1/comments.php

• poi_issue_free_license → POST /api/v1/issue-free.php

ツール

セットアップ

npm に公開してあるので、クローンや npm install は不要です。クライアントの起動コマンドに npx -y poi-mcp を指定すれば、初回に自動でダウンロードされて起動します。

• 必要なもの: Node.js 18 以上（npx が使えれば OK。fetch / FormData / Blob を使用）

• バージョンを固定したいときは npx -y poi-mcp@1 のように指定します。

ローカルで開発・改造する場合のみ、リポジトリを clone して cd mcp && npm install、 起動コマンドを node src/index.mjs に置き換えてください。

お試し（無料キーの発行）

ライセンスを購入しなくても一通り試せます。以下の発行パスワードはお試し用に公開している ものです。これを使って自分用の無料ライセンスキーを発行してください:

QyOvsWFAw4upl2a1ULJXc9EMKNZh5ozq

1. POI_ISSUE_PASSWORD に設定する（下記のクライアント登録例を参照）か、password 引数で都度渡す

2. LLM クライアントに poi_issue_free_license() を実行させる → LIC-… のキーが返る

3. 返ったキーを POI_API_KEY（または poi_upload の apiKey）に設定してアップロード

• 無料キーの有効期間は 30 日。発行は IP 単位でレート制限されます

• 公開サイトは通常どおり 7 日で失効します

• ブラウザから poi-plane.com で取得することもできます

環境変数

POI_API_KEY / POI_ISSUE_PASSWORD はツール引数（apiKey / password）で都度上書きもできます。

クライアントへの登録

Claude Code（CLI）

claude mcp add poi \
  --env POI_BASE_URL=https://poi-plane.com \
  --env POI_API_KEY=LIC-XXXX-XXXX-XXXX-XXXX \
  --env POI_ISSUE_PASSWORD=発行パスワード \
  -- npx -y poi-mcp

Claude Desktop / 設定ファイル（.mcp.json や claude_desktop_config.json）

{
  "mcpServers": {
    "poi": {
      "command": "npx",
      "args": ["-y", "poi-mcp"],
      "env": {
        "POI_BASE_URL": "https://poi-plane.com",
        "POI_API_KEY": "LIC-XXXX-XXXX-XXXX-XXXX",
        "POI_ISSUE_PASSWORD": "発行パスワード"
      }
    }
  }
}

動作確認（手動）

MCP Inspector で対話的に確認できます:

npx @modelcontextprotocol/inspector node src/index.mjs

使い方の例（LLM への指示）

• 「./dist をまとめた site.zip を Poi にアップロードして URL を教えて」 → poi_upload({ path: "./site.zip" })

• 「この HTML を page.html として公開して」 → poi_upload({ content: "<h1>hi</h1>", filename: "page.html" })

• 「9KwR7jgeDfPr を手元にダウンロードして」 → poi_download({ slug: "9KwR7jgeDfPr" })（Markdown サイトは .md、それ以外は .zip を保存）

• 「このライセンスキーがまだ有効か確認して」 → poi_check_license({ key: "LIC-XXXX-XXXX-XXXX-XXXX" }) → { valid, expires_at, days_left, ... }

• 「9KwR7jgeDfPr のコメントを一覧して」 → poi_list_comments({ slug: "9KwR7jgeDfPr" })

• 「9KwR7jgeDfPr に『いいね！』とコメントして」 → poi_post_comment({ slug: "9KwR7jgeDfPr", body: "いいね！" })（author 省略で匿名）

• 「アップロード用の無料キーを取って」 → poi_issue_free_license()（環境変数の発行パスワードを使用）

API キー・発行パスワードは秘密情報です（上記のお試し用発行パスワードは公開前提の例外です）。共有環境では環境変数で渡し、ログや会話に残さないよう注意してください。

公開（メンテナ向け）

npx -y poi-mcp を成立させるには、この mcp/ を npm に公開します。

cd mcp
npm login
npm version patch        # 必要に応じて版を上げる
npm publish --access public

• パッケージ名 poi-mcp が取得済みの場合は、package.json の name をスコープ付き （例 @あなた/poi-mcp）に変え、README とドキュメントの poi-mcp も読み替えてください。

• 公開されるのは files（src と README.md）のみです。node_modules は含まれません。