Skip to main content
Glama

mcp-ai-assistant-iris

An MCP (Model Context Protocol) server that provides web search and code execution capabilities using OpenAI models. The iris tool supports model selection (gpt-5/o3) and optional code interpreter for data analysis.

Named after Iris, the Greek goddess of the rainbow and divine messenger, who swiftly carries information between gods and mortals.

Installation

Simply install and use the package from the official npm registry:

claude mcp add iris -s user -e OPENAI_API_KEY=your-api-key -- npx @mokemokechicken/mcp-ai-assistant-iris

Or configure manually in Claude:

{
  "mcpServers": {
    "iris": {
      "command": "npx",
      "args": ["@mokemokechicken/mcp-ai-assistant-iris"],
      "env": {
        "OPENAI_API_KEY": "your-api-key"
      }
    }
  }
}

Related MCP server: OpenAI WebSearch MCP Server

Features

  • Model Selection: Choose between gpt-5 (default) and o3.

  • Web Search: Advanced web search capabilities with configurable context size

  • Code Interpreter: Optional code execution for data analysis and visualization

  • Conversation Continuity: Continue previous conversations using response IDs

  • Flexible Configuration: Customizable reasoning effort and search context

Usage

The iris tool accepts the following parameters:

Parameters

  • input (required): Your question or search query

  • searchContextSize (optional): Search context size - "low", "medium", or "high" (default: "medium")

  • reasoningEffort (optional): Reasoning effort level - "low", "medium", or "high" (default: "medium")

  • model (optional): AI model to use - "gpt-5" or "o3" (default: "gpt-5")

  • useCodeInterpreter (optional): Enable code interpreter for data analysis (default: false)

  • previous_response_id (optional): Previous OpenAI response ID for conversation continuity

Conversation Continuity

The iris tool supports conversation continuity through the previous_response_id parameter. This allows you to maintain context across multiple tool calls by referencing a previous response.

How it works:

  1. Each iris tool response includes a Response ID in the format: [Response ID: resp_abc123xyz]

  2. Use this Response ID as the previous_response_id parameter in subsequent calls

  3. The AI will automatically continue the conversation with full context

Response Format:

When you call the iris tool, the response will include:

  • The main response content

  • A Response ID at the end in the format: [Response ID: {response_id}]

Usage Example:

First call:
- input: "Tell me about machine learning"
- Response: "Machine learning is... [Response ID: resp_abc123xyz]"

Second call (continuing the conversation):
- input: "Can you give me some practical examples?"
- previous_response_id: "resp_abc123xyz"
- Response: "Based on our previous discussion about machine learning... [Response ID: resp_def456uvw]"

Important Notes:

  • Validity Period: Response IDs are valid for 30 days from creation

  • Context Inheritance: Previous conversation history, tool calls, and reasoning are preserved

  • Cost Impact: Previous conversation tokens are included in the input token count

  • Instructions: System instructions are not automatically inherited and must be specified each time

Environment Variables

  • OPENAI_API_KEY: Required OpenAI API key

License

This project is licensed under the MIT License - see the LICENSE file for details.

Available Tools

1 tool
irisB

iris (v0.6.1): An AI agent with advanced web search and code execution capabilities. Supports model selection (gpt-5.1/gpt-5/o3) and optional code interpreter for data analysis. Useful for finding latest information, troubleshooting errors, and executing code. Supports natural language queries.

Inputs: input (required), model, reasoningEffort, searchContextSize, +2 more.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 1 tool

    Disambiguation5/5

    There is only one tool, so there is no possibility of selecting the wrong tool or confusing overlapping purposes. The single 'iris' entry point is unambiguous by construction, though it is broad by nature.

    Naming Consistency4/5

    With a single tool named 'iris', there is no inconsistency to detect and the name is short and memorable. However, it follows no verb_noun or other recognizable convention, so a predictable pattern cannot be established.

    Tool Count2/5

    A single tool for an entire server is very thin; all functionality (web search, code execution, model selection, data analysis) is collapsed into one monolithic call. This leaves no granular surface for an agent to compose or target specific capabilities.

    Completeness3/5

    As a general-purpose agent wrapper, the tool can cover a wide range of tasks via natural language, which partially compensates for its thinness. But there is no coverage of auxiliary lifecycle operations (sessions, memory, configuration) that an assistant server would typically expose.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Provides access to OpenAI's advanced models (including o3) with integrated web search, Python code interpreter, and combined analysis capabilities. Enables users to perform web searches, execute code in sandboxed environments, and combine search with analysis through natural language.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides intelligent web search capabilities using OpenAI's Web Search API with reasoning models. Supports localized results, multiple model options, and automatic source citations for current information retrieval.
      44 npm
      MIT
    • A
      license
      A
      quality
      Not graded
      maintenance
      Enables web searching via SearXNG, page content extraction with Crawl4AI, and image analysis using vision language models. It provides AI agents with tools for information synthesis and web-based data retrieval through OpenAI-compatible LLM endpoints.
      3
      Apache 2.0