📚 SHOPLINE Dev MCP

1️⃣ Ask Questions

Ask your AI assistant to build something or help with SHOPLINE development tasks.

2️⃣ Search Documentation

The assistant searches SHOPLINE documentation and API schemas based on your prompt.

3️⃣ Get Accurate Answers

The MCP server provides accurate code, solutions, and guidance based on current APIs and best practices.

Step 1: Run the Server

Open a new terminal window and run the following command. Keep this terminal window open while using the server:

npx -y @shopline/dev-mcp@latest

🔧 Cursor Configuration

1. Open Cursor and go to Cursor > Settings > Cursor Settings > Tools and integrations > New MCP server

2. Add this configuration to your MCP servers:

{
  "mcpServers": {
    "shopline-dev-mcp": {
      "command": "npx",
      "args": ["-y", "@shopline/dev-mcp@latest"]
    }
  }
}

For Windows, use this alternative configuration:

{
  "mcpServers": {
    "shopline-dev-mcp": {
      "command": "cmd",
      "args": ["/k", "npx", "-y", "@shopline/dev-mcp@latest"]
    }
  }
}

🤖 Claude Desktop Configuration

1. Open Claude Desktop and access your configuration file through settings

2. Add this configuration to your MCP servers section:

{
  "mcpServers": {
    "shopline-dev-mcp": {
      "command": "npx",
      "args": ["-y", "@shopline/dev-mcp@latest"]
    }
  }
}

3. Save your configuration and restart your AI development tool

📚 learn_shopline_api

Get up-to-date guidance on supported SHOPLINE APIs and how to use this MCP server's tools effectively. Provides context about which API to use for your specific needs.

Usage: Automatically invoked first when you ask about SHOPLINE APIs. It provides essential context about supported APIs and generates a conversation ID for tracking usage across tool calls.

🔍 search_docs_chunks

Search across all sline.dev documentation to find relevant information. Returns content from multiple documentation sections, but may have incomplete context due to chunking.

When used: Invoked when you ask broad questions or when the assistant needs to find relevant information across multiple documentation sections.

� fetch_full_docs

Get complete documentation for specific sline.dev pages. Provides full context without information loss. Requires the exact documentation path.

When used: Used when complete documentation is needed for a specific API resource and the exact path is known.

🔬 introspect_admin_schema

Search and explore the SHOPLINE Admin API GraphQL schema to understand available types, fields, queries, and mutations.

When used: Invoked when you ask about GraphQL schema structure, available fields, or API capabilities.

✅ validate_theme

Validate Sline templates as well as supporting theme files generated or updated by LLMs.

When used: Used after theme code was generated or modified to ensure validity and best practices.

🎯 Be Specific

• Include your programming language and framework
• Mention your specific use case or goal
• Specify the SHOPLINE API you're working with
• Include your current tech stack and constraints

📝 Request Examples

• Ask for complete, working code snippets
• Request step-by-step implementation guides
• Ask for best practices and security considerations
• Request testing and debugging strategies

🐛 Troubleshooting

• Include full error messages and stack traces
• Share relevant code snippets causing issues
• Describe your expected vs actual behavior
• Mention what you've already tried

🔄 Migration Help

• Specify your current platform (e.g., Shopify)
• Describe your existing architecture
• Ask about equivalent SHOPLINE features
• Request migration timeline and strategies

🏗️ Protocol Support

• Model Context Protocol (MCP) 1.0
• JSON-RPC 2.0 interface
• Local server deployment
• Cross-platform compatibility
• Real-time documentation access

📚 Documentation Coverage

• Admin GraphQL API
• Storefront API
• Webhook API
• Sline Template Engine
• Theme Development

🛠️ Development Features

• Real-time API schema introspection
• Code generation and validation
• Best practices guidance
• Error debugging assistance
• Migration support tools