# Mine Market MCP Server

Search mining projects, tenements, and mineral properties directly through Claude using the Model Context Protocol (MCP).

## What is this?

This MCP server allows Claude users to search [Mine Market](https://minemarket.ai) listings with natural language queries like:

- "Find gold projects in Western Australia under $500k"
- "Show me copper tenements in South America"
- "What lithium opportunities are available in Nevada?"

## Available Tools

| Tool | Description |
|------|-------------|
| `search_listings` | Search by commodity, location, price, deal type, stage |
| `get_listing_details` | Get full details of a specific listing |
| `list_commodities` | List all available commodity types |
| `list_countries` | List all countries with listings |
| `get_market_stats` | Get platform statistics |

## Installation

### Prerequisites
- Node.js 18+
- npm

### Setup

```bash
cd MCP
npm install
npm run build
```

## Usage with Claude Desktop

Add to your Claude Desktop config (`~/.claude/claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "minemarket": {
      "command": "node",
      "args": ["/path/to/MCP/dist/index.js"]
    }
  }
}
```

Then restart Claude Desktop.

## Example Queries

Once connected, try asking Claude:

- "Search Mine Market for gold projects"
- "Find mining opportunities in Australia under $1 million"
- "What copper tenements are available?"
- "Show me the details for listing #123"
- "What commodities are available on Mine Market?"

## Development

```bash
# Build
npm run build

# Run directly
npm run dev
```

## API Endpoint

This MCP server calls the Mine Market API at:
```
https://minemarket.ai/api/mcp.php
```

## License

MIT

## Links

- [Mine Market](https://minemarket.ai)
- [Model Context Protocol](https://modelcontextprotocol.io)
- [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)