Tool Reference
Every PowerNames MCP tool, its parameters, and what it returns — grouped by projects, availability, scoring, linguistics, risk, and utilities.
Every tool is called with tools/call and returns its payload as JSON text. Parameters marked required must be supplied; the rest are optional.
Two conventions run through the whole surface:
- Project context. A name candidate lives inside a project. Analysis, availability, risk, and comparison tools need the candidate's
name_id(and usually itsproject_id), which you get fromcreate_projectandadd_names. - Credits. Tools that run an analysis or reach an external service spend account credits; reads are free. Credit-spending tools are flagged ⚡ below.
Projects & names
Set up and read the workspace: projects, candidates, and their status.
| Tool | Parameters | Description |
|---|---|---|
list_projects | (none) | List all naming projects for the team. |
create_project | name (required), description, industry_category, target_audience | Create a project. Returns project_id and public_id. |
get_project | projectId (required) | Get one project with its brief. brief is null until one exists. |
add_names | project_id (required), names (required, 1–100) | Add candidate names to a project. Deduplicates against existing names; returns counts and the created rows. |
list_names | project_id (required), status (new | shortlisted | rejected | selected) | List candidates with their scores and status. |
get_name | nameId (required) | Get one candidate with its rating and note. |
compare_names | project_id (required), name_ids (2–10) | Side-by-side scores, availability, and risk for the given candidates. Omitting name_ids compares every name in the project. |
shortlist_name | name_id (required) | Set a candidate's status to shortlisted. |
Availability
Check whether the domains and social handles for a name are free.
| Tool | Parameters | Description |
|---|---|---|
check_name_availability | name (required), tlds, platforms, project_id, name_id | Check domains and socials for a brand name. With no project_id/name_id it runs a quick, un-persisted check. ⚡ With both supplied it runs and persists a full check against the candidate. Default TLDs: .com .io .co .ai .dev. Default platforms: github npm twitter instagram. |
check_single_domain ⚡ | name (required), tld (required), project_id (required), name_id (required) | Check one name + TLD combination and persist the result. |
check_single_social ⚡ | name (required), platform (required), project_id (required), name_id (required) | Check one social platform for a candidate and persist the result. |
get_availability | nameId (required) | Read the stored domain and social availability for a candidate. Returns an empty list if nothing has been checked yet — run a check rather than treating it as an error. |
Scoring
PowerNames scores names on the SMILE (strengths) and SCRATCH (penalties) frameworks.
| Tool | Parameters | Description |
|---|---|---|
score_name ⚡ | name_id (required), project_id (required) | Compute and persist the SMILE/SCRATCH score for a candidate. |
get_score_breakdown | name_id (required) | Read the full score breakdown: SMILE/SCRATCH dimension scores and component details. |
rate_name | name_id (required), rating (required, 1–10) | Record a manual human rating (1 = worst, 10 = best). |
Linguistics
Understand what a name means and how it behaves across languages.
| Tool | Parameters | Description |
|---|---|---|
analyze_linguistics ⚡ | name_id (required), project_id (required), name (required) | Run a full linguistic analysis: phonetics, morphology, etymology, meaning, cultural origin, and cross-linguistic screening. |
get_name_meaning | name_id (required) | Read the stored semantic meaning and etymology for a candidate. |
Risk & brand
Screen for reputational, cultural, trademark, and copycat risk.
| Tool | Parameters | Description |
|---|---|---|
check_global_risk ⚡ | name_id (required), project_id (required), name (required) | Run a global risk assessment — negative associations, offensive meanings, and cultural risks across regions and languages. |
check_trademark ⚡ | name_id (required), project_id (required), name (required), classes (1–45) | Check for trademark conflicts across NICE classification classes. Defaults to classes relevant to the project's industry. |
check_brand_similarity | name (required) | Compare a name to known brands using Jaro-Winkler string distance and Double Metaphone phonetic matching. Returns top matches and a copycat score. |
Full pipeline
Run everything for a candidate in one call and poll for the result.
| Tool | Parameters | Description |
|---|---|---|
run_full_analysis ⚡ | name_id (required), project_id (required), name (required) | Kick off availability, scoring, and linguistics together. Returns immediately with a run_id. |
get_analysis_status | run_id (required) | Poll a run. Returns queued, running, completed, or failed. Read the individual results (get_score_breakdown, get_availability, get_name_meaning) once complete. |
Utilities
| Tool | Parameters | Description |
|---|---|---|
undo | auditId (required) | Reverse a previous mutation using its audit-log id. Only actions recorded as undoable can be reversed — analyses and anything that spent credits or called an external service cannot. |
read_skill | skill (required) — naming-methodology | Read an on-demand PowerNames methodology guide before doing specialized work. |
Mutating tools return an auditId alongside their result; hand it straight to undo to reverse the change.
Reference resources
Beyond tools, the server exposes read-only resources describing the supported social platforms and the country/language lists used by availability and risk checks. MCP clients can list and read them through the standard resources/list and resources/read methods.
Not exposed on MCP
A few capabilities are deliberately withheld because they can't work — or shouldn't run — under an unattended key:
- Browser-only actions (
view-screen,navigate,fill-form) need a live browser session an MCP client doesn't have. - Sensitive settings reads — team members, invitations, and LLM-provider configuration.
- Privileged operations — all admin, team-management, ownership-transfer, and account-deletion actions.