getCIKList
Read-onlyIdempotent
Get CIK numbers for SEC-registered entities. Supports regulatory compliance, financial transactions, and investment research. Optionally limit the number of results.
Instructions
Access a comprehensive database of CIK (Central Index Key) numbers for SEC-registered entities with the FMP CIK List API. This endpoint is essential for businesses, financial professionals, and individuals who need quick access to CIK numbers for regulatory compliance, financial transactions, and investment research.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Optional limit on number of results (default: 1000) |
Implementation Reference
- src/tools/directory.ts:68-97 (handler)The MCP tool registration for 'getCIKList' containing the handler function that calls directoryClient.getCIKList(limit) and returns results as JSON.
server.tool( "getCIKList", "Access a comprehensive database of CIK (Central Index Key) numbers for SEC-registered entities with the FMP CIK List API. This endpoint is essential for businesses, financial professionals, and individuals who need quick access to CIK numbers for regulatory compliance, financial transactions, and investment research.", { limit: z .number() .optional() .describe("Optional limit on number of results (default: 1000)"), }, async ({ limit }) => { try { const results = await directoryClient.getCIKList(limit); return { content: [{ type: "text", text: JSON.stringify(results, null, 2) }], }; } catch (error) { return { content: [ { type: "text", text: `Error: ${ error instanceof Error ? error.message : String(error) }`, }, ], isError: true, }; } } ); - src/api/directory/types.ts:11-14 (schema)The TypeScript interface for CIKEntry, the return type of the getCIKList API call, with fields: cik (string) and companyName (string).
export interface CIKEntry { cik: string; companyName: string; } - src/toolception-adapters/coreModuleAdapters.ts:24-24 (registration)Registration of the directory module (containing getCIKList) via toolception adapter, mapping the 'directory' module to registerDirectoryTools.
directory: createModuleAdapter('directory', registerDirectoryTools), - The DirectoryClient.getCIKList method that calls the FMP API endpoint '/cik-list' with an optional limit parameter, returning Promise<CIKEntry[]>.
async getCIKList( limit?: number, options?: { signal?: AbortSignal; context?: FMPContext; } ): Promise<CIKEntry[]> { return super.get<CIKEntry[]>("/cik-list", { limit }, options); }