Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (rasmio-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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.