Potarix Enricher

io.github.PotarixPublished by GitHub account Potarixv0.1.2Updated Oct 28, 2026

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

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingBusiness & Commerce

Overview

AI-generated overview

Potarix Enricher MCP server that lets an assistant resolve company websites and find verified business emails, paid for with prepaid API credits.

What you can do
  • Resolve a company name to its website URL
  • Find verified emails for a named person, a LinkedIn profile, or a likely decision maker at a domain
  • Pull a company-wide public email roster for a domain
  • Run website, decision-maker and roster lookups together in one call
  • Check the calling key's credits, saved-card status and key count
  • Start a Stripe card checkout and buy credit packs
When to use it
Useful for sales prospecting, lead enrichment and contact research where an assistant needs company websites or verified business emails from a paid data provider, including letting the agent top up credits itself.
Requirements
Remote Streamable HTTP endpoint at api.potarix.com, or the npm package potarix-mcp run locally with Node.js. A Potarix API key is required: sent as an Authorization Bearer header for the hosted server, or set in POTARIX_API_KEY for the stdio package. Network access to the Potarix API and Stripe checkout.
Before you install
Lookups consume paid credits (1 credit = $0.01; trial accounts start with 25 free credits). topup_credits charges the saved card off-session without further confirmation, and start_checkout captures a card via Stripe. The API key is a live credential (ptk_live_ prefix) that should be kept secret. check_balance returns account details such as email and card status. Queries about people and companies are sent to a third-party API.

Installation

In SourceWeft

  1. Open Potarix Enricher in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Potarix%2Fpotarix-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "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

Source: README.md at commit 131b4e9

Tools

9

lookup_company_website

Look Up Company Website

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

Parameterscontextcompany_namerequired

find_person_email

Find Person Email

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

Parametersdomainfull_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.

Parametersdomainrequiredcategoryrequired

find_linkedin_email

Find LinkedIn Email

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

Parameterslinkedin_urlrequired

find_company_emails

Find Company Emails

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

Parametersdomainrequired

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.

Parameterscontextcompany_namerequireddm_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.

Takes no parameters.

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.

Parameterstier_keyrequired

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.

Parameterstier_keyrequired

Version history

1
  1. v0.1.2LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts