Scans
spiderfoot_scansList and manage all SpiderFoot OSINT reconnaissance scans, both active and completed, to track investigation progress and access collected data.
Instructions
List all scans (past and present).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/index.ts:57-61 (registration)Registers the 'spiderfoot_scans' MCP tool. Includes empty input schema and an inline handler function that calls sf.scans() to list all scans and returns the JSON-stringified result as text content.
server.registerTool( 'spiderfoot_scans', { title: 'Scans', description: 'List all scans (past and present).', inputSchema: {} }, async () => ({ content: [{ type: 'text', text: JSON.stringify(await sf.scans()) }] }) ); - src/spiderfootClient.ts:39-42 (helper)The supporting 'scans()' method in SpiderfootClient class, which performs a GET request to the Spiderfoot API endpoint '/scanlist' to retrieve the list of all scans.
async scans() { const { data } = await this.http.get('/scanlist'); return data; } - src/index-http.ts:41-45 (registration)Identical registration of the 'spiderfoot_scans' tool in the HTTP server variant of the MCP server.
server.registerTool( 'spiderfoot_scans', { title: 'Scans', description: 'List all scans (past and present).', inputSchema: {} }, async () => ({ content: [{ type: 'text', text: JSON.stringify(await sf.scans()) }] }) ); - src/spiderfootClient.ts:92-97 (helper)Factory function to create the SpiderfootClient instance (sf) from environment variables, used by the tool handler.
export function makeSpiderfootClientFromEnv() { const baseUrl = process.env.SPIDERFOOT_BASE_URL || 'http://127.0.0.1:5001'; const username = process.env.SPIDERFOOT_USER; const password = process.env.SPIDERFOOT_PASS; return new SpiderfootClient({ baseUrl, username, password }); }