paylink 0.1.2

Python SDK for interacting with PayLink MCP servers

PayLink Python SDK

using y.

Features

• 🚀 Easy-to-use Python SDK for PayLink MCP servers
• 📱 M-Pesa STK Push integration
• 🔧 Tool discovery and execution
• ⚡ Async/await support
• 🛡️ Type hints for better development experience

Installation

pip install paylink

Quick Start

import asyncio
from paylink import PayLink

async def main():
    # Initialize the PayLink client
    client = PayLink(base_url="http://your-paylink-server:5002/mcp")

    # List available tools
    tools = await client.list_tools()
    print("Available tools:", tools)

    # Call a tool (e.g., STK Push)
    if "stk_push" in tools:
        result = await client.call_tool("stk_push", {
            "amount": "100",
            "phone_number": "254712345678",
            "account_reference": "ORDER123",
            "transaction_desc": "Payment"
        })
        print("Payment result:", result)

if __name__ == "__main__":
    asyncio.run(main())

API Reference

PayLink Class

__init__(base_url: str = "http://0.0.0.0:5002/mcp")

Initialize the PayLink client.

Parameters:

• base_url (str): The base URL of your PayLink MCP server

async list_tools() -> List[str]

List all available tools from the MCP server.

Returns:

• List[str]: A list of available tool names

async call_tool(tool_name: str, args: Dict[str, Any]) -> Any

Call a specific tool exposed by the MCP server.

Parameters:

• tool_name (str): The name of the tool to call
• args (Dict[str, Any]): Arguments to pass to the tool

Returns:

• Any: The result from the tool execution

Examples

STK Push Payment

import asyncio
from paylink import PayLink

async def stk_push_example():
    client = PayLink(base_url="http://your-server:5002/mcp")

    result = await client.call_tool("stk_push", {
        "amount": "100",
        "phone_number": "254712345678",
        "account_reference": "ORDER123",
        "transaction_desc": "Test Payment"
    })

    print(f"Payment initiated: {result}")

asyncio.run(stk_push_example())

List Available Tools

import asyncio
from paylink import PayLink

async def list_tools_example():
    client = PayLink(base_url="http://your-server:5002/mcp")
    tools = await client.list_tools()

    for tool in tools:
        print(f"Available tool: {tool}")

asyncio.run(list_tools_example())

Requirements

• Python 3.10+
• PayLink MCP server running and accessible

Dependencies

• mcp[cli]>=1.13.1 - Model Context Protocol client

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

For support and questions, please open an issue on the GitHub repository.