How chonwai/askching_agent works
AskChing turns natural-language DeFi research requests into cited MCP results, or into a Grok-synthesized answer. The principal path is agent → MCP tool registration → research operation → live or fixture data source → Graph subgraphs → normalized, provenance-bearing results. Separate capabilities cover comparisons, market analysis, risk scans, trends, and lending/DEX yield discovery. The README documents both stdio and remote HTTP access. Some feature internals were not sampled, so those branches use documented relationships rather than inferred call chains.
Main entry points: tools.ts Research tools · data-source.ts Market data source · yield-data-source.ts Yield data source · loop.ts Grok tool loop
Components 24
Agent interfaces
- Remote MCP API
api/mcp.ts - HTTP transport
packages/mcp-server/src/http.ts - Tool registration
packages/mcp-server/src/register.ts - Stdio server
packages/mcp-server/src/index.ts - Grok tool loop
packages/grok-orchestrator/src/loop.ts - Completion client
packages/grok-orchestrator/src/client.ts
Research operations
- Research tools
packages/mcp-server/src/tools.ts - Market analysis
packages/shared/src/analysis.ts - Comparison logic
packages/shared/src/compare.ts - Trend analysis
packages/shared/src/analysis.ts - Evidence schemas
packages/shared/src/schemas.ts
Market data
- Market data source
packages/shared/src/data-source.ts - Graph Gateway client
packages/shared/src/graph-client.ts - Protocol sources
packages/shared/src/source-config.ts - Metric registry
packages/shared/src/metrics.ts
Yield discovery
- Yield discovery
packages/mcp-server/src/tools.ts - Yield data source
packages/shared/src/yield-data-source.ts - DEX adapters
packages/shared/src/yield-client.ts - DEX source registry
packages/shared/src/yield-sources.ts - Yield fixtures
packages/shared/src/yield-fixtures.ts - Yield rankings
packages/shared/src/yield-discovery.ts
Other components
- MCP client
- Grok or LLM
- The Graph subgraphs
Connections 25
- MCP client → Remote MCP API: sends requests
README.md - Remote MCP API → HTTP transport: routes requests
- HTTP transport → Tool registration: registers tools
packages/mcp-server/src/http.ts - Stdio server → Tool registration: registers tools
packages/mcp-server/src/index.ts - MCP client → Stdio server: uses stdio
README.md - Grok or LLM → Grok tool loop: provides prompt
README.md - Grok tool loop → Completion client: requests completion
packages/grok-orchestrator/src/client.ts - Grok tool loop → Research tools: dispatches calls
packages/grok-orchestrator/src/loop.ts - Tool registration → Research tools: invokes tools
packages/mcp-server/src/register.ts - Research tools → Market data source: fetches observations
packages/mcp-server/src/tools.ts - Research tools → Market analysis: builds findings
- Research tools → Comparison logic: ranks observations
packages/mcp-server/src/tools.ts - Research tools → Trend analysis: analyzes history
- Market analysis → Evidence schemas: validates results
packages/shared/src/analysis.ts - Market data source → Protocol sources: selects protocols
packages/shared/src/data-source.ts - Market data source → Metric registry: resolves metrics
packages/shared/src/data-source.ts - Market data source → Graph Gateway client: queries live data
packages/shared/src/data-source.ts - Graph Gateway client → The Graph subgraphs: queries markets
README.md - Yield discovery → Yield data source: requests opportunities
- Yield data source → DEX adapters: runs adapters
packages/shared/src/yield-data-source.ts - Yield data source → Yield fixtures: uses fixtures
packages/shared/src/yield-data-source.ts - Yield data source → DEX source registry: selects venue
packages/shared/src/yield-data-source.ts - DEX adapters → The Graph subgraphs: queries DEX data
README.md - Yield discovery → Yield rankings: ranks opportunities
- Yield rankings → Evidence schemas: shapes results
packages/shared/src/yield-discovery.ts