# 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.
