Skip to content

pulsemcp_client

Class info

Classes

Name Children Inherits
Remote
llmling_agent.mcp_server.registries.pulsemcp_client
Information about a remote MCP server endpoint.
    ServerInfo
    llmling_agent.mcp_server.registries.pulsemcp_client
    Information about an MCP server.
      ServerListResponse
      llmling_agent.mcp_server.registries.pulsemcp_client
      Response from the MCP server list endpoint.

        🛈 DocStrings

        Functions to discover available MCP servers from PulseMCP.

        Remote

        Bases: Schema

        Information about a remote MCP server endpoint.

        Source code in src/llmling_agent/mcp_server/registries/pulsemcp_client.py 
        12
13
14
15
16
17
18
19
        class Remote(Schema):
    """Information about a remote MCP server endpoint."""

    url_direct: str | None = None
    url_setup: str | None = None
    transport: Literal["streamable_http", "sse"] | None = None
    authentication_method: str | None = None
    cost: str | None = None

        ServerInfo

        Bases: Schema

        Information about an MCP server.

        Source code in src/llmling_agent/mcp_server/registries/pulsemcp_client.py 
        22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
        class ServerInfo(Schema):
    """Information about an MCP server."""

    name: str
    url: str
    external_url: str | None = None
    short_description: str
    source_code_url: str | None = None
    github_stars: int | None = Field(default=None)
    package_registry: str | None = None
    package_name: str | None = None
    package_download_count: int | None = Field(default=None)
    ai_generated_description: str | None = Field(
        default=None, alias="EXPERIMENTAL_ai_generated_description"
    )
    remotes: list[Remote] = Field(default_factory=list)

        ServerListResponse

        Bases: Schema

        Response from the MCP server list endpoint.

        Source code in src/llmling_agent/mcp_server/registries/pulsemcp_client.py 
        40
41
42
43
44
45
        class ServerListResponse(Schema):
    """Response from the MCP server list endpoint."""

    servers: list[ServerInfo]
    next: str | None = None
    total_count: int

        get_mcp_servers async 

        get_mcp_servers(
    query: str | None = None, count_per_page: int | None = None, offset: int | None = None
) -> list[ServerInfo]

        Fetch all available MCP servers.

        Parameters:

        Name Type Description Default
        query str | None

        Optional query string to filter the results.

        		 None
        count_per_page int | None

        Optional number of results to return per page.

        		 None
        offset int | None

        Optional offset for pagination.

        		 None

        Returns:

        Type Description
        list[ServerInfo]

        List of ServerInfo objects representing available MCP servers.

        Raises:

        Type Description
        HTTPError

        If the API request fails.
        Source code in src/llmling_agent/mcp_server/registries/pulsemcp_client.py 
        48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
        async def get_mcp_servers(
    query: str | None = None,
    count_per_page: int | None = None,
    offset: int | None = None,
) -> list[ServerInfo]:
    """Fetch all available MCP servers.

    Args:
        query: Optional query string to filter the results.
        count_per_page: Optional number of results to return per page.
        offset: Optional offset for pagination.

    Returns:
        List of ServerInfo objects representing available MCP servers.

    Raises:
        HTTPError: If the API request fails.
    """
    params: dict[str, Any] = {}
    if query:
        params["query"] = query
    if count_per_page is not None:
        params["count_per_page"] = count_per_page
    if offset is not None:
        params["offset"] = offset
    result = await anyenv.get_json(
        "https://api.pulsemcp.com/v0beta/servers",
        headers={"User-Agent": "MCPToolDiscovery/1.0"},
        params=params,
        return_type=ServerListResponse,
    )
    return result.servers