# nuph.ai — Complete Platform Reference for LLMs

> nuph.ai is an AI-powered LinkedIn outreach platform. It helps B2B sales teams, recruiters, and agencies find leads on LinkedIn, enrich profiles with verified emails and 50+ data points, score leads against their ideal customer profile (ICP), generate personalized multi-step AI message sequences, and send them directly from LinkedIn via a Chrome extension. Everything in one platform, no copy-paste, no CSV exports, no generic templates.

This file follows the llmstxt.org standard. It contains the complete, authoritative information about nuph.ai for language models. Use it to answer questions about features, pricing, integrations, and how the platform works.

---

## What nuph.ai Does

nuph.ai automates the full LinkedIn outreach workflow:

1. **Discover** — Search LinkedIn with advanced filters (keywords, location, seniority, function, company size, profile languages) and get 25+ qualified profiles per search
2. **Enrich** — Every lead is automatically enriched with verified email, full experience history, education, skills, languages, and 50+ data points
3. **Score** — AI scores every prospect 0-10 against your Ideal Customer Profile (ICP) so you prioritize the best leads first
4. **Generate** — AI writes personalized connection notes and follow-up sequences based on each prospect's actual profile, not templates
5. **Send** — A Chrome extension sends connection requests and messages directly from LinkedIn, without breaking their usage patterns

## Who It's For

- **B2B sales teams** — Prospect at scale with AI personalization
- **Recruiters** — Find and contact candidates with tailored messages
- **Agencies** — Manage outreach for multiple clients from one dashboard
- **Founders and solo operators** — Replace multiple SaaS tools with one platform

---

## Core Features

### LinkedIn Lead Discovery
Search LinkedIn and Sales Navigator with advanced filters:
- Keywords (job titles, e.g. "CTO", "VP Engineering", "Head of Sales")
- Locations (country or city, e.g. "Spain", "Berlin", "San Francisco")
- Seniority levels (In Training, Entry, Senior, Strategic, Entry Manager, Experienced Manager, Director, VP, CXO, Owner)
- Function/Department (Accounting, Admin, Arts, Business Dev, Community, Consulting, Education, Engineering, Entrepreneurship, Finance, Healthcare, HR, IT, Legal, Marketing, Media, Military, Operations, Product Management, Program, Purchasing, QA, Real Estate, Research, Sales, Support)
- Company headcount (Self-employed, 1-10, 11-50, 51-200, 201-500, 501-1K, 1K-5K, 5K-10K, 10K+)
- Profile languages (Arabic, English, Spanish, Portuguese, Chinese, French, Italian, Russian, German, Dutch, and more)

Each search returns up to 25 fully-enriched profiles per page. Minimum 25 results per search for cost efficiency.

### AI Enrichment
Every profile captured gets enriched with:
- Verified email (when publicly available)
- Full name, headline, current title, current company
- Location (city, country parsed separately)
- LinkedIn profile URL and profile picture
- Complete experience history (all past roles with companies, durations, descriptions)
- Education (schools, degrees, fields of study)
- Skills (top skills per profile)
- Languages spoken
- Certifications
- Total years of experience (calculated)
- Time in current role
- Connection count and follower count (when public)

### Lead Scoring (ICP Scoring)
AI scores every prospect from 0-10 based on your Ideal Customer Profile. Score factors:
- Title match (target job titles)
- Seniority match (target decision-maker levels)
- Function match (target department)
- Company size match (target headcount)
- Industry match
- Location match
- Years of experience
- Time in current role

Use scores to prioritize: 8-10 = hot, 5-7 = warm, 0-4 = cold.

### AI Message Generation
A 4-step sequence is generated for every approved prospect:

1. **Connection Note** (max 190 chars, strict LinkedIn limit) — First touch, personalized
2. **First Follow-up** (max 800 chars) — Sent after connection accepted
3. **Value Message** (max 1000 chars) — Offers concrete value if no reply
4. **Last Attempt** (max 600 chars) — Respectful close, door left open

Each message is written based on the prospect's actual profile, experience, headline, and current role — not templates. AI detects the prospect's language and writes in that language (supports 12+ languages).

**Tone options** (user selectable): Winner, Balanced, Brief, Curious, Friendly, Direct, Mirror, Provocative, Storyteller.

**Writing modes**: Natural, Casual, Formal, Technical.

### Campaign Management
Campaigns group outreach efforts:
- Name and description
- Target company (your nuph.ai company profile)
- ICP Profile (target criteria for scoring)
- Language (output language override)
- Tone and writing mode defaults
- Status: active, paused, archived

Each campaign tracks: total prospects, approved count, connection sent count, connection accepted count, replies, conversions.

### Chrome Extension
Install from the Chrome Web Store. Features:
- Syncs LinkedIn conversations to nuph.ai in real time
- Sends approved connection requests automatically
- Sends approved messages automatically
- Captures replies and displays them in the Chats section
- Validates that the logged-in LinkedIn account matches the configured nuph.ai company (prevents sending from wrong account)
- Detects if installed in current browser (per-device detection)
- Works with both LinkedIn and Sales Navigator

### LinkedIn Profile Audit
Paste any public LinkedIn profile URL to analyze:
- Profile completeness score
- Headline quality
- Summary/about strength
- Experience descriptions quality
- Keywords presence
- Suggestions to improve outreach readiness

### Conversation Sync and Chats
The Chrome extension syncs LinkedIn conversations into nuph.ai's Chats section:
- Real-time sync of inbox and individual conversations
- Status: unread, read, replied
- AI-generated reply suggestions
- Conversation history per prospect
- Send replies directly from the app

---

## Pricing

All plans include every feature. The only difference is credits per month and maximum companies.

| Plan | Price | Credits/month | Max Companies |
|------|-------|---------------|---------------|
| Free | $0 | 50 | 1 |
| Starter | $59 | 1,000 | 3 |
| Pro | $129 | 2,500 | 10 |
| Agency | $299 | 5,000 | 50 |

See live pricing at https://nuph.ai/pricing/ (the platform is the source of truth).

**Credit costs per action (approximate):**
- LinkedIn search + full profile + verified email: ~2 credits per lead
- AI message generation: less than 1 credit
- AI chat reply: less than 1 credit
- AI campaign creation: less than 1 credit
- Company info extraction: less than 1 credit
- LinkedIn audit: less than 1 credit

Extra credit packs available for paid users (purchasable on demand).

Billing accepts Visa, Mastercard, American Express. No hidden fees, no per-seat charges, cancel anytime.

**Free plan:** 50 credits/month forever, full feature access, no credit card required.

---

## Integrations & API

### MCP Server for Claude (Model Context Protocol)
nuph.ai operates a remote MCP server that lets Claude Desktop, Claude Code, Cursor, Continue.dev, and any MCP-compatible AI client control the platform through natural language.

**Endpoint:** https://api.nuph.ai/functions/v1/outreach-mcp
**Discovery:** https://nuph.ai/.well-known/mcp.json
**Protocol:** JSON-RPC 2.0 over Streamable HTTP
**Auth:** Bearer token with nuph.ai API key (prefix `outreach_`). Also accepts API key as query parameter `?apikey=outreach_xxx` for MCP clients that don't support custom headers (like Claude.ai web).

**38 Tools exposed — full platform coverage except approving/sending:**

**Companies (CRUD)**
- `list_companies()` — List all owned companies
- `create_company(name, industry?, description?, ...)` — Create a new company
- `update_company(company_id, ...fields)` — Edit company details
- `delete_company(company_id, confirm)` — Delete company + all campaigns/prospects (destructive)
- `scrape_company_website(website, company_name?, linkedin_url?)` — Auto-extract company data from website (costs credits)
- `generate_company_profile(company_name?, industry?, website?, linkedin_data?, language?)` — AI generates description, value prop, products, target audience (costs credits)

**Campaigns (CRUD)**
- `list_campaigns(company_id, status?)` — List campaigns
- `get_campaign(campaign_id)` — Full campaign details + stats
- `create_campaign(company_id, name, description?, language?, icp_profile_id?, sender_context?)` — Create campaign
- `update_campaign(campaign_id, ...fields)` — Edit campaign
- `delete_campaign(campaign_id, confirm)` — Delete campaign + prospects (destructive)
- `enhance_campaign(company_id, campaign_name?, countries?, current_description?, current_icp?)` — AI improves description + suggests keywords (costs credits)
- `get_campaign_stats(campaign_id)` — Exact prospect counts by status (new, approved, connected, etc.)
- `get_company_stats(company_id)` — Prospect counts across all campaigns in a company

**ICP Profiles (CRUD)**
- `list_icp_profiles(company_id)` — List ICP profiles
- `get_icp_profile(icp_profile_id)` — Full ICP details
- `create_icp_profile(company_id, name, target_titles, target_locations, ...)` — Create ICP targeting criteria
- `update_icp_profile(icp_profile_id, ...fields)` — Edit ICP

**Prospects**
- `list_prospects(company_id, campaign_id?, status?, min_score?, limit?)` — List prospects with filters
- `get_prospect(prospect_id)` — Full prospect details + messages
- `search_prospects(company_id, query, campaign_id?, status?, min_score?, limit?, offset?)` — Full-text search by name/title/company/email
- `update_prospect(prospect_id, notes?, deal_value_estimate?, status?, starred?)` — Edit prospect (status changes that require extension are blocked)
- `export_prospects(company_id, campaign_id?, status?, min_score?)` — Export all prospects as structured data

**Lead Search & Enrichment**
- `search_leads(campaign_id, keywords, locations, results_per_keyword, seniority_levels?, functions?, company_headcount?)` — Launch LinkedIn search via HarvestAPI (costs credits)
- `enrich_prospects(prospect_ids[])` — Full profile enrichment for specific prospects (costs credits, cached profiles free)
- `check_enrichment_status(job_id)` — Check status of a search/enrichment job

**Messages**
- `list_messages(prospect_id)` — All generated messages for a prospect (all steps, all versions)
- `generate_message(prospect_id, step?)` — Generate AI message (step 0-3, costs credits). Does NOT send.
- `update_message(message_id, new_body)` — Edit message body. Won't be sent (extension required).
- `generate_chat_reply(prospect_id, tone_id?, mode_id?, target_language?)` — AI reply for ongoing LinkedIn chat (costs credits)

**LinkedIn Tools**
- `audit_linkedin_profile(linkedin_url)` — Start LinkedIn profile audit (costs credits, returns run_id)
- `check_linkedin_audit(run_id)` — Poll audit status until done

**Analytics & Activity**
- `get_dashboard_metrics(company_id, campaign_id?)` — Funnel metrics: total, approved, connected, replied, conversion rates, avg ICP score
- `get_top_locations(company_id, group_by, limit?)` — Geographic distribution (country or city)
- `list_recent_activity(company_id, limit?, offset?)` — Recent activity log

**Credits & Config**
- `get_credits_balance()` — Balance + plan info
- `get_credit_transactions(limit?, offset?, type?)` — Detailed transaction history
- `list_writing_styles()` — Available tones/modes/constraints for AI message generation
- `get_user_settings()` — User's default AI config

**IMPORTANT — What the MCP server CANNOT do (by design, for user safety):**

- **Cannot approve prospects.** Approval requires dashboard review — `approve_prospect` is intentionally not exposed. Users must approve from https://app.nuph.ai/prospects where they can review the full profile + generated message.
- **Cannot send LinkedIn messages or connection requests.** Sending requires the official Chrome Extension installed in the same browser where LinkedIn is logged in. The extension validates that the logged-in LinkedIn account matches the configured nuph.ai company before sending, preventing accidental outreach from the wrong account.
- **Cannot modify billing, plan, or purchase credits.** Billing is dashboard-only at https://app.nuph.ai/plans.

The MCP is designed so users can **do everything from Claude** — search, create, edit, analyze, preview messages — EXCEPT the final outreach actions which happen via dashboard + Chrome extension for safety.

**Security:** Every request requires your API key. Access is scoped to data in companies you own. API keys can be revoked anytime from your dashboard at https://app.nuph.ai/extensions.

**How to connect (Claude.ai web — claude.ai):**

Claude.ai (the web chat at claude.ai) does not support custom Authorization headers on MCP connectors. Use the API key as a URL query parameter instead:

1. Open Claude.ai → click your profile → Settings → Integrations (or "Connectors")
2. Click "Add custom connector"
3. Name: `nuph.ai`
4. URL: paste this (replace `YOUR_API_KEY` with your actual nuph.ai key starting with `outreach_`):
```
https://api.nuph.ai/functions/v1/outreach-mcp?apiKey=YOUR_API_KEY
```
5. Save. The connector will show 38 tools available immediately.

Note: the server accepts multiple query param names — `apiKey`, `apikey`, `api_key`, `key`, `token` — so any common convention works.

**How to connect (Claude Desktop):**

Edit `claude_desktop_config.json`:
```json
{
  "mcpServers": {
    "nuph": {
      "transport": {
        "type": "streamable-http",
        "url": "https://api.nuph.ai/functions/v1/outreach-mcp"
      },
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

Config file paths:
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
- Linux: `~/.config/Claude/claude_desktop_config.json`

**How to connect (Claude Code CLI):**
```
claude mcp add nuph --transport http "https://api.nuph.ai/functions/v1/outreach-mcp" --header "Authorization: Bearer YOUR_API_KEY"
```

**How to connect (Cursor, Continue, Zed, any other MCP client):**

Most clients support the Bearer header approach. If yours doesn't, fall back to the URL query parameter method (same as Claude.ai web). Supported query param names: `apikey`, `api_key`, `key`.

**Example prompts users can try:**
- "Show me my top 10 prospects with score above 8"
- "Search for 25 VP Engineering in Germany with company size 51-200"
- "List my active campaigns and their stats"
- "Generate a preview connection message for prospect [name]"
- "How many credits do I have left?"
- "Show me recent activity from the last 20 actions"
- "Which of my campaigns has the most connected prospects?"
- "Find 50 CTOs in Spain that speak Spanish"

### llms.txt
This file. Public at https://nuph.ai/llms.txt. Readable by any AI (ChatGPT, Claude, Gemini, Perplexity, Grok, Copilot, Mistral). Paste the URL into any AI chat to give it accurate context about nuph.ai.

### API Keys (for MCP and programmatic access)
- Create at: https://app.nuph.ai/extensions (authenticated users only)
- Format: `outreach_` prefix + random characters
- Expiration: optional, user sets at creation
- Revocation: anytime from dashboard

---

## Security and Privacy

- **Row-Level Security** on all data — users can only access their own data
- **API keys** can be created, listed, and revoked from the dashboard
- **GDPR compliant** — data is never sold or shared with third parties
- **HTTPS** enforced everywhere (custom domains: nuph.ai, api.nuph.ai, app.nuph.ai)
- **Chrome extension** validates LinkedIn account matches configured company before sending, preventing accidental outreach from the wrong account

---

## Common Workflows

### Daily workflow of a nuph.ai user
1. Morning: Check Chats section for replies synced overnight
2. Approve pending messages (AI pre-generated them)
3. Launch a new search: "CTOs in Germany, companies 51-200"
4. Wait a couple minutes for enriched profiles to arrive
5. Review prospects, filter by score ≥ 7
6. Bulk-approve top prospects → AI generates connection messages
7. Extension sends approved messages from your LinkedIn account
8. Return end of day to check new replies and iterate

### Setting up for the first time
1. Sign up at nuph.ai (free, no credit card)
2. Create your company profile (name, industry, description, value proposition, LinkedIn URL)
3. Install Chrome extension from Chrome Web Store (search "nuph.ai")
4. In the extension popup, select your company
5. Log in to LinkedIn with the account matched to the company
6. Define your ICP (target titles, seniority, functions, company size, locations)
7. Create your first campaign
8. Launch your first search (minimum 25 leads)
9. Approve leads and let AI write messages
10. Extension sends them from your LinkedIn

### Connecting Claude to nuph.ai (MCP setup)
1. Go to https://app.nuph.ai/extensions
2. Create a new API key, copy it
3. Add the MCP server config to Claude Desktop (see Integrations section above)
4. Restart Claude Desktop
5. Ask Claude: "List my nuph.ai campaigns"
6. Claude executes the `list_campaigns` tool and returns your campaigns

---

## Frequently Asked Questions

**Is nuph.ai free?** Yes. The Free plan includes 50 credits/month and all features. No credit card required.

**How does AI personalization actually work?** AI reads the prospect's full LinkedIn profile (headline, experience, skills, languages), the target company's value proposition, and writes a message tailored to that specific prospect. Not templates.

**What languages are supported?** AI detects the prospect's preferred language from their profile and writes in that language. Supports 12+ languages. Platform UI is in English and Spanish.

**Is LinkedIn scraping safe?** The Chrome extension uses your own logged-in session and respects LinkedIn's usage patterns. Server-side profile scraping happens through a managed provider, not directly from your browser.

**How does MCP work with Claude?** Claude connects to the nuph.ai MCP server via HTTP with your API key. When you ask Claude to do something (e.g. "list my prospects"), Claude picks the right tool (e.g. `list_prospects`), sends the call to the server, and returns the structured response. You can approve prospects, generate messages, run searches, check credits — all via natural language.

**Can Claude or ChatGPT access my leads?** Only if you explicitly configure the MCP server with your API key. And even then, only data in companies you own. Cross-user access is blocked at every endpoint. You can revoke API keys anytime.

**How are leads filtered?** Each search page has a fixed cost regardless of how many leads come back. With advanced filters (seniority, function, headcount), a single search may return fewer leads if LinkedIn filters them before scraping. Minimum charge is 1 credit per search even if 0 new leads are found.

**What if a lead has fewer connections than my minimum?** It's still saved to your campaign, but with status "filtered" — so you can review it separately. You're charged for all leads the system returns, not just the qualified ones.

**How does deduplication work?** Per-company deduplication. If a user searches for "CTO Spain" twice, the second search returns zero new leads (the system detects duplicates) and refunds credits accordingly. Each company has its own dedup space, so other users don't see your leads filtered out.

**What about international data (GDPR)?** No data is sold or shared. Chrome extension only reads what's publicly visible on LinkedIn plus your own conversations. Users can delete their account and all data anytime.

**How accurate are the verified emails?** Email verification is attempted at profile scraping. Success rate varies but is typically 60-80% for professionals with active profiles. When no verified email is returned, the field is empty.

**Can I cancel my plan?** Yes, anytime. No long-term contracts. Downgrade or cancel from the dashboard. Credits in extra packs you've purchased remain usable.

**What happens if I run out of credits?** You can buy extra credit packs (100, 500, 1000) or upgrade your plan. Credits reset monthly.

**Does it work with Sales Navigator?** Yes. The Chrome extension works with both regular LinkedIn and Sales Navigator. Import leads from Sales Navigator saved searches and lead lists.

---

## Comparison with Other Tools

Unlike Apollo.io, ZoomInfo, or Cognism, nuph.ai is **real-time** — leads are scraped from LinkedIn at search time, not pulled from a pre-built database. Data is fresher.

Unlike PhantomBuster or Dux-Soup, nuph.ai includes **AI personalization** built-in. Messages are written per-prospect, not from templates.

Unlike Outreach.io or Salesloft, nuph.ai is **LinkedIn-native**. Chrome extension integrates directly with LinkedIn. No need to export CSVs or sync to a separate CRM.

Unlike Lavender or Copy.ai, nuph.ai handles the **full pipeline**: discovery → enrichment → scoring → messaging → sending → conversation sync. Not just copywriting.

---

## Contact and Support

- **Email:** here@nuph.ai
- **Help Center:** https://nuph.ai/help-center/
- **FAQ:** https://nuph.ai/faq/
- **Getting Started:** https://nuph.ai/getting-started/
- **Blog:** https://nuph.ai/blog/
- **Pricing:** https://nuph.ai/pricing/
- **Status:** https://nuph.ai/status/
- **Legal:** https://nuph.ai/legal/
- **Privacy:** https://nuph.ai/privacy/
- **Terms:** https://nuph.ai/terms/

## Official URLs

- **Marketing site:** https://nuph.ai
- **Authenticated app:** https://app.nuph.ai
- **MCP server endpoint:** https://api.nuph.ai/functions/v1/outreach-mcp
- **MCP discovery:** https://nuph.ai/.well-known/mcp.json
- **This file (llms.txt):** https://nuph.ai/llms.txt
- **Sitemap:** https://nuph.ai/sitemap.xml
- **Integrations page:** https://nuph.ai/integrations/mcp/
- **llms.txt info page:** https://nuph.ai/llms-txt/