MCP Server API

Structured output models for pyfetcher MCP tools.

Purpose:

Provide Pydantic models for MCP tool return values, ensuring LLMs receive well-structured, typed data from every tool call.

class pyfetcher.mcp.models.FetchResult(*, url, final_url, status_code, ok, content_type=None, headers=<factory>, text=None, elapsed_ms, backend)

Structured result from fetching a URL.

Parameters:

• url (str)

• final_url (str)

• status_code (int)

• ok (bool)

• content_type (str | None)

• headers (dict[str, str])

• text (str | None)

• elapsed_ms (float)

• backend (str)

model_config = {}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class pyfetcher.mcp.models.ScrapeResult(*, url, selector, elements=<factory>, count)

Structured result from CSS selector extraction.

Parameters:

• url (str)

• selector (str)

• elements (list[str])

• count (int)

model_config = {}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class pyfetcher.mcp.models.LinkInfo(*, url, text, is_external)

Single extracted link.

Parameters:

• url (str)

• text (str)

• is_external (bool)

model_config = {}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class pyfetcher.mcp.models.LinksResult(*, url, links=<factory>, total, internal, external)

Structured result from link extraction.

Parameters:

• url (str)

• links (list[LinkInfo])

• total (int)

• internal (int)

• external (int)

model_config = {}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class pyfetcher.mcp.models.MetadataResult(*, url, title=None, description=None, canonical_url=None, og_title=None, og_description=None, og_image=None, og_type=None, favicons=<factory>)

Structured result from metadata extraction.

Parameters:

• url (str)

• title (str | None)

• description (str | None)

• canonical_url (str | None)

• og_title (str | None)

• og_description (str | None)

• og_image (str | None)

• og_type (str | None)

• favicons (list[str])

model_config = {}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class pyfetcher.mcp.models.FormInfo(*, action, method, fields=<factory>)

Single extracted form.

Parameters:

• action (str)

• method (str)

• fields (dict[str, str])

model_config = {}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class pyfetcher.mcp.models.FormsResult(*, url, forms=<factory>, count)

Structured result from form extraction.

Parameters:

• url (str)

• forms (list[FormInfo])

• count (int)

model_config = {}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class pyfetcher.mcp.models.TableResult(*, url, selector, rows=<factory>, row_count)

Structured result from table extraction.

Parameters:

• url (str)

• selector (str)

• rows (list[list[str]])

• row_count (int)

model_config = {}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class pyfetcher.mcp.models.RobotsResult(*, url, path, user_agent, allowed, sitemaps=<factory>)

Structured result from robots.txt check.

Parameters:

• url (str)

• path (str)

• user_agent (str)

• allowed (bool)

• sitemaps (list[str])

model_config = {}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class pyfetcher.mcp.models.SitemapResult(*, url, entries=<factory>, count)

Structured result from sitemap parsing.

Parameters:

• url (str)

• entries (list[dict[str, str | None]])

• count (int)

model_config = {}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class pyfetcher.mcp.models.HeadersResult(*, profile, headers=<factory>)

Structured result from header generation.

Parameters:

• profile (str)

• headers (dict[str, str])

model_config = {}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class pyfetcher.mcp.models.ProfileInfo(*, name, browser, platform, mobile)

Browser profile information.

Parameters:

• name (str)

• browser (str)

• platform (str)

• mobile (bool)

model_config = {}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class pyfetcher.mcp.models.ArticleResult(*, url, text=None, markdown=None, title=None)

Structured result from article extraction.

Parameters:

• url (str)

• text (str | None)

• markdown (str | None)

• title (str | None)

model_config = {}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class pyfetcher.mcp.models.DownloadResult(*, url, path, size_bytes, checksum_sha256=None)

Structured result from file download.

Parameters:

• url (str)

• path (str)

• size_bytes (int)

• checksum_sha256 (str | None)

model_config = {}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].