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