Nynch
Nynch, the AI CRM for consultants and fractionals: contacts, deals and relationship intelligence.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http nynch 'https://app.nynch.com/mcp' --header 'Authorization: <Bearer <your Nynch MCP API key>. Create one in Nynch: Settings > Integrations > Claude & AI Assistants. Docs: https://www.nynch.com/developers>'
{
"mcpServers": {
"nynch": {
"type": "http",
"url": "https://app.nynch.com/mcp",
"headers": {
"Authorization": "<Bearer <your Nynch MCP API key>. Create one in Nynch: Settings > Integrations > Claude & AI Assistants. Docs: https://www.nynch.com/developers>"
}
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
Nynch MCP Server
A hosted Model Context Protocol server that gives AI agents full access to Nynch — a relationship-led growth platform for consultants and professional services firms.
47 tools across 5 categories: CRM read, CRM write, relationship intelligence, context query, and multi-agent orchestration.
Endpoint
https://crcrwtjzqzinfzokianr.supabase.co/functions/v1/mcp-server
Transport: JSON-RPC 2.0 over Streamable HTTP. The server is stateless (no session to manage) and negotiates the protocol version with your client — it speaks 2025-11-25, 2025-06-18, and 2025-03-26.
Quick Start
1. Get an API Key
Sign up at nynch.com, then go to Settings → Integrations → Claude & AI Assistants and create an API key.
Scopes:
read— Search, browse, and retrieve dataread-write— Read + create, update, delete recordsadmin— Full access including agent orchestration
2. Configure Your Client
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"nynch": {
"url": "https://crcrwtjzqzinfzokianr.supabase.co/functions/v1/mcp-server",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"nynch": {
"url": "https://crcrwtjzqzinfzokianr.supabase.co/functions/v1/mcp-server",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Python (MCP SDK)
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client
async with streamablehttp_client(
"https://crcrwtjzqzinfzokianr.supabase.co/functions/v1/mcp-server",
headers={"Authorization": "Bearer YOUR_API_KEY"}
) as (read, write, _):
async with ClientSession(read, write) as session:
await session.initialize()
result = await session.call_tool("search_contacts", {"query": "Acme Corp"})
print(result)
3. Start Using Tools
Your AI client discovers available tools automatically. Ask it to search contacts, check your pipeline, create tasks, or analyze relationships.
Tool Catalog
CRM Read (11 tools)
| Tool | Description |
|---|---|
search_contacts | Search contacts by name, company, or tags |
get_contact_context | Full contact context: profile, interactions, activities, notes, network |
search_deals | Search deals by title, stage, or company |
get_deal_context | Full deal context: stakeholders, learnings, coaching actions |
search_deals_by_inactivity | Find stalled deals with no recent activity |
get_pipeline_summary | Pipeline health: stage distribution, at-risk deals, upcoming closes |
get_next_best_actions | AI-powered recommendations for what to do next |
get_who_list | People to reach now, including identified site visitors. Never mention a specific page in outreach |
list_buckets | List all buckets (lists/segments) |
get_bucket_contacts | Get contacts in a specific bucket |
get_bucket_game_queue | Get contacts waiting to be sorted into buckets |
CRM Write (12 tools)
| Tool | Description |
|---|---|
log_interaction | Record a contact interaction (call, email, meeting, note) |
update_deal_stage | Move a deal to a new pipeline stage |
create_task | Create a task linked to a contact or deal |
create_note | Add a note to a contact (supports markdown) |
create_contact | Create a new contact (auto-links to company by domain) |
update_contact | Update fields on an existing contact |
add_contact_to_bucket | Add a contact to a bucket |
create_deal | Create a new deal in the pipeline |
create_company | Create a new company |
delete_contact | Soft-delete a contact (recoverable) |
bulk_delete_contacts | Soft-delete contacts by tag or ID list |
update_commitment | Mark a commitment as completed or update details |
Relationship Intelligence (11 tools)
| Tool | Description |
|---|---|
get_authority_score | Authority score across 6 dimensions |
get_commitments | Commitments with Say/Do tracking and due dates |
get_buying_committee | Stakeholder map: roles, influence, sentiment |
get_contact_signals | Job changes, company changes, buying intent, identified website visits (no page paths) |
get_interaction_history | Full interaction timeline with direction and sentiment |
get_relationship_score | 5-factor relationship strength score |
export_context_briefing | AI-ready context briefing for any contact or deal |
get_relationship_trends | Is engagement growing, stable, or declining? |
get_at_risk_relationships | Contacts with dropping scores or no recent contact |
get_deal_intelligence | Deal health: velocity, stakeholder coverage, risk factors |
get_weekly_briefing | Weekly summary: interactions, changes, recommendations |
Agent Orchestration (8 tools)
| Tool | Description |
|---|---|
register_agent | Register an external agent with capabilities and archetype |
list_agents | List registered agents with status |
agent_heartbeat | Confirm agent liveness |
write_context | Write to the shared agent context store |
read_context | Read from context store (supports prefix wildcards) |
create_handoff | Request another agent to perform a task |
get_handoffs | Get pending handoffs for your agent |
complete_handoff | Mark a handoff as completed or failed |
Context Query (5 tools)
Discover and read bounded slices of Nynch and connected-app context, metadata-first. Read-only — never accepts raw SQL.
| Tool | Description |
|---|---|
list_context_sources | List safe read-only context sources available to you |
search_context_sources | Search context sources by natural-language keyword (metadata only) |
describe_context_source | Describe one source: purpose, columns, filters, limits, availability |
list_context_columns | List selectable columns and allowed filters for one source |
query_context | Read a bounded slice from one source via a constrained query object |
MCP Resources
| URI Template | Description |
|---|---|
nynch://contacts/{id} | Full contact context: profile, score, interactions, network |
nynch://deals/{id} | Deal context: details, stakeholders, coaching actions |
nynch://pipeline/summary | Pipeline health overview |
Agent Orchestration
Nynch supports multi-agent workflows where AI agents register, share context, and hand off tasks:
- Register with a name, capabilities, and archetype (producer, consumer, coordinator, critic)
- Share state via a key-value context store with namespaces and TTLs
- Route tasks by agent name or capability matching
- Track liveness with heartbeats
Rate Limits
- 1,000 requests per hour per API key
Documentation
Full developer documentation: nynch.com/developers
About Nynch
Nynch is a relationship-led growth platform that helps consultants and professional services firms turn relationships into revenue. It combines CRM, relationship intelligence, and AI-powered coaching into a single platform.
License
This repository (documentation and configuration) is released under the MIT License. The Nynch MCP Server itself is a hosted service — no local installation required.
Frequently asked questions
What is Nynch?
Nynch, the AI CRM for consultants and fractionals: contacts, deals and relationship intelligence.
How do I install Nynch?
It runs as a remote server. In Claude Code: claude mcp add --transport http nynch 'https://app.nynch.com/mcp' --header 'Authorization: <Bearer <your Nynch MCP API key>. Create one in Nynch: Settings > Integrations > Claude & AI Assistants. Docs: https://www.nynch.com/developers>'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Nynch need an API key?
Yes. It expects Authorization, which you set in its configuration.
Is Nynch open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Nynch?
It is published by peterod99. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.