ign8t MCP Server

Seamlessly integrate ign8t project management into your AI-powered development workflow. Access your projects, documents, and tasks directly from Cursor, Claude Desktop, and other MCP-compatible AI tools.

What is MCP?

Model Context Protocol (MCP) is an open standard that enables AI assistants to securely access external tools and data sources. With the ign8t MCP server, your AI assistant can:

• 📋 Access all your ign8t projects without switching contexts
• 📄 Read BRD, PRD, and TRD documents to understand requirements
• 📊 View and manage your backlog in real-time
• ✅ Update task statuses as you complete work
• 🔍 Search across all tasks and projects
• 🎯 Get AI-powered task recommendations
• 🧠 Access full context including related requirements and documentation

Quick Start

1. Install the MCP Server

pnpm install -g @ign8t/mcp

2. Get Your API Key

1. Log in to ign8t.com
2. Navigate to Settings → API Keys
3. Click "Create New API Key"
4. Give it a descriptive name (e.g., "Cursor Integration")
5. Copy the generated key (you won't see it again!)

3. Configure Your AI Tool

{
  "mcpServers": {
    "ign8t": {
      "command": "ign8t-mcp",
      "env": {
        "IGN8T_API_KEY": "your-api-key-here" // This is all you need!
      }
    }
  }
}

{
  "mcpServers": {
    "ign8t": {
      "command": "ign8t-mcp",
      "env": {
        "IGN8T_API_KEY": "your-api-key-here" // This is all you need!
      }
    }
  }
}

4. Verify Installation

Ask your AI assistant:

"Can you list my ign8t projects?"

If configured correctly, it will show your active projects!

Usage Examples

Once configured, you can interact with ign8t naturally through your AI assistant:

Project Management

"Show me all my active projects"
"Get details about the [project name] project"
"Show me the BRD for [project name]"
"Display all documents for my current project"

Task Workflow

"What should I work on next?"
"Show me the backlog for [project name]"
"Search for tasks related to authentication"
"Update task [id] to in_progress"
"Mark task [id] as done with note: 'Implemented OAuth2'"
"Get full context for task [id]"

Resources

The MCP server also provides quick access to resources:

• ign8t://projects - List of all your projects
• ign8t://current-tasks - Your active tasks across all projects

Available Tools Reference

Workflow Integration

The ign8t MCP server is designed to fit seamlessly into your development workflow:

1. Start your day: "What are my current tasks?"
2. Get context: "Show me the requirements for this task"
3. Update progress: "Mark this task as in progress"
4. Search when stuck: "Find similar tasks I've completed"
5. Complete work: "Mark task as done and get my next task"

Troubleshooting

Advanced Configuration

Custom API Endpoint (Optional)

The MCP server connects to https://ign8t.com by default. For enterprise deployments, self-hosted instances, or local development, you can override the API endpoint:

{
  "mcpServers": {
    "ign8t": {
      "command": "ign8t-mcp",
      "env": {
        "IGN8T_API_KEY": "your-api-key",
        "IGN8T_API_URL": "https://your-domain.com" // Optional - only for custom deployments
      }
    }
  }
}

Note: Most users don't need to set IGN8T_API_URL. It's only required if you're:

• Using an enterprise or self-hosted ign8t instance
• Developing locally (e.g., http://localhost:3000)
• Using a custom domain

Development Mode

For local development and testing:

1. Clone this repository
2. Install dependencies: pnpm install
3. Copy .env.example to .env and add your API key (for development only!)
4. Run in dev mode: pnpm dev
5. Configure your AI tool to use the local path

Note: The .env file is ONLY for developers working on the MCP server itself. End users should configure their API key in their IDE's MCP settings, not in .env files.

Contributing

We welcome contributions! Please see our Contributing Guide for details.

Development Setup

# Clone the repository
git clone https://github.com/ign8t/mcp-server.git
cd mcp-server

# Install dependencies
pnpm install

# Run tests
pnpm test

# Build
pnpm build

Support

• 📚 Documentation: docs.ign8t.com/mcp
• 🐛 Issues: GitHub Issues
• 💬 Community: Discord
• 📧 Email: support@ign8t.com

License

MIT © ign8t team

Built with ❤️ by the ign8t team to enhance your AI-powered development workflow.