# Rasmio MCP Server

A Model Context Protocol (MCP) server that provides access to the Rasmio API for searching and retrieving Iranian company information.

## Features

This MCP server provides two main tools:

1. **company_info** - Retrieve detailed company information using a national ID (company identifier)
   - Company name and registration details
   - Address and contact information
   - Registered capital and status
   - Registration dates and legal information

2. **search** - Search for companies and individuals
   - Search by name, national ID, personal ID, or postal code
   - Returns comprehensive search results with company details
   - Includes CEO information, location data, and links

## Installation

You can run this MCP server directly using npx without installation:

```bash
npx rasmio-mcp
```

Or install it globally:

```bash
npm install -g rasmio-mcp
```

## Configuration

The server requires a Rasmio API key to function. Set it as an environment variable:

```bash
export RASMIO_API_KEY=your_api_key_here
```

On Windows (PowerShell):
```powershell
$env:RASMIO_API_KEY="your_api_key_here"
```

## Usage with Claude Desktop

Add this to your Claude Desktop configuration file:

**macOS/Linux**: `~/Library/Application Support/Claude/claude_desktop_config.json`

**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "rasmio": {
      "command": "npx",
      "args": ["-y", "rasmio-mcp"],
      "env": {
        "RASMIO_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

## Usage with Other MCP Clients

You can use this server with any MCP-compatible client by running:

```bash
rasmio-mcp
```

The server communicates via standard input/output using the MCP protocol.

## Development

Clone the repository and install dependencies:

```bash
git clone https://github.com/engboustani/rasmio-mcp.git
cd rasmio-mcp
npm install
```

Build the project:

```bash
npm run build
```

## API Reference

### company_info

Retrieves detailed company information by national ID.

**Parameters:**
- `company_id` (string, required): The national ID (company identifier) of the company to look up

**Returns:** Company details including registration number, address, capital, status, and more.

### search

Search for companies and individuals across the Rasmio database.

**Parameters:**
- `query` (string, required): Search term - can be a name, national ID, personal ID, or postal code

**Returns:** List of matching companies and individuals with detailed information.

## License

MIT

## Contributing

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

## Support

For issues and questions, please use the GitHub issue tracker.