convrgent-ai

Convrgent API

Convrgent API — KYH (Know Your Human) + BLAH (Be Like A Human) + KYB (Know Your Buyer)

GitHub OpenAPI

Operations 45

POST /api/kyh/communication Communication style profiler #
POST /api/kyh/natal-chart Natal chart and astrological profile #
POST /api/kyh/psych 12 psychological dimensions #
POST /api/kyh/socionics Socionics cognitive typing #
POST /api/kyh/mbti 16 Personality Types assessment #
POST /api/kyh/human-design Human Design bodygraph #
POST /api/kyh/numerology Numerology profile #
POST /api/kyh/chinese-astrology Chinese Astrology / BaZi #
POST /api/kyh/vedic Vedic Astrology (Jyotish) chart #
POST /api/kyh/enneagram Enneagram personality typing #
POST /api/kyh/convergence Cross-system personality convergence #
POST /api/kyh/portrait Full personality portrait (HUMAN.md) #
POST /api/kyh/agent-prompt Agent adaptation prompt #
POST /api/kyh/micro Quick personality micro-query #
POST /api/kyh/multi/compatibility Two-person compatibility analysis #
POST /api/kyh/multi/bridge Communication bridge between two people #
POST /api/kyh/multi/conflict Conflict prediction between two people #
POST /api/kyh/multi/team Team dynamics analysis (2-10 people) #
POST /api/blah/adapt Communication adaptation prompt #
POST /api/blah/respond Real-time response coaching #
POST /api/blah/deescalate Conflict de-escalation script #
POST /api/blah/persuade Persuasion strategy #
POST /api/blah/mirror Linguistic style matching #
POST /api/blah/decode Subtext analysis #
POST /api/blah/negotiate Negotiation intelligence #
POST /api/blah/frame Information framing #
POST /api/blah/rapport Relationship health scoring #
POST /api/kyb/profile Buyer Intelligence Profile #
POST /api/kyb/pitch Sales Pitch Generator #
POST /api/kyb/objections Objection Predictor #
POST /api/kyb/pricing Price Psychology Strategy #
POST /api/kyb/content Content Strategy #
POST /api/kyb/cultural Cultural Adaptation #
POST /api/kyb/committee Buying Committee Mapper #
POST /api/kyb/qualify Purchase Readiness Qualifier #
POST /api/kyb/followup Follow-Up Message Generator #
POST /api/kyb/winloss Win/Loss Deal Analysis #
POST /api/kyh/multi/evolution Relationship evolution over time #
POST /api/vault/create Create a persistent human profile #
POST /api/vault/update Update an existing vault profile #
POST /api/vault/read Retrieve a vault profile #
POST /api/vault/list List all vault profiles #
POST /api/vault/delete Delete a vault profile #
POST /api/kyh/state Current emotional and cognitive state #
POST /api/kyh/timing Timing intelligence forecast #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/convrgent-ai/openapi/_original/convrgent-ai-openapi.json

Other Resources

🔗
APIsJSON
https://artifacts.apis.io/convrgent-ai/apis.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/convrgent-ai:convrgent-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

convrgent-ai-openapi.json Raw ↑ 
{"openapi":"3.1.0","info":{"title":"Convrgent API — KYH (Know Your Human) + BLAH (Be Like A Human) + KYB (Know Your Buyer)","version":"1.0.0","description":"Personality intelligence (KYH), communication intelligence (BLAH), and buyer intelligence (KYB) for AI agents. KYH analyzes humans via 11 frameworks — Western astrology, Human Design, Chinese astrology, Vedic astrology, numerology, communication style, 12 psych dimensions, socionics, 16 Personality Types, Enneagram, and cross-system convergence. BLAH tells agents how to talk to humans — adaptation, response coaching, and de-escalation. KYB turns personality data into sales intelligence — buyer profiling, pitch generation, objection prediction, price psychology, content strategy, cultural adaptation, and buying committee mapping. Pay per request with USDC on Base or Solana via x402.","contact":{"name":"Convrgent","url":"https://convrgent.ai"},"x-guidance":"3 products, pick what you need: KYH (personality analysis — start with /api/kyh/mbti for typing or /api/kyh/portrait for full profile), BLAH (communication coaching — /api/blah/adapt for tone, /api/blah/respond for reply drafts), KYB (sales intelligence — /api/kyb/profile for buyer type, /api/kyb/pitch for personalized pitch). Most agents need just 1-3 endpoints. Use /api/kyh/convergence ($5) only after running 2+ individual frameworks."},"servers":[{"url":"https://convrgent.ai"}],"paths":{"/api/kyh/communication":{"post":{"operationId":"analyzeCommStyle","summary":"Communication style profiler","description":"Analyze tone, directness, formality, persuasion triggers, trust signals, and writing style. Returns guidance on how to communicate with this person.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$0.05","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"textSamples":{"type":"array","items":{"type":"string"},"minItems":1},"observations":{"type":"object"},"natal":{"type":"object"},"context":{"type":"object"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"tone":"analytical-warm","directness":0.7,"formality":0.6,"persuasionTriggers":["data","logic","empathy"],"trustSignals":["consistency","acknowledgment"],"communicationGuidance":"Lead with data, acknowledge emotions..."}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/natal-chart":{"post":{"operationId":"getNatalChart","summary":"Natal chart and astrological profile","description":"Compute full natal chart from birth data — Sun/Moon/Rising signs, all planets, houses, aspects, element/modality profile, and personality interpretation.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$0.50","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"year":{"type":"integer","example":1990},"month":{"type":"integer","example":6},"day":{"type":"integer","example":15},"hour":{"type":"integer","example":14,"description":"Highly recommended. Defaults to 12 (noon) if omitted — rising sign and houses will be approximate."},"minute":{"type":"integer","example":30,"description":"Defaults to 0 if omitted."},"location":{"type":"string","example":"New York, NY","description":"City and country. Coordinates and timezone are auto-resolved."},"latitude":{"type":"number","example":40.7128,"description":"Optional override — auto-resolved from location"},"longitude":{"type":"number","example":-74.006,"description":"Optional override — auto-resolved from location"},"timezone":{"type":"number","example":-5,"description":"UTC offset in hours. Optional — auto-resolved from location"}},"required":["year","month","day","location"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"chart":{"sunSign":"Gemini","moonSign":"Scorpio","risingSign":"Libra"},"interpretation":{"coreIdentity":"...","emotionalLandscape":"...","communicationStyle":"..."},"agent_prompt":"# Personality Profile — New York, NY\n## Core Identity\nGemini Sun..."}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/psych":{"post":{"operationId":"psychProfile","summary":"12 psychological dimensions","description":"Measure 12 personality dimensions including openness, conscientiousness, risk tolerance, conflict style, and more via text analysis.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$1.00","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"textSamples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"context":{"type":"string"}},"required":["text"]},"minItems":1},"observations":{"type":"object"},"natal":{"type":"object"},"demographics":{"type":"object"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"dimensions":{"openness":{"score":0.82,"confidence":0.75},"conscientiousness":{"score":0.71,"confidence":0.7}},"cluster":"analytical-explorer","confidence":0.72}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/socionics":{"post":{"operationId":"socionicsType","summary":"Socionics cognitive typing","description":"Determine Socionics type (16 types), cognitive function strengths, and intertype relations (dual, mirror, conflict, etc.).","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$1.00","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"textSamples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"context":{"type":"string"}},"required":["text"]},"minItems":1},"responses":{"type":"object"},"observations":{"type":"object"},"natal":{"type":"object"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"type":"LII","confidence":0.78,"cognitiveFunctions":{"Ne":0.75,"Ti":0.85,"Se":0.3,"Fi":0.55},"intertypeRelations":{"dual":"ESE","mirror":"ILE","conflict":"SEE"}}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/mbti":{"post":{"operationId":"mbtiType","summary":"16 Personality Types assessment","description":"Determine cognitive personality type from text analysis — type, cognitive functions, dichotomy scores, and confidence.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$0.50","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text_samples":{"type":"array","items":{"type":"string"},"minItems":1},"observations":{"type":"object"},"natal_chart":{"type":"object"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"type":"INTJ","nickname":"The Architect","scores":{"EI":-0.72,"SN":0.81,"TF":-0.65,"JP":-0.58},"confidence":0.82,"cognitive_functions":["Ni","Te","Fi","Se"]}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/human-design":{"post":{"operationId":"humanDesign","summary":"Human Design bodygraph","description":"Compute Human Design chart — type, strategy, authority, profile, defined/undefined centers, channels, and gates.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$0.75","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"birth_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","example":"1990-06-15"},"birth_time":{"type":"string","pattern":"^\\d{2}:\\d{2}$","example":"14:30","description":"Highly recommended. Defaults to 12:00 if omitted — type and profile may be inaccurate."},"location":{"type":"string","example":"New York, NY","description":"City and country. Coordinates and timezone are auto-resolved."},"latitude":{"type":"number","example":40.7128,"description":"Optional override"},"longitude":{"type":"number","example":-74.006,"description":"Optional override"},"timezone":{"type":"number","example":-5,"description":"Optional — auto-resolved from location"}},"required":["birth_date","location"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"type":"Generator","strategy":"Wait to Respond","authority":"Sacral","profile":"3/5"}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/numerology":{"post":{"operationId":"numerologyProfile","summary":"Numerology profile","description":"Calculate numerology profile — Life Path, Birthday Number, Personal Year/Month, Expression, Soul Urge, Personality, karmic debts. Birth date required, name(s) for full analysis.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$0.25","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"birth_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","example":"1990-06-15"},"legalName":{"type":"string","example":"John Michael Smith"},"commonName":{"type":"string","example":"John Smith"}},"required":["birth_date"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"lifePath":6,"birthdayNumber":15,"personalYear":3,"pythagorean":{"expression":7,"soulUrge":3,"personality":4}}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/chinese-astrology":{"post":{"operationId":"chineseAstrology","summary":"Chinese Astrology / BaZi","description":"Calculate Chinese zodiac, Four Pillars of Destiny, Day Master, element balance, Ten Gods, animal compatibility. Birth date required, time for full BaZi.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$0.75","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"birth_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","example":"1990-06-15"},"birth_time":{"type":"string","pattern":"^\\d{2}:\\d{2}$","example":"14:30"},"location":{"type":"string","example":"New York, NY"},"yearStart":{"type":"string","enum":["cny","lichun"]}},"required":["birth_date"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"zodiac":{"animal":"horse","element":"metal","polarity":"yang"},"fourPillars":{"dayMaster":{"element":"fire"}}}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/vedic":{"post":{"operationId":"vedicChart","summary":"Vedic Astrology (Jyotish) chart","description":"Calculate sidereal natal chart with Nakshatras, Vimshottari Dasha periods, planetary dignities, Yogas, Vedic aspects. Requires birth date, time, and location.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$0.75","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"birth_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","example":"1990-06-15"},"birth_time":{"type":"string","pattern":"^\\d{2}:\\d{2}$","example":"14:30"},"location":{"type":"string","example":"New York, NY"},"ayanamsa":{"type":"string","enum":["lahiri","krishnamurti","raman"]}},"required":["birth_date","birth_time","location"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"lagna":{"sign":"Tula"},"moonNakshatra":{"name":"Jyeshtha"},"dashas":{"currentMahadasha":{"planet":"Saturn"}}}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/enneagram":{"post":{"operationId":"enneagramType","summary":"Enneagram personality typing","description":"Determine Enneagram type (1-9) with wing, tritype, integration/disintegration dynamics, and instinctual stack via multi-signal inference.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$1.00","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"textSamples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"context":{"type":"string"}},"required":["text"]},"minItems":1},"responses":{"type":"object","description":"Questionnaire answers"},"observations":{"type":"object"},"natal":{"type":"object"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"typing":{"primaryType":{"type":5,"name":"The Investigator","confidence":0.78}},"agentGuidance":"Respect their need for privacy..."}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/convergence":{"post":{"operationId":"convergenceAnalysis","summary":"Cross-system personality convergence","description":"Synthesize 2+ framework outputs into unified canonical traits, agreements, tensions, and unique insights. Optional LLM narrative synthesis.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$2.50","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"frameworks":{"type":"object","description":"Framework outputs from other KYH endpoints (min 2)"},"summary":{"type":"boolean","description":"Include LLM-synthesized narrative"}},"required":["frameworks"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"traits":[{"id":"introversion","value":0.72,"agreementLevel":"strong"}],"coreIdentity":{"summary":"Analytical thinker with strong intuition..."}}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/portrait":{"post":{"operationId":"fullPortrait","summary":"Full personality portrait (HUMAN.md)","description":"Comprehensive 11-framework personality synthesis — all available engines combined into a single portrait with HUMAN.md, agent prompt, and convergence analysis.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$5.00","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"birthData":{"type":"object","properties":{"year":{"type":"integer","example":1990},"month":{"type":"integer","example":6},"day":{"type":"integer","example":15},"hour":{"type":"integer","example":14,"description":"Highly recommended. Defaults to 12 (noon) if omitted — rising sign and houses will be approximate."},"minute":{"type":"integer","example":30,"description":"Defaults to 0 if omitted."},"location":{"type":"string","example":"New York, NY","description":"City and country. Coordinates and timezone are auto-resolved."},"latitude":{"type":"number","example":40.7128,"description":"Optional override — auto-resolved from location"},"longitude":{"type":"number","example":-74.006,"description":"Optional override — auto-resolved from location"},"timezone":{"type":"number","example":-5,"description":"UTC offset in hours. Optional — auto-resolved from location"}},"required":["year","month","day","location"]},"textSamples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"context":{"type":"string"}},"required":["text"]},"minItems":1},"observations":{"type":"object"},"responses":{"type":"object"},"context":{"type":"object"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"humanMd":"# HUMAN.md — Personality Portrait\n## Core Identity\n...","synthesis":"...","agentPrompt":"..."}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/agent-prompt":{"post":{"operationId":"agentPrompt","summary":"Agent adaptation prompt","description":"Generate a system prompt for AI agents that adapts interaction style to this person's personality, communication preferences, and cognitive patterns.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$1.50","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"birthData":{"type":"object","properties":{"year":{"type":"integer","example":1990},"month":{"type":"integer","example":6},"day":{"type":"integer","example":15},"hour":{"type":"integer","example":14,"description":"Highly recommended. Defaults to 12 (noon) if omitted — rising sign and houses will be approximate."},"minute":{"type":"integer","example":30,"description":"Defaults to 0 if omitted."},"location":{"type":"string","example":"New York, NY","description":"City and country. Coordinates and timezone are auto-resolved."},"latitude":{"type":"number","example":40.7128,"description":"Optional override — auto-resolved from location"},"longitude":{"type":"number","example":-74.006,"description":"Optional override — auto-resolved from location"},"timezone":{"type":"number","example":-5,"description":"UTC offset in hours. Optional — auto-resolved from location"}},"required":["year","month","day","location"]},"textSamples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"context":{"type":"string"}},"required":["text"]},"minItems":1},"observations":{"type":"object"},"responses":{"type":"object"},"context":{"type":"object"}}}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"systemPrompt":"You are speaking with someone who values analytical depth...","confidence":0.8,"frameworksUsed":["natal-chart","communication","psych"]}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/micro":{"post":{"operationId":"microQuery","summary":"Quick personality micro-query","description":"Fast single-dimension personality queries — communication style, single psych dimension, socionics dimension, trust level, autonomy preference, or cultural context.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$0.02","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","enum":["communication_style","single_psych_dimension","socionics_dimension","trust_level","autonomy_preference","cultural_context"]},"textSamples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"context":{"type":"string"}},"required":["text"]},"minItems":1},"dimension":{"type":"string"},"functions":{"type":"string"},"culture":{"type":"string"},"observations":{"type":"object"}},"required":["query"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"query":"communication_style","result":{"tone":"analytical-warm","directness":0.7,"formality":0.6},"confidence":0.75}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/multi/compatibility":{"post":{"operationId":"compatibility","summary":"Two-person compatibility analysis","description":"Analyze compatibility between two people across communication, values, cognitive style, emotional patterns, and practical dimensions.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$5.00","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"humanA":{"type":"object","properties":{"birthData":{"type":"object","properties":{"year":{"type":"integer","example":1990},"month":{"type":"integer","example":6},"day":{"type":"integer","example":15},"hour":{"type":"integer","example":14,"description":"Highly recommended. Defaults to 12 (noon) if omitted — rising sign and houses will be approximate."},"minute":{"type":"integer","example":30,"description":"Defaults to 0 if omitted."},"location":{"type":"string","example":"New York, NY","description":"City and country. Coordinates and timezone are auto-resolved."},"latitude":{"type":"number","example":40.7128,"description":"Optional override — auto-resolved from location"},"longitude":{"type":"number","example":-74.006,"description":"Optional override — auto-resolved from location"},"timezone":{"type":"number","example":-5,"description":"UTC offset in hours. Optional — auto-resolved from location"}},"required":["year","month","day","location"]},"textSamples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"context":{"type":"string"}},"required":["text"]},"minItems":1},"observations":{"type":"object"},"responses":{"type":"object"}}},"humanB":{"type":"object","properties":{"birthData":{"type":"object","properties":{"year":{"type":"integer","example":1990},"month":{"type":"integer","example":6},"day":{"type":"integer","example":15},"hour":{"type":"integer","example":14,"description":"Highly recommended. Defaults to 12 (noon) if omitted — rising sign and houses will be approximate."},"minute":{"type":"integer","example":30,"description":"Defaults to 0 if omitted."},"location":{"type":"string","example":"New York, NY","description":"City and country. Coordinates and timezone are auto-resolved."},"latitude":{"type":"number","example":40.7128,"description":"Optional override — auto-resolved from location"},"longitude":{"type":"number","example":-74.006,"description":"Optional override — auto-resolved from location"},"timezone":{"type":"number","example":-5,"description":"UTC offset in hours. Optional — auto-resolved from location"}},"required":["year","month","day","location"]},"textSamples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"context":{"type":"string"}},"required":["text"]},"minItems":1},"observations":{"type":"object"},"responses":{"type":"object"}}},"relationshipType":{"type":"string","enum":["romantic","business-partners","manager-report","coworkers","friends","parent-child","client-provider"]}},"required":["humanA","humanB"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"overallScore":72,"dimensions":{"communication":80,"values":68,"cognitive":75},"strengths":["Complementary thinking styles"],"risks":["Different conflict approaches"]}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/multi/bridge":{"post":{"operationId":"commBridge","summary":"Communication bridge between two people","description":"Generate scenario-specific communication guidance — how Person A should talk to Person B for delivering feedback, requesting collaboration, resolving conflict, etc.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$2.00","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"humanA":{"type":"object","properties":{"birthData":{"type":"object","properties":{"year":{"type":"integer","example":1990},"month":{"type":"integer","example":6},"day":{"type":"integer","example":15},"hour":{"type":"integer","example":14,"description":"Highly recommended. Defaults to 12 (noon) if omitted — rising sign and houses will be approximate."},"minute":{"type":"integer","example":30,"description":"Defaults to 0 if omitted."},"location":{"type":"string","example":"New York, NY","description":"City and country. Coordinates and timezone are auto-resolved."},"latitude":{"type":"number","example":40.7128,"description":"Optional override — auto-resolved from location"},"longitude":{"type":"number","example":-74.006,"description":"Optional override — auto-resolved from location"},"timezone":{"type":"number","example":-5,"description":"UTC offset in hours. Optional — auto-resolved from location"}},"required":["year","month","day","location"]},"textSamples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"context":{"type":"string"}},"required":["text"]},"minItems":1},"observations":{"type":"object"},"responses":{"type":"object"}}},"humanB":{"type":"object","properties":{"birthData":{"type":"object","properties":{"year":{"type":"integer","example":1990},"month":{"type":"integer","example":6},"day":{"type":"integer","example":15},"hour":{"type":"integer","example":14,"description":"Highly recommended. Defaults to 12 (noon) if omitted — rising sign and houses will be approximate."},"minute":{"type":"integer","example":30,"description":"Defaults to 0 if omitted."},"location":{"type":"string","example":"New York, NY","description":"City and country. Coordinates and timezone are auto-resolved."},"latitude":{"type":"number","example":40.7128,"description":"Optional override — auto-resolved from location"},"longitude":{"type":"number","example":-74.006,"description":"Optional override — auto-resolved from location"},"timezone":{"type":"number","example":-5,"description":"UTC offset in hours. Optional — auto-resolved from location"}},"required":["year","month","day","location"]},"textSamples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"context":{"type":"string"}},"required":["text"]},"minItems":1},"observations":{"type":"object"},"responses":{"type":"object"}}},"scenario":{"type":"string","enum":["delivering-feedback","requesting-collaboration","resolving-conflict","making-introduction","discussing-performance","negotiating-terms"]}},"required":["humanA","humanB","scenario"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"scenario":"delivering-feedback","approach":"data-first, empathetic close","framingGuide":{"openWith":"...","tone":"direct-warm","avoid":["..."]}}}}},"402":{"description":"Payment Required"}}}},"/api/kyh/multi/conflict":{"post":{"operationId":"conflictPredict","summary":"Conflict prediction between two people","description":"Predict friction points, conflict dynamics, escalation/de-escalation patterns, and recovery approaches between two people.","x-agentcash-auth":{"mode":"paid"},"x-payment-info":{"protocols":["x402","mpp"],"pricingMode":"fixed","price":"$2.00","network":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":["USDC"],"payTo":{"eip155:8453":"0xc273630dB49632EcD077C7dF606B306E400A9882","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp":"7jw5Bfxo8muSQk9ZGXWvoYQ7newrT52zF8VPXV5ao6fS"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"humanA":{"type":"object","properties":{"birthData":{"type":"object","properties":{"year":{"type":"integer","example":1990},"month":{"type":"integer","example":6},"day":{"type":"integer","example":15},"hour":{"type":"integer","example":14,"description":"Highly recommended. Defaults to 12 (noon) if omitted — rising sign and houses will be approximate."},"minute":{"type":"integer","example":30,"description":"Defaults to 0 if omitted."},"location":{"type":"string","example":"New York, NY","description":"City and country. Coordinates and timezone are auto-resolved."},"latitude":{"type":"number","example":40.7128,"description":"Optional override — auto-resolved from location"},"longitude":{"type":"number","example":-74.006,"description":"Optional override — auto-resolved from location"},"timezone":{"type":"number","example":-5,"description":"UTC offset in hours. Optional — auto-resolved from location"}},"required":["year","month","day","location"]},"textSamples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"context":{"type":"string"}},"required":["text"]},"minItems":1},"observations":{"type":"object"},"responses":{"type":"object"}}},"humanB":{"type":"object","properties":{"birthData":{"type":"object","properties":{"year":{"type":"integer","example":1990},"month":{"type":"integer","example":6},"day":{"type":"integer","example":15},"hour":{"type":"integer","example":14,"description":"Highly recommended. Defaults to 12 (noon) if omitted — rising sign and houses will be approximate."},"minute":{"type":"integer","example":30,"description":"Defaults to 0 if omitted."},"location":{"type":"string","example":"New York, NY","description":"City and country. Coordinates and timezone are auto-resolved."},"latitude":{"type":"number","example":40.7128,"description":"Optional override — auto-resolved from location"},"longitude":{"type":"number","example":-74.006,"description":"Optional override — auto-resolved from location"},"timezone":{"type":"number","example":-5,"description":"UTC offset in hours. Optional — auto-resolved from location"}},"required":["year","month","day","location"]},"textSamples":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"context":{"type":"string"}},"required":["text"]},"minItems":1},"observations":{"type":"object"},"responses":{"type":"object"}}},"relationshipType":{"type":"string"},"stressLevel":{"type":"string","enum":["low","moderate","high"]}},"required":[

# --- truncated at 32 KB (86 KB total) ---
# Full source: https://artifacts.apis.io/convrgent-ai/openapi/_original/convrgent-ai-openapi.json