IRIS Platform Documentation

The IRIS Platform provides a Skills Marketplace where developers can publish, discover, and install AI skills, MCP servers, agent templates, and workflow automations.

Base URL: https://heyiris.io

Key Features:

  • Skills API — Browse and install MCP servers, integrations, and developer tools
  • Agent Templates — Clone pre-built AI agents for sales, marketing, research, and more
  • Discovery Endpoints — Open standards (Cloudflare Skills RFC, Google A2A Protocol)
  • Developer Tools — Works with Claude Code, Cursor, Codex, Windsurf, and others
  • GitHub Import — Import skills directly from any GitHub repository

Authentication

Public endpoints (browsing skills, discovery) require no authentication.

For publishing, installing, and reviewing skills, include a Bearer token in the Authorization header:

Authorization: Bearer YOUR_API_TOKEN

Obtain tokens from your IRIS workspace settings under API Keys.

Public endpoints (no auth required):

  • GET /api/v1/marketplace/skills — List skills
  • GET /api/v1/marketplace/skills/{id} — Skill details
  • GET /.well-known/skills/index.json — Skills discovery
  • GET /.well-known/agent.json — A2A agent card

Authenticated endpoints (Bearer token required):

  • POST /api/v1/marketplace/skills — Publish a skill
  • POST /api/v1/marketplace/skills/{id}/install — Install a skill
  • POST /api/v1/marketplace/skills/{id}/reviews — Submit a review

Skills API

The Skills API lets you browse, search, and manage marketplace skills.

List Skills

GET /api/v1/marketplace/skills

Query Parameters:

Parameter Type Description
search string Search by name, description, or tags
category string Filter by category (development, marketing, sales, ai-agents, analytics, automation)
type string Filter by type (mcp_server, integration, workflow, agent_template)
sort string Sort by: popular, newest, stars (default: popular)
per_page int Results per page (default: 20, max: 100)

Get Skill Detail

GET /api/v1/marketplace/skills/{id}

Returns full skill details including README, install config, version history, and reviews.

bash Example: List MCP servers
# List all MCP server skills
curl https://heyiris.io/api/v1/marketplace/skills \
  -G -d type=mcp_server -d sort=stars

# Search for GitHub-related skills
curl https://heyiris.io/api/v1/marketplace/skills \
  -G -d search=github

# Get a specific skill
curl https://heyiris.io/api/v1/marketplace/skills/42

Agent Templates

Agent templates are pre-built AI agents you can clone into your workspace.

List Templates

GET /api/v1/marketplace/skills?type=agent_template

Use a Template

POST /api/v1/marketplace/skills/{id}/install

Clones the agent template into your workspace with all its configuration, tools, knowledge base, and workflow settings. You can then customize it to fit your needs.

Available Template Categories:

  • Sales — Outreach automation, lead research, pipeline management
  • Marketing — Content creation, social media, SEO optimization
  • Research — Market analysis, competitive intelligence, data gathering
  • Development — Code review, documentation, testing automation
  • Support — Customer service, FAQ handling, ticket routing
bash Example: Install an agent template
# Install a sales outreach agent template
curl -X POST https://heyiris.io/api/v1/marketplace/skills/15/install \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

Discovery Endpoints

IRIS implements open standards so external AI agents can automatically discover and use published skills.

Cloudflare Skills RFC

GET /.well-known/skills/index.json

Lightweight index of all published skills (~100 tokens each). Agents fetch this first, then load full details for individual skills.

GET /.well-known/skills/{name}/SKILL.md

Full skill specification with YAML frontmatter and Markdown body. Includes install instructions, function list, tags, and documentation.

Google A2A Protocol

GET /.well-known/agent.json

Agent identity card describing the IRIS platform capabilities and listing available skills for agent-to-agent communication.

All discovery endpoints are public, CORS-enabled, and cached for 1 hour.

json Discovery endpoint responses
// GET /.well-known/skills/index.json
{
  "skills": [
    {
      "name": "github-mcp",
      "title": "GitHub MCP Server",
      "description": "Search repos, create issues, manage PRs",
      "category": "development",
      "url": "/.well-known/skills/github-mcp/SKILL.md"
    }
  ],
  "total": 42,
  "updated_at": "2026-02-22T00:00:00Z"
}

// GET /.well-known/agent.json
{
  "name": "IRIS Platform",
  "description": "AI Skills Marketplace",
  "url": "https://heyiris.io",
  "skills_endpoint": "/.well-known/skills/index.json",
  "capabilities": ["skills", "agents", "workflows"]
}

MCP Setup Guides

MCP (Model Context Protocol) skills can be installed in any compatible developer tool. Each skill's detail page includes copy-pasteable config for your preferred tool.

Below are the config file locations and formats for supported tools.

json Claude Code — .mcp.json
{
  "mcpServers": {
    "github-mcp": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token"
      }
    }
  }
}
json Cursor — .cursor/mcp.json
{
  "mcpServers": {
    "github-mcp": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token"
      }
    }
  }
}
yaml Codex CLI — codex.toml
[mcp_servers.github-mcp]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]

[mcp_servers.github-mcp.env]
GITHUB_PERSONAL_ACCESS_TOKEN = "your-token"

GitHub Import

Import skills directly from any public GitHub repository. The platform auto-detects MCP servers, reads iris-skill.json manifests, and builds listings from repo metadata.

How It Works

  1. Provide a GitHub repo URL (e.g., https://github.com/modelcontextprotocol/servers)
  2. The importer scans for MCP server packages, skill manifests, and README files
  3. Each detected skill is created as a draft listing for you to review and publish
  4. GitHub stars and forks are synced automatically via daily cron

Supported Formats

  • iris-skill.json — Full skill manifest with metadata, install config, and function list
  • Monorepo detection — Scans subdirectories for individual packages (e.g., src/github/, src/fetch/)
  • Awesome-list repos — Parses awesome-list markdown format for batch import
  • README fallback — Extracts title, description, and install instructions from README.md
bash Example: Import from GitHub
# Import a single skill repo
curl -X POST https://heyiris.io/api/v1/marketplace/skills/import-github \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"github_url": "https://github.com/modelcontextprotocol/servers"}'

Rate Limits

Endpoint Limit
Public browsing (GET /skills) 60 requests/minute
Skill detail (GET /skills/{id}) 60 requests/minute
Discovery (/.well-known/*) 120 requests/minute (cached)
Publishing (POST /skills) 10 requests/minute
Install (POST /skills/{id}/install) 30 requests/minute
GitHub import 5 requests/minute

Rate limits are applied per IP for public endpoints and per API token for authenticated endpoints. Exceeding the limit returns 429 Too Many Requests.

Need help? Visit the IRIS Marketplace or reach out to the team.