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 分