BerriAI/litellm · error · Exception

Failed to fetch agent card from {self.base_url}. Tried paths

Error message

Failed to fetch agent card from {self.base_url}. Tried paths: {', '.join(paths)}

What it means

Error "Failed to fetch agent card from {self.base_url}. Tried paths: {', '.join(paths)}" thrown in BerriAI/litellm.

Source

Thrown at litellm/a2a_protocol/card_resolver.py:166

        last_error = None
        for path in paths:
            try:
                verbose_logger.debug("Attempting to fetch agent card from %s%s", self.base_url, path)
                return await super().get_agent_card(
                    relative_card_path=path,
                    http_kwargs=http_kwargs,
                )
            except Exception as e:
                verbose_logger.debug("Failed to fetch agent card from %s%s: %s", self.base_url, path, e)
                last_error = e
                continue

        # If we get here, all paths failed - re-raise the last error
        if last_error is not None:
            raise last_error

        # This shouldn't happen, but just in case
        raise Exception(f"Failed to fetch agent card from {self.base_url}. Tried paths: {', '.join(paths)}")

View on GitHub (pinned to 6c2dcb801b)

Solutions

1. Check that the A2A agent is reachable at base_url and serves its agent card at one of the well-known paths; verify network and URL.

When it happens

Trigger: Thrown at litellm/a2a_protocol/card_resolver.py:166 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of BerriAI/litellm@6c2dcb801b (2026-08-15). Data as JSON: /api/errors/c4376dad5a258f01. Report an issue: GitHub.