Neverbounce Mcp

io.github.mrfentmenPublished by GitHub account mrfentmenv1.0.0Updated Nov 3, 2026

NeverBounce email verification: single checks, bulk jobs and job results.

Overview

AI-generated overview

Wraps the NeverBounce email verification API so an assistant can check single addresses, run bulk jobs and read their results.

What you can do
  • Check one email address and get its result, flags and a suggested correction, plus a strict verdict line for deciding whether to send
  • Confirm a Proof of Email token against its original single-check transaction
  • Create, start, poll and delete bulk verification jobs built from lists already uploaded through the NeverBounce dashboard
  • Page through a finished job's per-email results, or get a per-result tally for a quick health read
  • Download a finished job's payload as JSON or CSV
  • Read account status, remaining verification credits and monthly usage
When to use it
Useful when an assistant has to clean or validate email lists before sending, judge whether a single address is safe to mail, or report on the state of bulk verification jobs already set up in NeverBounce.
Requirements
Runs locally as a stdio process from the npm package neverbounce-mcp, so Node.js is needed. It calls the NeverBounce vendor API, which normally requires that vendor's API key; the manifest declares no environment variables or headers, so check the package's own docs for how the key is supplied. Network access to NeverBounce is required.
Before you install
Bulk job creation only works on lists already uploaded through the NeverBounce dashboard, and starting a job consumes verification credits from the account. The delete tool permanently removes a job. Verification results are sent to NeverBounce, so email addresses leave the machine. The README notes that some packages in this repo still ship tools that answer "Not yet implemented", so confirm the tools work before relying on them.

Installation

In SourceWeft

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

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

awesome-servers

One repo for three families of servers, each subtree keeping its own layout and tooling so it can still be built, run and published on its own.

SubtreeWhat it holdsRun one
mcp/338 TypeScript MCP servers, plus 1107 published packages in published/cd mcp/servers/<slug> && npm install && npm run build
acp/79 Python ACP agentspython3 acp/agents/<name>/agent.py
a2a/37 Python A2A servers plus the shared a2a_kitpython3 a2a/servers/<name>/server.py
watchd/a threshold watcher that runs the feeds between editor sessionspython3 watchd/watchd.py --config conditions.json --loop
site/the published site: registry with search, the public-feed atlas, watchd planshttps://mrfentmen.github.io/awesome-servers/

Most servers read public data with no key of their own; the ones wrapping a vendor API take that vendor's key. Nothing in this repo asks a caller to pay. On 2026-10-17 the licence machinery was removed for good: the per-tool src/license.ts gates are gone from the MCP servers, and the A2A and ACP trees no longer carry the hosted licence-gateway half — the skills that used it now answer with an explicit not-implemented stub. Nothing here asks a caller to pay, and nothing they run is refused with a buy link.

Nothing here is generated: each subtree's README says what its servers read, and every server has its own unit tests (mcp/servers/<slug>/tests, acp/agents/<name>/tests, a2a/servers/<name>/tests) plus a live smoke check (tools/smoke*.py, a2a/tools/smoke_all.py).

Novel and original

Nearly all of this is first-of-its-kind work, not a port of an existing catalogue. Before each server or agent was built, it was checked against the official tool lists (the MCP registries, agentclientprotocol.com's agent list and registry) and a live GitHub search for the same domain, and the research logs record what was found and why it still counted as missing — see mcp/MISSING.md, acp/MISSING.md and a2a/docs/. Highlights:

  • The MCP side holds TypeScript servers, one npm package each, and 1039 published packages under published/; mcp/MISSING.md documents the check that preceded every build: what was searched, what was skipped and why the domain still counted as uncovered.
  • On the ACP side there were zero domain agents before this repo — every agent on the official list was a coding agent. These 79 Python agents are the first non-coding ACP agents, and several use protocol surfaces no other agent uses in production (session/request_permission for dataset reads, fs/write_text_file for a briefing file, session/cancel for a conditional watch, image content blocks, a live SSE push feed), each proved-unused in the wild by search at build time. Two more firsts carry their own proof: the orchestrator is an agent whose feeds are agents — it spawns sibling repo agents as real ACP child processes and merges their answers — and the nyc pack is the first multi-agency city surface.
  • acp/MISSING.md doubles as the public-feed atlas: every keyless feed probed live, with its date, what it answered and whether it still works. The published site renders that table at https://mrfentmen.github.io/awesome-servers/atlas.html.
  • The pattern across all three subtrees is the same thesis: wrap one real, keyless public dataset, answer honestly about what the feed did and did not say, and keep the whole thing small, tested and self-contained.

Publishing

  • MCP servers publish from mcp/servers/<slug> (its own package.json, version and README).
  • ACP and A2A servers are repo-run today (Python, no packaging step).

Built on top of it

Creatures that use this corpus as their world live in the sibling repo mrfentmen/superagents (public, with its own claim-check in MISSING.md):

  • polymath — routes your question to the most fitting agents of this repo, spawns each as a real ACP child process, and merges the answers into one brief with per-row citations; a sibling that fails appears as a named row, never silence. Its registry is a data file and its ranking is deterministic word-scoring, not a model opinion.
  • sentry — one plain sentence ("watch air quality in Denver over 150") becomes a tracked watch: a permission-asked protocol write produces the conditions file this repo's watchd/ obeys unchanged, plus the activation lines. Checks it can author today: air thresholds, quake magnitudes within a radius, river gauges at flood stage.
  • fedora hat guy — the persona agent in his own repo mrfentmen/fedora-hat: says "never miss" and means it — one sentence installs the full crown of watches (air + quakes, gauge-named flood) in one permissioned write, and your other questions are forwarded to the siblings above with every row cited.
  • instink — the instinct agent in his own repo mrfentmen/instink: compiles a skill into a reflex — a matcher plus the answer it fires, with hit/miss counters and honest promotion/demotion. The skill doc stays one step away, never deleted.
  • contextink — the context agent in his own repo mrfentmen/contextink: you say "do this" and it acquires the context from the repo, git, and recent files so you don't have to explain it; asks only the minimal high-information-gain questions when acquisition fails.
  • rewind — the replay agent in his own repo mrfentmen/rewind: replays agent runs and mutates one variable to see what would have happened. Replay + mutate + diff for agent traces.
  • scopink — the scope agent in his own repo mrfentmen/scopink: checks if an action is within the scope of what was asked. Detects scope creep in agent plans.
  • curious — the curiosity agent in his own repo mrfentmen/curious: proactively seeks information it doesn't have. Scans for knowledge gaps, seeks answers, learns facts.
  • bored — the idle agent in his own repo mrfentmen/bored: uses idle time productively. Consolidates memories, explores areas, prepares for tasks.

Point the polymath at a checkout of this repo with AWESOME_SERVERS_HOME=$PWD/awesome-servers and it federates across the two repos live.

Published snapshot (published/)

published/ holds one directory per npm package, byte-for-byte what the registry serves: 1039 packages, every version matching npm latest.

  • published/INDEX.md is generated from the tree by python3 scripts/index-published.py.
  • scripts/sync-published-snapshot.py re-downloads every package from npm; run it only when every local fix has been published, because it overwrites dist/ from the tarballs.
  • One package carries a licence gate (MCP_LICENSE_KEY): @mrfentmen/vg-resource-mcp. Another 495 still ship tools that answer Not yet implemented; published/INDEX.md lists every one of them.
  • Every package links to this repo (mrfentmen/awesome-servers) as its source.

servers/ holds the older per-server source that predates the snapshot. Where the two disagree, published/ is what users actually install.

Source: README.md at commit ee04f93

Tools

12

nb_account_info

Raw NeverBounce account envelope: status, verification credits remaining, monthly usage and limit.

Takes no parameters.

nb_account_usage

Just the credit figures: credits remaining, monthly usage, monthly limit.

Takes no parameters.

nb_verify_email

Verify ONE email address: result (valid / invalid / disposable / catchall / unknown), flags (free provider, role account, disposable host, spamtrap, bounce), and a suggested correction if any.

Parametersemailrequiredtimeout

nb_verify_email_strict

The same verification plus a verdict line computed here: safe (send), risky (catchall/disposable - judge first), dead (do not send), unknown (retry later). For deciding whether an agent should send at all.

Parametersemailrequiredtimeout

nb_poe_confirm

Confirm a Proof of Email (POE) token: pairs the transaction_id and token issued by the POE widget with the original single-check transaction.

Parameterstokenrequiredtransaction_idrequired

nb_job_create

Create a bulk verification job from an email list file or folder that was already uploaded through the NeverBounce dashboard. auto_parse defaults to true; run_sample optionally verifies a sample first.

Parametersjob_nameauto_parserun_sampleemail_filenameemail_list_folder

nb_job_start

Start a created (parsed) bulk verification job.

Parametersjob_idrequired

nb_job_status

Poll the status of a bulk verification job.

Parametersjob_idrequired

nb_job_results

Page through a finished job's per-email results: each row is an email with its verification result and flags.

Parametersjob_idrequiredstart_pageitems_per_page

nb_job_results_summary

One page of a job's results reduced to a per-result tally (valid/invalid/...) plus the query_info totals. For a quick health read of a finished job without pulling every row.

Parametersjob_idrequiredstart_pageitems_per_page

nb_job_download

Get the download payload for a finished job (file_format: json or csv).

Parametersjob_idrequiredfile_format

nb_job_delete

Delete a bulk verification job (destructive for that job only).

Parametersjob_idrequired

Version history

1
  1. v1.0.0LatestOct 29, 2026

Score

80% 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 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.