Skip to main content

Connect Asimov MCP to your AI assistant

Choose your preferred AI coding assistant and follow the configuration steps:
  • Claude Code
  • Cursor
  • Windsurf
  • Codex
Run the following command to add Asimov MCP:
claude mcp add --transport stdio asimov \
  --env API_KEY=your-api-key-here \
  --env API_URL=https://asimov.mov \
  -- npx -y asimov-mcp
Replace your-api-key-here with your API key from asimov.mov/settings/api.
After adding the configuration, restart your AI coding assistant to load the MCP server.

Project-Level Configuration

Add project-specific instructions that your AI assistant will automatically follow when working in your repository.
  • Claude Code
  • Cursor
  • Windsurf
  • Codex
Create a CLAUDE.md file in your project root:
CLAUDE.md
# Project Instructions

Always use Asimov MCP tools for this project and for following tasks:

- Use web search to find up-to-date documentation
- Index important documents that you think will help us in our project
- Search for specific repositories structure and content to ground the 
information on truth and solve the errors.
- Searching from Indexed docs to use the right API Version.
- Viewing the content and strcuture of repositories before indexing them 
or for ver specific code.
Claude Code automatically reads CLAUDE.md when working in your repository.

Benefits

Repositories

Find and View Github Repositories and it’s Content.

Context

Share conversation history with your team

Sources

Index and search external documentation

Web Search

Find repos and docs links instantly

Troubleshooting

  • Verify the API key in your MCP configuration
  • Restart your AI assistant after configuration changes
  • Check that npx is available in your PATH
  • Ensure you’ve restarted your assistant after adding the configuration
  • Check the assistant’s console/logs for error messages
  • Verify the configuration file is in the correct location
You can also contact at hamza@asimov.mov (I would personally solve the issue under an hour!)