Jina AI MCP Server

Instructions

Implementation Reference

• index.ts:37-63 (handler)

  The handler function that implements the read_webpage tool. It makes a POST request to Jina AI's reader API (https://r.jina.ai/) with the provided URL and optional parameters, handles headers for additional features, and parses the response using ReaderResponseSchema.

  async function readWebPage(params: z.infer<typeof ReadWebPageSchema>) {
    const headers: Record<string, string> = {
      'Authorization': `Bearer ${JINA_API_KEY}`,
      'Content-Type': 'application/json',
      'Accept': 'application/json'
    };
  
    if (params.with_links) headers['X-With-Links-Summary'] = 'true';
    if (params.with_images) headers['X-With-Images-Summary'] = 'true';
    if (params.with_generated_alt) headers['X-With-Generated-Alt'] = 'true';
    if (params.no_cache) headers['X-No-Cache'] = 'true';
  
    const response = await fetch('https://r.jina.ai/', {
      method: 'POST',
      headers,
      body: JSON.stringify({
        url: params.url,
        options: params.format || 'Default'
      })
    });
  
    if (!response.ok) {
      throw new Error(`Jina AI API error: ${response.statusText}`);
    }
  
    return ReaderResponseSchema.parse(await response.json());
  }

• schemas.ts:35-42 (schema)

  Zod schema defining the input parameters for the read_webpage tool: required URL and optional flags for format, links, images, alt text generation, and cache.

  export const ReadWebPageSchema = z.object({
    url: z.string(),
    format: z.enum(['Default', 'Markdown', 'HTML', 'Text', 'Screenshot', 'Pageshot']).optional(),
    with_links: z.boolean().optional(),
    with_images: z.boolean().optional(),
    with_generated_alt: z.boolean().optional(),
    no_cache: z.boolean().optional()
  });

• index.ts:113-117 (registration)

  Registration of the read_webpage tool in the MCP server's list tools handler. Specifies the tool name, description, and converts the Zod schema to JSON schema for the protocol.

  {
    name: "read_webpage",
    description: "Extract content from a webpage in a format optimized for LLMs",
    inputSchema: zodToJsonSchema(ReadWebPageSchema)
  },