mcp-ai-assistant-iris
Provides web search and code execution capabilities using OpenAI models (gpt-5/o3), with features like model selection, reasoning effort, search context, conversation continuity, and optional code interpreter for data analysis.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-ai-assistant-iris search latest advancements in quantum computing"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Using npx (Recommended)
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-irisOr 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 querysearchContextSize(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:
Each
iristool response includes a Response ID in the format:[Response ID: resp_abc123xyz]Use this Response ID as the
previous_response_idparameter in subsequent callsThe 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 toolirisB
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
Scored across 1 tool
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.
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.
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.
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
Real-time web search, reasoning, and research through Perplexity's API
Web search, page reading and library docs for agents. No key. Routed to the best measured server.
61Web search, Google SERP, page extraction to markdown and cited answers for AI agents.
Web search, fetch, extract, and research for AI agents. Markdown output + AI-synthesized answers.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceProvides 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
- AlicenseNot gradedqualityDmaintenanceProvides 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 npmMIT
- AlicenseAqualityNot gradedmaintenanceEnables 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.3Apache 2.0
- AlicenseAqualityDmaintenanceProvides intelligent web search capabilities using OpenAI's reasoning models, enabling AI assistants to fetch up-to-date information with smart reasoning.1MIT