Metadata-Version: 2.4
Name: logam-mulia-mcp
Version: 1.0.1
Summary: MCP server for Logam Mulia API — Indonesian gold prices from 18+ sources
License-Expression: MIT
Project-URL: Home, https://github.com/rizalibnu/logam-mulia-mcp
Project-URL: Repository, https://github.com/rizalibnu/logam-mulia-mcp
Project-URL: Bug Tracker, https://github.com/rizalibnu/logam-mulia-mcp/issues
Keywords: mcp,gold,logam-mulia,indonesia,emas,modelcontextprotocol
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Financial
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=1.2.0
Requires-Dist: httpx>=0.28.0
Dynamic: license-file

# Logam Mulia MCP Server

MCP server for Indonesian gold (logam mulia) prices from 18+ sources.

**Source API:** [logam-mulia-api](https://github.com/iamutaki/logam-mulia-api)

## Quick Start

```bash
# Run directly (from repo)
uv run python -m logam_mulia_mcp.server
```

```bash
# Run from PyPI (no clone, no install)
uvx logam-mulia-mcp
```

## MCP Tools

| Tool | Description |
|------|-------------|
| `get_price(source, refresh?)` | Latest price from a source |
| `get_price_history(source, page?, length?, weight?, material?, material_type?)` | Paginated history |
| `list_sources()` | All 18 available sources |
| `get_all_prices()` | Latest from all sources at once |
| `get_news()` | Latest gold news articles |
| `get_news_detail(url)` | Full article text |

## Configuration

| Env | Default | Description |
|-----|---------|-------------|
| `LOGAM_MULIA_BASE_URL` | `https://logam-mulia-api.iamutaki.workers.dev` | API base URL |
| `MCP_TRANSPORT` | `stdio` | Transport: `stdio` or `sse` |
| `HTTP_TIMEOUT` | `30` | HTTP client timeout (s) |

## Integration

### Claude Code / Cursor / Any MCP host (via uvx)

```json
{
  "mcpServers": {
    "logam-mulia": {
      "command": "uvx",
      "args": ["logam-mulia-mcp"]
    }
  }
}
```

No install, no clone. `uvx` fetches from PyPI automatically.

### Hermes

```yaml
tools:
  mcp_servers:
    logam-mulia:
      command: uvx
      args:
        - logam-mulia-mcp
```

### Direct (any shell)

```bash
pip install -e .
logam-mulia-mcp
```
