NoLang MCP Server

Instructions

Implementation Reference

• nolang_mcp/server.py:183-202 (handler)

  The MCP tool handler function that lists user's video settings by calling the NoLang API, mapping responses to VideoSettingSummary models, and returning a paginated ListVideoSettingsResult.
  async def list_video_settings(args: ListVideoSettingsArgs) -> ListVideoSettingsResult: try: response = await nolang_api.list_video_settings(args.page) summaries = [ VideoSettingSummary( video_setting_id=s.video_setting_id, title=s.title, updated_at=s.updated_at, required_fields=s.request_fields if isinstance(s.request_fields, dict) else {}, ) for s in response.results ] return ListVideoSettingsResult( total_settings=response.total_count, page=args.page, has_next=response.has_next, settings=summaries, ) except httpx.HTTPStatusError as e: raise RuntimeError(format_http_error(e)) from e
• nolang_mcp/server.py:179-182 (registration)

  Registration of the 'list_video_settings' tool using the FastMCP @mcp.tool decorator, specifying the name and description.
  @mcp.tool( name="list_video_settings", description="Return a paginated list of your VideoSettings.", )
• nolang_mcp/models.py:294-300 (schema)

  Pydantic input schema (args) for the list_video_settings tool, defining the optional page parameter.
  class ListVideoSettingsArgs(BaseModel): """Arguments for listing video settings.""" model_config = ConfigDict(extra="forbid") page: int = Field(default=1, description="Page number to retrieve", ge=1)
• nolang_mcp/models.py:345-352 (schema)

  Pydantic output schema (result) for the list_video_settings tool, defining the paginated list structure.
  class ListVideoSettingsResult(BaseModel): model_config = ConfigDict(extra="allow") total_settings: int = Field(..., description="Total number of video settings") page: int = Field(..., description="Current page number") has_next: bool = Field(..., description="True if there is another page of results") settings: List[VideoSettingSummary] = Field(..., description="List of video setting summaries")
• nolang_mcp/api_client.py:211-213 (helper)

  API client helper method that performs the HTTP GET request to retrieve paginated video settings from the NoLang API.
  async def list_video_settings(self, page: int = 1) -> VideoSettingsResponse: response_data = await self._get("/unstable/video-settings/", params={"page": page}) return VideoSettingsResponse(**response_data)