SourceSync.ai MCP Server

Instructions

Implementation Reference

• src/sourcesync.ts:390-407 (handler)

  Core handler function in SourceSyncApiClient that performs the actual API call to ingest sitemap content via POST /v1/ingest/sitemap.

  public async ingestSitemap({
    ingestConfig,
  }: Omit<
    SourceSyncIngestSitemapRequest,
    'namespaceId'
  >): Promise<SourceSyncIngestResponse> {
    return this.client
      .url('/v1/ingest/sitemap')
      .json({
        namespaceId: this.namespaceId,
        ingestConfig: {
          ...ingestConfig,
          chunkConfig: SourceSyncApiClient.CHUNK_CONFIG,
        },
      } satisfies SourceSyncIngestSitemapRequest)
      .post()
      .json<SourceSyncIngestResponse>()
  }

• src/index.ts:271-288 (registration)

  MCP tool registration for 'ingestSitemap' using server.tool, which creates a thin wrapper handler delegating to SourceSyncApiClient.ingestSitemap.

  server.tool(
    'ingestSitemap',
    'Ingests content from a website using its sitemap.xml. Supports path filtering and link limits.',
    IngestSitemapSchema.shape,
    async (params) => {
      return safeApiCall(async () => {
        const { namespaceId, ingestConfig, tenantId } = params
  
        // Create a client with the provided parameters
        const client = createClient({ namespaceId, tenantId })
  
        // Direct passthrough to the API
        return await client.ingestSitemap({
          ingestConfig,
        })
      })
    },
  )

• src/schemas.ts:216-230 (schema)

  Zod schema defining input parameters for the ingestSitemap tool, including namespaceId, ingestConfig with sitemap url, limits, paths, metadata, and chunkConfig.

  export const IngestSitemapSchema = z.object({
    namespaceId: namespaceIdSchema.optional(),
    ingestConfig: z.object({
      source: z.literal(SourceSyncIngestionSource.SITEMAP),
      config: z.object({
        url: z.string(),
        maxLinks: z.number().optional(),
        includePaths: z.array(z.string()).optional(),
        excludePaths: z.array(z.string()).optional(),
        metadata: z.record(z.union([z.string(), z.array(z.string())])).optional(),
      }),
      chunkConfig: chunkConfigSchema.optional(),
    }),
    tenantId: tenantIdSchema,
  })

• src/sourcesync.types.ts:429-443 (helper)

  TypeScript type definition for the SourceSyncIngestSitemapRequest used in the API client handler for type safety.

  export type SourceSyncIngestSitemapRequest = {
    namespaceId: string
    ingestConfig: {
      source: SourceSyncIngestionSource.SITEMAP
      config: {
        url: string
        maxLinks?: number
        includePaths?: string[]
        excludePaths?: string[]
        scrapeOptions?: SourceSyncScrapeOptions
        metadata?: Record<string, any>
      }
      chunkConfig?: SourceSyncChunkConfig
    }
  }