# DocsMcpToolset

**Kind:** Class

**Source:** [`atloria-monorepo/libs/parser-core/src/techdocs/mcp-toolset.ts`](https://github.com/sherkety/atloria/blob/main/atloria-monorepo/libs/parser-core/src/techdocs/mcp-toolset.ts#L53)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `toolDefinitions` | `toolDefinitions()` | `McpToolDef[]` |
| `call` | `call(name: string, args: Record<string, any>)` | `Promise<unknown>` |
| `searchDocs` | `searchDocs(query: string, limit: undefined)` | `DocSearchHit[]` |
| `readPage` | `readPage(path: string)` | `{ title: string; path: string; markdown: string } | null` |
| `listPages` | `listPages(section: string)` | `Array<{ title: string; path: string; section?: string }>` |
| `getEntity` | `getEntity(nameOrId: string)` | `{ entity: Entity; relationships: Array<{ direction: 'out' | 'in'; type: string; entity: string }>; source?: string } | null` |
| `searchEntities` | `searchEntities(query: string, kind: string)` | `Array<{ id: string; name: string; type: string }>` |
| `listEndpoints` | `listEndpoints(tag: string)` | `Array<{ method: string; path: string; summary: string }>` |
| `askQuestion` | `askQuestion(question: string)` | `Promise<{ answer: string; citations: string[] }>` |
| `callOperation` | `callOperation(args: Record<string, any>)` | `Promise<unknown>` |

## Where it refuses work

- `DocsMcpToolset` stops the work with an early return when `!q`.
- `DocsMcpToolset` stops the work with an early return when `!e`.
- `DocsMcpToolset` stops the work with an early return when `!this.askFn`.
- `DocsMcpToolset` stops the work with an early return when `!this.execFn`.
- `DocsMcpToolset` stops the work with an early return when `!method || !path`.
- `DocsMcpToolset` stops the work with an early return when `i < 0`.