ShallowCodeResearch_agent_citation_formatter

Format citations from URLs in text blocks into APA-style references using a citation formatter agent.

Instructions

Wrapper for CitationFormatterAgent to format citations. Returns: Formatted citations result with APA-style references

Input Schema

TableJSON Schema

Name	Required	Description	Default
`text_block`	No	The text containing URLs to cite

Implementation Reference

app.py:1008-1015 (registration)

Gradio Interface registration for the citation formatter tool, exposing it as an MCP tool with api_name 'agent_citation_formatter_service' which likely corresponds to the queried tool name in the ShallowCodeResearch context.

gr.Interface(
    fn=agent_citation_formatter,
    inputs=[gr.Textbox(label="Text Block with Citations", lines=12, placeholder="Enter text to format citations…")],
    outputs=gr.JSON(label="Formatted Citations", height=305),
    title="Citation Formatter Agent",
    description="Extracts and formats APA-style citations from text blocks.",
    api_name="agent_citation_formatter_service",
)

app.py:764-774 (handler)

Wrapper handler function in app.py that calls the CitationFormatterAgent's format_citations method, serving as the direct MCP tool handler.

def agent_citation_formatter(text_block: str) -> dict:
    """
    Wrapper for CitationFormatterAgent to format citations.

    Args:
        text_block (str): The text containing URLs to cite

    Returns:
        dict: Formatted citations result with APA-style references
    """
    return citation_formatter.format_citations(text_block)

mcp_hub/agents/citation_formatter.py:84-121 (handler)

Core implementation of the citation formatting logic in CitationFormatterAgent.format_citations, extracting URLs and generating APA citations.

@with_performance_tracking("citation_formatting")
def format_citations(self, text_block: str) -> Dict[str, Any]:
    """
    Extract URLs from text and produce APA-style citations.

    Analyzes the provided text block to identify URLs and automatically
    generates properly formatted academic citations following APA style
    guidelines for web sources.

    Args:
        text_block (str): The text content containing URLs to be cited

    Returns:
        Dict[str, Any]: A dictionary containing formatted citations array
                       or error information if extraction fails
    """
    try:
        validate_non_empty_string(text_block, "Text block")
        logger.info("Formatting citations from text block")
        
        urls = extract_urls_from_text(text_block)
        if not urls:
            return {"error": "No URLs found to cite.", "formatted_citations": []}
        
        citations = []
        for url in urls:
            citation = create_apa_citation(url)
            citations.append(citation)
        
        logger.info(f"Successfully formatted {len(citations)} citations")
        return {"formatted_citations": citations, "error": None}
        
    except ValidationError as e:
        logger.error(f"Citation formatting validation failed: {str(e)}")
        return {"error": str(e), "formatted_citations": []}
    except Exception as e:
        logger.error(f"Citation formatting failed: {str(e)}")
        return {"error": f"Unexpected error: {str(e)}", "formatted_citations": []}

mcp_hub/utils.py:432-452 (helper)

Helper function to create individual APA-style citations from URLs, used by the citation formatter.

def create_apa_citation(url: str, year: str = None) -> str:
    """Create a simple APA-style citation from a URL."""
    if not year:
        year = api_config.current_year
    
    try:
        domain = url.split("/")[2]
        title = domain.replace("www.", "").split(".")[0].capitalize()
        return f"{title}. ({year}). Retrieved from {url}"
    except (IndexError, AttributeError):
        return f"Unknown Source. ({year}). Retrieved from {url}"

MCP Hub