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 Quick Start

Get up and running with Nyne MCP in 3 minutes.

What You'll Need

  • A Nyne account with an active subscription
  • API credentials (API Key + Secret)
  • ChatGPT Plus/Pro or Claude Desktop (or any MCP client)

Agent Discovery Links

If an agent is integrating with Nyne without prior context, point it at the machine-readable docs before the HTML pages. That reduces bad endpoint selection and noisy HTML scraping.

llms.txt: https://api.nyne.ai/llms.txt Agent manifest: https://api.nyne.ai/.well-known/nyne-api.json Example endpoint markdown: https://api.nyne.ai/documentation/person/enrichment.md

The hosted MCP in this quickstart is a curated subset focused on common person search, enrichment, and profile-Q&A workflows. For broader endpoint coverage, use the manifest and endpoint markdown docs first.

Setup Steps

Option 1: ChatGPT Setup

  1. Open ChatGPT → Settings → Integrations
  2. Click "Add MCP Server"
  3. Enter URL:
    https://api.nyne.ai/mcp
  4. For authentication, pick OAuth and complete Nyne login. The OAuth endpoints are:
    Authorization URL: https://api.nyne.ai/mcp/oauth/authorize Token URL: https://api.nyne.ai/mcp/oauth/token
  5. If OAuth is unavailable, select No auth for discovery and then choose Bearer token and paste your Nyne API Key to enable tool calls.
  6. Save and test!

Option 2: Claude Desktop Setup

  1. Open/create: ~/.claude/mcp.json
  2. Add this configuration:
    { "mcpServers": { "nyne": { "url": "https://api.nyne.ai/mcp", "headers": { "X-API-Key": "your_api_key", "X-API-Secret": "your_secret" } } } }
  3. Restart Claude Desktop

Test It Out

Try these example queries in your AI assistant:

Search for People

"Find software engineers at Google in Seattle" "Show me CTOs in the fintech industry" "Search for product managers with AI experience"

Get Profile Details

"Get the profile for john@company.com" "Find contact info for linkedin.com/in/janedoe" "Enrich this phone: (415) 555-1234"

Ask AI Questions

"What is this person's current role?" "Does this person have sales experience?" "What companies has this person worked for?"
✅ That's it! Your AI assistant can now search and analyze Nyne's people data directly.

Quick Reference

What Value
Discovery URL https://api.nyne.ai/.well-known/mcp
MCP Endpoint https://api.nyne.ai/mcp
Auth Method OAuth2 (recommended) via /mcp/oauth • Bearer token (API Key) • X-API-Key + X-API-Secret
Protocol Version 2024-11-01

Credits & Pricing

MCP uses the same credit costs as the REST API:

Tool Credit Action Cost
search_people_semantic person_search 4 credits per result
get_person_profile person_enrichment 6 credits per profile
ask_profile person_enrichment 6 credits per query
Note: MCP uses your existing Nyne credits and respects your API rate limits. Credit costs are loaded dynamically from the database and update automatically if changed.

Async Processing

MCP tools process asynchronously (like the REST API):

  1. Tool invocation returns HTTP 202 with a request_id
  2. Poll GET /mcp/status?request_id=xxx every 2-3 seconds
  3. When status is completed, results are included in response
Don't worry - your AI assistant (ChatGPT/Claude) handles polling automatically! You just ask questions naturally and it waits for results.

Need Help?

Full Documentation: MCP Documentation

Email Support: support@nyne.com

Manage API Keys: API Key Management

API Documentation: API Docs