Nynch MCP Server
Website: www.nynch.com · Developer docs: www.nynch.com/developers · Endpoint:
https://app.nynch.com/mcp
The official, hosted Model Context Protocol server for Nynch, the AI CRM for consultants and fractionals who win high-value deals based on relationships.
50 tools across 6 categories: CRM read, CRM write, relationship intelligence, firm intelligence, context query, and multi-agent orchestration.
Endpoint```
https://app.nynch.com/mcp
**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`.
> The older endpoint `https://crcrwtjzqzinfzokianr.supabase.co/functions/v1/mcp-server` still answers, but it is deprecated. Use `https://app.nynch.com/mcp` in new configs.
## Quick Start
### Claude (custom connector, OAuth, no API key)
In Claude, open **Settings → Connectors → Add custom connector** and enter `https://app.nynch.com/mcp`. Click **Connect**, sign in with your Nynch account and approve access. Revoke access any time in Nynch under **Settings → Integrations → AI hosts**.
### Other MCP clients (API key)
#### 1. Get an API Key
Sign up at www.nynch.com, then go to **Settings → Integrations → Claude & AI Assistants** and create an API key.
**Scopes:**
- `read` — Search, browse, and retrieve data
- `read-write` — Read + create, update, delete records
- `admin` — Full access including agent orchestration
#### 2. Configure Your Client
##### Claude Desktop
Add to `claude_desktop_config.json`:```json
{
"mcpServers": {
"nynch": {
"url": "https://app.nynch.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Cursor
Add to .cursor/mcp.json:```json
{
"mcpServers": {
"nynch": {
"url": "https://app.nynch.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
##### Python (MCP SDK)```python
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client
async with streamablehttp_client(
"https://app.nynch.com/mcp",
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 |
Firm Intelligence (3 tools)
| Tool | Description |
|---|---|
get_firm_warm_paths |
Who at your firm knows this person or company, ranked by relationship strength. Metadata only, never email content |
find_firm_reachable_people |
People you can reach through a teammate, strongest path first, with the best teammate to ask for an intro |
get_firm_client_outcomes |
Client work the firm has won: value, retainer, owner, primary contact, referrer, totals by currency |
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
- Developer docs: www.nynch.com/developers
- MCP discovery: www.nynch.com/.well-known/mcp
- OpenAPI: www.nynch.com/openapi.json
About Nynch
Nynch is the AI CRM for consultants and fractionals who win high-value deals based on relationships. It remembers relationship context across email, meetings and LinkedIn, and surfaces it when a conversation is worth having.
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.
