Potarix Enricher

io.github.Potarix由 GitHub 帳號 Potarix 發布v0.1.2更新於 Oct 28, 2026

Find company websites and verified business emails through the Potarix Enricher API.

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取商業與電商

概覽

AI 產生的概覽

Potarix Enricher MCP 伺服器，讓助理查詢公司官網並找出經驗證的商務電子郵件，以預付 API 額度計費。

可以做什麼
  • 把公司名稱解析成官網網址
  • 依姓名、LinkedIn 個人檔案或網域找出決策者的經驗證電子郵件
  • 取得某網域的公司公開電子郵件名單
  • 一次呼叫同時完成官網、決策者與名單查詢
  • 查看目前金鑰的剩餘額度、綁卡狀態與金鑰數量
  • 發起 Stripe 綁卡結帳並購買額度包
適用情境
適合業務開發名單、客戶資料補齊與聯絡人研究，需要助理從付費資料服務取得公司官網或經驗證商務電子郵件時使用，也可讓助理自行加值額度。
執行需求
可使用 api.potarix.com 的遠端 Streamable HTTP 端點，或在本機以 Node.js 執行 npm 套件 potarix-mcp。需要 Potarix API 金鑰：託管服務透過 Authorization Bearer 標頭傳送，stdio 套件則以 POTARIX_API_KEY 環境變數設定。需能連線 Potarix API 與 Stripe 結帳頁面。
安裝前請注意
查詢會消耗付費額度（1 額度 = 0.01 美元，試用帳號初始贈送 25 額度）。topup_credits 會對已儲存的信用卡進行免密扣款，start_checkout 則透過 Stripe 取得卡片。API 金鑰是 ptk_live_ 開頭的正式憑證，須妥善保密。check_balance 會回傳帳號電子郵件、綁卡狀態等資訊。關於個人與公司的查詢會傳送給第三方 API。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Potarix Enricher，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.Potarix%2Fpotarix-mcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "potarix-enricher": {
      "type": "http",
      "url": "https://api.potarix.com/mcp"
    }
  }
}

README

Potarix MCP Server

MCP wrapper for Potarix Enricher. Lets AI agents resolve company websites, find verified emails, and pull complete company rosters — and (with one human-in-the-loop card capture) sign up and pay for credits entirely from the agent.

Tools

toolwhat it doescost
lookup_company_websitecompany name → website URL2 credits
find_person_emailnamed person + company/domain → verified email25 credits
find_decision_maker_emailcategory + domain → likely buyer name + email25 credits
find_linkedin_emailLinkedIn profile URL → verified email10 credits
find_company_emailsdomain → public company contact roster25 credits
find_allone company name → website + DMs + full company email listsum of above
check_balancecredits, email, saved-card status, key countfree
start_checkoutget a Stripe URL to add a card the first timen/a
topup_creditscharge the saved card and add creditsn/a

1 credit = $0.01. Trial accounts start with 25 free credits. Every endpoint floors at the worst-case provider COGS — a hit never loses money, and short-circuited waterfall calls earn margin.

Two ways to connect

transportendpointbest for
Streamable HTTP (hosted)https://api.potarix.com/mcpremote agents (Claude, ChatGPT) — no install
stdio (npm package)npx -y potarix-mcplocal/desktop clients

Both expose the same nine tools. The hosted server is stateless and multi-tenant: every request is authorized by its own Authorization: Bearer ptk_live_... header, so there is no per-user deployment.

Hosted (Streamable HTTP)

Point any MCP client that speaks Streamable HTTP at https://api.potarix.com/mcp and send your key as a bearer token:

jsonc
{  "mcpServers": {    "potarix": {      "url": "https://api.potarix.com/mcp",      "headers": { "Authorization": "Bearer ptk_live_your_key" }    }  }}

Install (stdio)

bash
npm install -g potarix-mcp

Or run it without a global install:

bash
npx -y potarix-mcp

Configure

Set your Potarix API key:

bash
export POTARIX_API_KEY=ptk_live_your_key

Optional:

bash
export POTARIX_API=https://api.potarix.com/enricher

Claude Desktop

json
{  "mcpServers": {    "potarix": {      "command": "npx",      "args": ["-y", "potarix-mcp"],      "env": {        "POTARIX_API_KEY": "ptk_live_your_key"      }    }  }}

Claude Code

bash
claude mcp add potarix npx -- -y potarix-mcp

Then add POTARIX_API_KEY to the environment where Claude Code runs.

Development

bash
npm installnpm run buildnpm run smoke        # stdio transport: connect + tools/list
# Streamable HTTP transport:npm run start:http   # serves on http://127.0.0.1:8080/mcp (set PORT to change)# in another shell:POTARIX_MCP_URL=http://127.0.0.1:8080/mcp npm run smoke:http

Environment variables:

vardefaultpurpose
POTARIX_API_KEY—API key (stdio only; HTTP reads it per-request from the bearer header)
POTARIX_MCP_TRANSPORTstdiohttp to run the Streamable HTTP server (or pass --http)
PORT / HOST8080 / 127.0.0.1HTTP bind address
POTARIX_MCP_PATH/mcpHTTP request path
POTARIX_MCP_ALLOWED_HOSTS—comma-separated host allow-list; enables DNS-rebinding protection
POTARIX_APIhttps://api.potarix.com/enricherAPI base URL override

Registry Publishing

This repo includes server.json for the official MCP Registry. The entry is multi-surface: it declares both the hosted Streamable HTTP remote (https://api.potarix.com/mcp) and the npm stdio package (potarix-mcp), so a single registry record advertises two ways to connect.

The registry validates the npm package by fetching it and checking that its published mcpName matches the server name, so the npm package must be published first, at the same version named in server.json (packages[].version).

Publishing steps (version-bump first, then npm, then registry):

bash
# 1. Bump package.json + server.json to the same new version (e.g. 0.1.3).#    server.json must be a NEW version each publish (versions are immutable).# 2. Build + publish the npm artifact (carries mcpName for ownership proof):npm publish# 3. Push the multi-surface server.json to the official MCP Registry:mcp-publisher login githubmcp-publisher publish

The package mcpName in package.json must match server.json:

text
io.github.Potarix/potarix-mcp

來源：README.md，提交 131b4e9

工具

9

lookup_company_website

Look Up Company Website

Find the best website URL for a company name. Uses Potarix Enricher API credits.

輸入參數contextcompany_name必填

find_person_email

Find Person Email

Find a verified email for a named person at a company or domain. Uses Potarix Enricher API credits.

輸入參數domainfull_namelast_namefirst_namecompany_name

find_decision_maker_email

Find Decision Maker Email

Find a likely decision maker and verified email for a domain. Uses Potarix Enricher API credits.

輸入參數domain必填category必填

find_linkedin_email

Find LinkedIn Email

Find a verified email from a LinkedIn profile URL. Uses Potarix Enricher API credits.

輸入參數linkedin_url必填

find_company_emails

Find Company Emails

Find public company email contacts for a domain. Uses Potarix Enricher API credits.

輸入參數domain必填

find_all

Find All Company Data

Kitchen-sink: resolve a company's website, find decision-maker emails for the categories you request, and pull the company-wide email roster — all in one call. Pricing is the sum of underlying sub-calls; see /find-all docs. Uses Potarix Enricher API credits.

輸入參數contextcompany_name必填dm_categoriesskip_company_emails

check_balance

Check Potarix Balance

Show the calling key's profile: email, credits remaining, total purchased, whether a card is on file, and how many active API keys exist. Free — does not consume credits.

無需輸入參數。

topup_credits

Top Up Potarix Credits

Buy a credit pack. Charges the saved card off-session if one is on file (returns immediately on success). If no card is saved yet, run `start_checkout` first to capture one.

輸入參數tier_key必填

start_checkout

Start Potarix Checkout (one-time card capture)

Return a Stripe Checkout URL the human clicks once to add a card. After the human completes checkout, future `topup_credits` calls are silent off-session charges. Hand the returned `url` to the user, do not try to follow it yourself.

輸入參數tier_key必填

版本歷史

1
  1. v0.1.2最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分