Metadata-Version: 2.4
Name: mcp-epic-free-games
Version: 0.1.0
Summary: A Model Context Protocol server for Epic Games Store free games information
Project-URL: Homepage, https://github.com/meethuhu/mcp-epic-free-games
Project-URL: Repository, https://github.com/meethuhu/mcp-epic-free-games
Project-URL: Issues, https://github.com/meethuhu/mcp-epic-free-games/issues
Author-email: meethuhu <meethuhu@example.com>
License: MIT
License-File: LICENSE
Keywords: epic games,free games,mcp,model context protocol
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.13
Requires-Dist: httpx>=0.28.1
Requires-Dist: mcp[cli]>=1.9.4
Requires-Dist: pydantic>=2.0.0
Description-Content-Type: text/markdown

# MCP Epic Free Games

A Model Context Protocol (MCP) server that provides access to Epic Games Store free games information.

## Features

- Get currently free games from Epic Games Store
- Get upcoming free games information
- Cached responses for better performance
- Easy integration with MCP-compatible clients

## Installation

### From PyPI

```bash
pip install mcp-epic-free-games
```

### From Source

```bash
git clone https://github.com/meethuhu/mcp-epic-free-games.git
cd mcp-epic-free-games
pip install -e .
```

## Usage

### As a standalone MCP server

```bash
mcp-epic-free-games
```

### In your MCP client configuration

Add this to your MCP client configuration:

```json
{
  "mcpServers": {
    "epic-free-games": {
      "command": "mcp-epic-free-games"
    }
  }
}
```

## Available Tools

### get_now_free_games

Get information about currently free games from Epic Games Store.

**Returns:**
- Game title
- Game description
- Game cover image
- Claim URL
- Free period dates

### get_upcoming_free_games

Get information about upcoming free games from Epic Games Store.

**Returns:**
- Game title
- Game description  
- Game cover image
- Claim URL
- Free period dates

## Development

### Requirements

- Python 3.13+
- httpx
- mcp

### Setup

```bash
git clone https://github.com/YOUR_USERNAME/mcp-epic-free-games.git
cd mcp-epic-free-games
pip install -e .
```

### Running Tests

```bash
pytest
```

## License

MIT License

## Contributing

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