ira-universe
Public-safe visitor MCP for Claude Code and Cursor that explains what Ira is, how it is built, and how to adopt a factory-specific fork without sensitive data.
README
Ira Universe
Public-safe visitor MCP for Claude Code and Cursor — explain what Ira is, how it is built, and how to adopt a factory-specific fork without Machinecraft CRM, Gmail, or customer data.
Full operator stack lives in private ira-v3. This repo is intentionally small.
Recommended reading order
- IRA_BIRTH_CERTIFICATE.md — identity, pipeline, body metaphor
- ARCHITECTURE.md — technical map
- PIPELINE_AUDIT.md — safety ordering (executive summary)
- TIMEOUT_MODEL.md — bounded execution
- CURSOR_AGENTIC_LOOP.md + CURSOR_WORKFLOWS.md — using Ira in Cursor
- IRA_TRIANGULATION.md — evidence before outbound
Quick start (Claude Code)
git clone https://github.com/doshirush1901/ira-universe.git
cd ira-universe
poetry install
Add .mcp.json from .mcp.json.example, then enable ira-universe in your MCP settings.
Start manually (optional):
poetry run ira-universe-mcp
MCP tools (12)
| Tool | Purpose |
|---|---|
who_is_ira |
Identity from SOUL + README |
how_ira_is_built |
Architecture summary |
list_pantheon_agents |
Agent table excerpt |
explain_triangulation |
Evidence workflow (triangle/hex) |
fork_ira_for_your_factory |
Adoption checklist |
list_public_corpus |
Allowlisted files |
search_public_docs |
Search public docs |
demo_search_knowledge |
Synthetic demo only |
universe_mcp_status |
Safety posture |
list_ira_justification_assets |
Public collateral index |
read_ira_justification_text |
Read one public doc by path |
build_ira_business_case |
Heuristic ROI / adoption case |
What is NOT in this repo
PSG_Case_Study/and other named-customer marketing builds (private operator repo)- Full
ira mcp(~160 tools), web UI, Docker operator stack - Gmail / CRM connectors or send paths
See examples/marketing/case_study_workflow.md for how case studies work in the private stack.
Safety
- No secrets in Git — use your own
.envonly on a private fork if you expand beyond visitor mode. - Optional:
IRA_VISITOR_MCP_STRICT=1blocks startup when Gmail/CRM env vars are set.
License
Proprietary — see LICENSE. Fork for evaluation; contact Machinecraft for redistribution terms.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.