Junis Magic - Junis

What is Junis Magic?

Junis Magic is Junis’s official MCP (Model Context Protocol) server that gives AI assistants complete access to manage your Junis platform. Instead of navigating the web dashboard, you can build, configure, and orchestrate AI agent teams directly from tools like Claude Desktop, Cursor, or any MCP-compatible client.

Build and manage entire AI teams with natural language — no code, no dashboard clicking.

One-Line Setup: Just add the Junis Magic MCP server URL and your API key to your MCP client configuration. That’s it.

Why Junis Magic?

AI-Powered Management

Let AI assistants build your agent teams. Describe what you need in natural language, and your assistant creates, configures, and wires everything together.

Complete Platform Control

A comprehensive toolset across 16 categories — from creating agents to uploading documents, managing schedules, and configuring OAuth integrations.

Cross-Organization

Manage multiple organizations from a single MCP connection. Switch between teams effortlessly.

Zero Code Required

No API calls to write. No dashboard to navigate. Just tell your AI what you want.

Getting Started

Step 1: Get Your API Key

Log in to junis.ai
Go to Settings > API Keys
Create a User API Key (starts with jns_user_)

User API Keys are recommended — they work across all your organizations with a single key. You can create up to 5 user API keys.

Step 2: Configure Your MCP Client

Claude Desktop
Cursor
Other MCP Clients

Add to your Claude Desktop configuration file:macOS: ~/Library/Application Support/Claude/claude_desktop_config.jsonWindows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "junis-magic": {
      "url": "https://mcp.junis.ai/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer jns_user_YOUR_API_KEY"
      }
    }
  }
}

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "junis-magic": {
      "url": "https://mcp.junis.ai/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer jns_user_YOUR_API_KEY"
      }
    }
  }
}

Use these connection details for any MCP-compatible client:

Setting	Value
URL	`https://mcp.junis.ai/mcp`
Transport	Streamable HTTP
Auth Header	`Authorization: Bearer jns_user_YOUR_API_KEY`

Step 3: Start Building

Once connected, ask your AI assistant to manage your Junis platform:

"Switch to my organization and show me all my agents."
"Create a customer support agent with web search enabled."
"Build a research team with a web scraper and a report writer working in sequence."

Build-first: For clear build requests, your assistant builds immediately with smart defaults and reports afterward — it only asks for confirmation on large builds (10+ agents), destructive changes, or high-cost operations.

Available Tool Categories

Junis Magic provides a comprehensive toolset organized in 16 categories:

Category	Key Capabilities
Organization Management	List, create, and switch between organizations
Agent Management	Create, update, clone agents (LLM, Sequential, Parallel, Loop)
Sub-Agent Relationships	Wire parent-child agent hierarchies, reorder execution
MCP Platform Management	Connect and configure MCP integrations for agents
RAG Knowledge Base	Create datastores, upload documents, track indexing
Sessions	List conversations, view message history, manage sessions
Chat	Send messages to agents, OpenAI-compatible completions
Schedules	Create and manage automated task schedules
Skills	Import prompt-template skills from GitHub or npm
Composio OAuth	Connect 200+ OAuth integrations (Gmail, Slack, GitHub, etc.)
Team Builder	Batch operations for creating entire agent teams at once
Content Management	Track AI-generated images, videos, and audio
Soul & Identity	Define your organization’s AI personality and communication style
Memory Management	View and update user memory profiles
RAG Upload	Upload and manage knowledge base documents
Device Management	Connect and manage local devices for desktop agent control

Example Workflows

Build a Complete Agent Team

You: "Create a content team with these agents:
1. A research agent that can search the web
2. A writer agent that creates articles
3. A reviewer agent that checks quality
Set them up as a sequential pipeline."

AI Assistant:
1. Creates 3 LLM agents with appropriate instructions
2. Creates a Sequential parent agent
3. Wires sub-agent relationships in order
4. Links web search capability to the research agent

Done! Team ready to use.

Set Up a Knowledge Base

You: "Create a knowledge base called 'Product Docs' and upload the product manual."

AI Assistant:
1. Creates a new RAG DataStore
2. Uploads the document
3. Monitors indexing progress
4. Reports when the knowledge base is ready for search

Configure OAuth Integrations

You: "Connect Gmail to my support agent so it can read and send emails."

AI Assistant:
1. Lists available Composio integrations
2. Links Gmail integration to the agent
3. Provides the OAuth URL for you to authorize
4. Confirms connection status

Manage Soul & Identity

You: "Set our AI personality to be professional but approachable,
with a focus on data-driven recommendations."

AI Assistant:
1. Reads current soul and identity configuration
2. Updates soul.md with reasoning principles
3. Updates identity.md with communication style
4. Changes take effect on next conversation

Team Builder: Batch Operations

For complex setups, the Team Builder tool lets you create entire agent architectures in a single call:

You: "Build me an e-commerce support team with:
- Product FAQ agent (with RAG knowledge base)
- Order tracking agent (with Composio for CRM)
- Escalation agent (routes complex issues)
All orchestrated through a main support agent."

AI Assistant uses apply_team_changes() to:
1. Create all 4 agents simultaneously
2. Configure each with appropriate models and instructions
3. Wire the orchestration hierarchy
4. Link MCP platforms and integrations

Pro Tip: The Team Builder is the fastest way to set up complex agent architectures. It handles all the wiring automatically.

Supported Models

Junis Magic lets you configure agents with various AI models:

Model	Best For
Claude Sonnet 4.6	Default — general purpose, strong tool calling, balanced cost/performance
Claude Opus 4.8	Flagship — complex reasoning, advanced analysis
Gemini 3.5 Flash / 3.1 Flash Lite	Cost-effective, fast; Gemini is required for RAG agents
GPT-5.x	Alternative general purpose (e.g. GPT-5.5, GPT-5.4)

RAG Agents: Must use Gemini models (Vertex AI Search requirement). Other models cannot use RAG tools.

Models are validated against the platform’s live model registry — if you request an unavailable model, your assistant will suggest the closest supported one. Ask “what models can I use?” for the current list.

Best Practices

Recommended:

Always call switch_organization first when starting a session
Use list_agents and list_tools to understand your current setup before making changes
Use the Team Builder for creating multiple agents at once
Use User API Keys for cross-organization management
Test agents with send_message after creation

Important Notes:

Agent names should use lowercase with hyphens (e.g., my-agent)
RAG agents must use Gemini models
Changes take effect on the next conversation with the agent

Agent System

Learn about agent types and orchestration

MCP Integration

Configure MCP platforms

Composio Integration

Connect OAuth-based services

API Reference

Programmatic access via REST API

Need Help? Contact us at contact@junis.ai for assistance with Junis Magic setup and configuration.

​What is Junis Magic?

​Why Junis Magic?

AI-Powered Management

Complete Platform Control

Cross-Organization

Zero Code Required

​Getting Started

​Step 1: Get Your API Key

​Step 2: Configure Your MCP Client

​Step 3: Start Building

​Available Tool Categories

​Example Workflows

​Build a Complete Agent Team

​Set Up a Knowledge Base

​Configure OAuth Integrations

​Manage Soul & Identity

​Team Builder: Batch Operations

​Supported Models

​Best Practices

​Related Guides

Agent System

MCP Integration

Composio Integration

API Reference

What is Junis Magic?

Why Junis Magic?

Getting Started

Step 1: Get Your API Key

Step 2: Configure Your MCP Client

Step 3: Start Building

Available Tool Categories

Example Workflows

Build a Complete Agent Team

Set Up a Knowledge Base

Configure OAuth Integrations

Manage Soul & Identity

Team Builder: Batch Operations

Supported Models

Best Practices

Related Guides