Please Log In

You need to log in to access your API credentials for MCP integration. Start with our free trial!

Log In & Start Free Trial

Nyne MCP Server

Connect AI assistants like ChatGPT and Claude directly to Nyne's people data workflows using the Model Context Protocol (MCP).

Model Context Protocol (MCP) is an open standard that enables AI assistants to securely connect to external data sources and tools. Think of it as a universal plugin system for AI.

The hosted Nyne MCP Server brings Nyne's common people search and enrichment workflows directly into your AI assistant conversations. Ask questions in natural language, and get instant access to:

🔍 People Search

Semantic search across millions of profiles by company, role, location, or keywords. Build targeted contact lists instantly.

👤 Profile Enrichment

Get comprehensive person profiles with contact information, work history, education, and social profiles.

🤖 AI-Powered Insights

Ask natural language questions about profiles and get intelligent analysis powered by Nyne's data.

Why Use Nyne MCP?

⚡ Instant Access

No code required. Connect once and query Nyne data directly from ChatGPT or Claude conversations.

🔒 Secure

Uses your existing Nyne API credentials. All requests are authenticated and logged for security.

💬 Natural Language

Ask questions in plain English. The AI assistant handles the technical details.

🎯 Accurate

Get real-time data from Nyne's people intelligence workflows without writing integration code.

📊 Comprehensive

For full HTTP API coverage, start with llms.txt and the agent manifest. The hosted MCP is a curated subset.

💰 Cost-Effective

Uses your existing Nyne subscription and credit balance. No additional fees.

Coverage

The hosted MCP currently exposes a curated subset of Nyne workflows: people search, person profile fetch/enrichment, and profile Q&A. If an agent needs the broader endpoint surface, use the HTTP API docs via llms.txt and the agent manifest, then load the endpoint's markdown page.

Available Tools

search_people_semantic

Search for people by company, role, location, or keywords. Perfect for lead generation and talent discovery.
  • Search by company name and role
  • Filter by geography and keywords
  • Up to 100 results per query
  • Requires 'search' product access
  • 4 credits per result
Example:
"Find software engineers at Google in San Francisco"

get_person_profile

Get detailed profile information for a person using email, phone, LinkedIn URL, or profile ID.
  • Lookup by email, phone, or social URL
  • Comprehensive contact information
  • Work history and education
  • Social media profiles
  • Requires 'enrichment' product access
  • 6 credits per profile
Example:
"Get the profile for john@example.com"

ask_profile

Ask AI-powered questions about a person's profile using natural language.
  • Natural language Q&A
  • AI-powered analysis
  • Context-aware answers
  • Synthesizes multiple data points
  • Requires 'enrichment' product access
  • 6 credits per query
Example:
"What is this person's current role and experience?"

How to Get Started

  1. Get Your API Credentials
    Log in to your Nyne account and navigate to Settings → API Keys. If you don't have an API key yet, create one with access to Search and/or Enrichment products.
    You need an active Nyne subscription with Search or Enrichment products to use MCP tools.
  2. Choose Your AI Assistant
    Nyne MCP works with any MCP-compatible AI assistant. See integration guides below for ChatGPT and Claude Desktop.
  3. Connect to Nyne
    Configure your AI assistant with the Nyne MCP endpoint and your API credentials.
  4. Start Asking Questions
    Simply ask your AI assistant to search for people or get profile information. The assistant will automatically use Nyne MCP tools.

Integration Guides

ChatGPT (OpenAI)

  1. Open ChatGPT and go to Settings → Integrations
  2. Click Add MCP Server
  3. Enter the Nyne MCP endpoint:
    https://api.nyne.ai/mcp
  4. When prompted for authentication, choose OAuth (recommended). The flow uses:
    Authorization URL: https://api.nyne.ai/mcp/oauth/authorize Token URL: https://api.nyne.ai/mcp/oauth/token
  5. If OAuth is not available, select No authentication to allow discovery. For tool execution, choose Bearer token and paste your Nyne API Key as the token (or use headers: X-API-Key/X-API-Secret).
  6. Click Save. ChatGPT will discover Nyne tools from the manifest.

Claude Desktop

  1. Open or create the MCP configuration file at ~/.claude/mcp.json
  2. Add Nyne to your configuration:
    { "mcpServers": { "nyne": { "url": "https://api.nyne.ai/mcp", "headers": { "X-API-Key": "your_nyne_api_key", "X-API-Secret": "your_nyne_api_secret" } } } }
  3. Restart Claude Desktop. Nyne tools will now be available.

Other MCP Clients

Any MCP-compatible client can connect to Nyne. Use these details:

  • Discovery Endpoint: https://api.nyne.ai/.well-known/mcp
  • MCP Endpoint: https://api.nyne.ai/mcp
  • Authentication: OAuth2 (recommended) via /mcp/oauth/authorize and /mcp/oauth/token; or Bearer token (paste Nyne API Key); or headers X-API-Key + X-API-Secret

Example Queries

Once connected, you can ask your AI assistant questions like:

People Search

  • "Find product managers at Stripe in San Francisco"
  • "Show me software engineers who worked at Facebook"
  • "Search for VPs of Sales in the healthcare industry"
  • "Find people with 'machine learning' experience at Google"

Profile Enrichment

  • "Get the profile for jane.smith@company.com"
  • "Find contact information for the person at linkedin.com/in/johndoe"
  • "Enrich this phone number: (415) 555-1234"

AI-Powered Insights

  • "What is this person's current job title?"
  • "Does this person have experience in B2B sales?"
  • "What companies has this person worked for?"
  • "What is this person's educational background?"
💡 Tip: The AI assistant will automatically choose the best Nyne tool based on your question. You don't need to specify tool names or parameters - just ask naturally!

Pricing & Usage

Nyne MCP uses your existing Nyne subscription and credit balance. MCP tools use the same credit costs as the REST API:

Tool Credit Action Cost Required Product
search_people_semantic person_search 4 credits per result Search
get_person_profile person_enrichment 6 credits per profile Enrichment
ask_profile person_enrichment 6 credits per query Enrichment
💡 Dynamic Pricing: Credit costs are loaded dynamically from the database and displayed above. If you see "See manifest", log in to view current costs. MCP requests count toward your API key's rate limits and monthly quotas, just like regular API calls.

Async Processing & Polling

MCP tools use asynchronous processing (same infrastructure as the REST API):

  1. Initial Request
    POST to /mcp/invoke returns immediately with HTTP 202 and a request_id
  2. Poll for Results
    Use GET /mcp/status?request_id=xxx to check progress
    Poll every 2-3 seconds until status is 'completed' or 'failed'. Maximum processing time is 5 minutes.
  3. Get Results
    When status is 'completed', the response includes full results

Example Polling Flow

# 1. Invoke tool POST /mcp/invoke { "tool": "search_people_semantic", "params": { "company_name": "Google" } } # Response: HTTP 202 { "request_id": "abc123...", "status": "queued", "poll_url": "https://api.nyne.ai/mcp/status?request_id=abc123..." } # 2. Poll for results GET /mcp/status?request_id=abc123... # Response while processing: { "status": "pending", "message": "Processing..." } # Response when complete: { "status": "completed", "results": [...], "completed_at": "2025-10-10T10:30:00Z" }

Security & Privacy

Nyne takes security seriously. Here's how we protect your data:

Authentication

All requests require valid API credentials

Encryption

All data is transmitted over HTTPS/TLS

Access Control

Each API key is tied to a specific user and subscription

Audit Logging

All MCP requests are logged for security and compliance

Rate Limiting

Automatic rate limiting prevents abuse

Product-Based Access

Tools are only available if your subscription includes the required product

⚠️ Important: Never share your API credentials publicly. Treat them like passwords. If you believe your API key has been compromised, revoke it immediately in your Nyne account settings.

Need Help?

Our support team is here to help you integrate and use MCP effectively.

Email Support: support@nyne.com

Sales: sales@nyne.ai

Quick Start Guide: MCP Quick Start

API Documentation: API Docs