Skip to main content

​
Weaverse MCP

Access Weaverse documentation and knowledge directly through your favorite AI tools with the Weaverse MCP server.

​
About MCP Servers

The Model Context Protocol (MCP) is an open protocol that creates standardized connections between AI applications and external services, like documentation. The Weaverse MCP server enables AI assistants like Claude, Cursor, and others to search Weaverse documentation directly, delivering accurate, context-aware assistance for developers working with Weaverse products. Your MCP server exposes tools for AI applications to search the Weaverse knowledge base and find relevant information, code examples, API references, and implementation guides.

​
Accessing the Weaverse MCP Server

The Weaverse MCP server is automatically hosted at: 
https://docs.weaverse.io/mcp
This HTTP-based server is always available and requires no installation or setup. Simply connect your AI tools to this URL to start accessing Weaverse documentation.
The MCP server is publicly available and automatically generated from the Weaverse documentation.

​
Connecting to AI Tools

Connect the Weaverse MCP server to your preferred AI development tools:
  • Contextual Menu
  • Claude Desktop
  • Claude Code
  • Cursor
  • VS Code
The easiest way to connect is using the contextual menu available on any documentation page:
  1. Click the contextual menu icon (three dots) at the top of any page
  2. Select one of the following options:
    • Copy MCP server URL - Copies https://docs.weaverse.io/mcp to clipboard
    • Connect to Cursor - Automatically installs the MCP server in Cursor
    • Connect to VS Code - Automatically installs the MCP server in VS Code
This one-click integration automatically configures your development environment.

​
Available Tools

The Weaverse MCP server provides the following tool:

SearchWeaverse

Search across the Weaverse knowledge base to find relevant information, code examples, API references, and implementation guides.Use when you need to:
  • Answer questions about Weaverse features
  • Find specific documentation or code examples
  • Understand how features work
  • Locate API references and implementation details
  • Troubleshoot issues
Returns: Contextual content with titles and direct links to documentation pages

​
Common Use Cases

The Weaverse MCP is particularly useful for:

Component Development

Ask about creating custom Weaverse components, schema definitions, and input settings

API Integration

Query specific API hooks, component props, and utility functions

Troubleshooting

Share error messages to receive relevant documentation and solutions

Implementation Guidance

Get step-by-step instructions for implementing Weaverse features

​
Example Queries

Here are some example questions you can ask your AI assistant with the Weaverse MCP enabled: 
How do I set up a new Weaverse Hydrogen theme?

What's the difference between 'settings' and 'inspector' in component schemas?

How do I use the createSchema() function?

Show me examples of the useWeaverse hook

What are the available input types for component settings?

How do I implement data fetching in a Weaverse section?

What props does the WeaverseRoot component accept?

​
How It Works

When you ask a question about Weaverse in your AI tool:
  1. Recognition: The AI assistant recognizes your question is about Weaverse
  2. Query: It calls the Weaverse MCP server with your query
  3. Search: The MCP server searches the Weaverse documentation using the SearchWeaverse tool
  4. Return: Relevant documentation with links is returned to the AI assistant
  5. Response: The AI formulates an accurate response based on official documentation
This process ensures responses are accurate and based on the latest Weaverse documentation.

​
Benefits

Always Accurate

AI assistants access the most up-to-date Weaverse documentation

Context-Aware

Get answers tailored to Weaverse’s specific implementation and ecosystem

Instant Setup

No installation required - just connect and start using

Seamless Integration

Works with Claude, Cursor, VS Code, and other MCP-compatible tools

​
Troubleshooting

  • Verify your internet connection
  • Check that the URL is exactly: https://docs.weaverse.io/mcp
  • Ensure your AI tool’s MCP configuration is correct
  • Try disconnecting and reconnecting the MCP server
  • Be specific in your queries
  • Include Weaverse-specific terms (e.g., “createSchema”, “WeaverseRoot”, “input settings”)
  • Mention the specific feature or component you’re asking about
  • Try rephrasing your question with more context
  • Verify the MCP server URL is correctly configured
  • Restart your AI tool after adding the configuration
  • Check your tool’s MCP documentation for setup requirements
  • Ensure your firewall allows connections to docs.weaverse.io
  • Confirm the MCP server is connected in your tool’s settings
  • Restart your AI application
  • Check that your tool supports HTTP-based MCP servers
  • Verify you’re using a compatible version of your AI tool

​
Next Steps

Weaverse CLI

Learn about the Weaverse CLI for project setup and theme scaffolding

Weaverse SDKs

Explore the Weaverse SDKs for building custom components

API Reference

Browse the complete Weaverse API documentation

Development Guide

Start building with Weaverse Hydrogen themes
The Weaverse MCP server is continuously updated as documentation evolves, ensuring your AI tools always have access to the latest information.
⌘I