Metadata-Version: 2.4
Name: globkurier-api-mcp
Version: 0.2.0
Summary: MCP server for GlobKurier API - Hexagonal Architecture with CQRS
Author-email: GlobKurier <it@globkurier.pl>
License: MIT
Project-URL: Homepage, https://github.com/GlobKurier-pl/mcp-server
Project-URL: Repository, https://github.com/GlobKurier-pl/mcp-server
Project-URL: Documentation, https://github.com/GlobKurier-pl/mcp-server#readme
Keywords: mcp,shipping,logistics,globkurier,dpd,inpost,courier
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.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Internet
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: fastmcp>=2.0.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pydantic-settings>=2.0.0

<!-- mcp-name: io.github.globkurier-pl/mcp-server -->

# GlobKurier MCP Server

> [Polska wersja dokumentacji](./README.pl.md)

[Model Context Protocol](https://modelcontextprotocol.io/) server for the [GlobKurier](https://www.globkurier.pl) API. Enables AI assistants (Claude, Cursor, Cline and others) to track shipments, search shipping products and generate purchase links.

## Installation

### Recommended: Hosted server (no local installation)

```json
{
  "mcpServers": {
    "globkurier": {
      "type": "http",
      "url": "https://mcp.globkurier.pl/mcp"
    }
  }
}
```

### Alternative: Run locally via `uvx`

```json
{
  "mcpServers": {
    "globkurier": {
      "command": "uvx",
      "args": ["globkurier-api-mcp"]
    }
  }
}
```

Paste the configuration into your MCP client settings file:

| Client | Settings file |
|---|---|
| **Claude Desktop** | `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) / `%APPDATA%\Claude\claude_desktop_config.json` (Windows) |
| **Cursor** | `.cursor/mcp.json` in your project or `~/.cursor/mcp.json` globally |
| **Cline** | Extension settings in VS Code |

## Available Tools

| Tool | Description |
|---|---|
| `get_shipment_status` | Track a shipment by order number |
| `search_products` | Search shipping products (DPD, InPost, DHL, FedEx, UPS, GLS and more) |
| `get_product_addons` | Get available add-ons for a product |
| `get_search_url` | Generate a purchase link for a shipment |

## Available Resources

| Resource | Description |
|---|---|
| `globkurier://countries` | List of supported countries |
| `globkurier://countries/{iso_code}` | Country details by ISO code |

---

For developer documentation see [CONTRIBUTING.md](./CONTRIBUTING.md).

## License

MIT

## Author

it@globkurier.pl
