engboustani/rasmio-mcp

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:

npx rasmio-mcp

Or install it globally:

npm install -g rasmio-mcp

Configuration

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

export RASMIO_API_KEY=your_api_key_here

On Windows (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

{
  "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:

rasmio-mcp

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

Development

Clone the repository and install dependencies:

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

Build the project:

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.