Skip to main content
Glama
Rasmio MCP Server

Rasmio MCP Server

by engboustani

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

Related MCP server: qavanin-mcp

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to search and retrieve data about Russian companies, entrepreneurs, and individuals via the Checko.ru API, including financial reports, legal cases, and bankruptcy information.
      12
      21 PyPI
      13
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to search roughly 168,000 Iranian laws, regulations, court votes and legal opinions by title or full text, read a law or a single article, and trace amendments, article history and citing documents. Read-only, no authentication, with results returned as compact JSON from Claude, Cursor or Copilot.
      7
      320 PyPI
      PolyForm Noncommercial 1.0.0
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to search and read Iranian listed companies’ Codal disclosures, including financial statements, EPS and monthly activity reports as tables, meeting decisions, and PDF/Excel links, plus company and fiscal-year lookups.
      5
      383 PyPI
      10
      PolyForm Noncommercial 1.0.0
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to search Iranian job ads with filters, inspect ad details such as salary and skills, look up companies and their open ads, and read top company scores through a read-only MCP interface requiring no API key.
      10
      94 PyPI
      PolyForm Noncommercial 1.0.0