Metadata-Version: 2.4
Name: mcp-ads-sdk
Version: 0.1.0
Summary: Ad monetization SDK for Model Context Protocol servers
Author-email: mcpadserver <hello@mcpadserver.com>
Project-URL: Homepage, https://mcpadserver.com
Project-URL: Documentation, https://mcpadserver.com/docs
Project-URL: Repository, https://github.com/mcpadserver/mcpadserver
Project-URL: Issues, https://github.com/mcpadserver/mcpadserver/issues
Keywords: mcp,model-context-protocol,ads,monetization,ai
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.24.0
Requires-Dist: pydantic>=2.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: black>=23.0; extra == "dev"
Requires-Dist: mypy>=1.0; extra == "dev"

# mcpadserver

Ad monetization SDK for Model Context Protocol (MCP) servers.

## Installation

```bash
pip install mcpadserver
```

## Quick Start

```python
from mcpadserver import AdClient
from mcp.server import Server
from mcp.types import TextContent

app = Server("my-server")
ad_client = AdClient(api_key="your_api_key")

@app.call_tool()
async def get_data(query: str):
    # Your main data logic
    data = fetch_data(query)

    # Request contextual ad
    ad = await ad_client.request_ads(context=f"query: {query}")

    # Return as MCP content blocks
    return [
        TextContent(type="text", text=f"Data: {data}"),
        TextContent(
            type="text",
            text=f"📢 Sponsored by {ad['sponsor']}\n{ad['content']}\n{ad['link']}"
        )
    ]
```

## Features

- 🔌 **MCP-Native**: Drop-in SDK for MCP servers
- 🔒 **Privacy-Safe**: No cookies, no tracking, contextual only
- 💰 **70/30 Split**: Publishers keep 70% of revenue
- 📊 **Real-time Analytics**: Track impressions, clicks, and earnings
- ⚡ **5-Minute Setup**: Start earning immediately

## Documentation

Visit [mcpadserver.com/docs](https://mcpadserver.com/docs) for full documentation.

## License

MIT License - see LICENSE file for details.
