# WoWSQL

> WoWSQL is a freemium MCP server for databases. Hosted MCP server for managing WoWSQL Postgres projects, SQL, docs and storage over OAuth. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** Web, API, self-hosted
- **Website:** https://wowsql.com
- **Repository:** https://github.com/wowsql/mcp-server
- **MCP Registry name:** com.wowsql/mcp
- **Categories:** databases, developer tools
- **Listing updated:** 2026-11-15

## About

WoWSQL is a managed backend platform, and this server lets an AI client work with it. According to the registry entry, it covers projects, SQL, documentation search and storage buckets, with sign-in through OAuth 2.0 authorization code and PKCE.

Clients connect to the hosted Streamable HTTP endpoint, and requests without a valid bearer token get a 401 that points to OAuth metadata so supporting clients can start the sign-in. The README shows that the endpoint URL can be scoped with query parameters such as `project_ref`, `read_only=true` and `features=database,docs`, which lets you narrow what an assistant can touch. A self-hosted Node process is also described for development.

The platform behind it offers managed Postgres, auth, realtime, storage and generated APIs, plus an SQL assistant called MERA.

## Features

- **OAuth with PKCE:** The MCP endpoint is an OAuth-protected resource; clients get discovery metadata on a 401.
- **Project scoping:** Query parameters can pin a project, force read-only mode and select feature groups.
- **SQL and project access:** Lets an assistant work with WoWSQL projects and run SQL.
- **Docs search:** Includes search over WoWSQL documentation.
- **Storage buckets:** Exposes bucket management for the platform's file storage.
- **Self-hostable process:** The README describes running the MCP server yourself against a WoWSQL API base URL.

## Good for

- Querying a managed Postgres project from an AI assistant
- Browsing WoWSQL docs while writing backend code
- Managing storage buckets without opening the dashboard
- Limiting an assistant to a read-only view of one project

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://mcp.wowsql.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.wowsql.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.wowsql.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.wowsql.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.wowsql.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.wowsql.com/mcp"
    }
  }
}
```

## FAQ

### How does authentication work?

OAuth 2.0 authorization code with PKCE; the server expects a bearer token and validates it against the WoWSQL API.

### Can I restrict what the assistant can do?

The README shows query parameters for project_ref, read_only and features on the MCP URL.

### Where is the endpoint?

The hosted endpoint is mcp.wowsql.com/mcp, over Streamable HTTP.

### Is there a free plan?

The pricing page lists Free, Pro and Scale tiers; prices are not shown in the page text.

### Is WoWSQL free?

WoWSQL has a free plan, with paid plans for more usage or features.

### How do I add WoWSQL to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://mcp.wowsql.com/mcp

### What are the best alternatives to WoWSQL?

The closest alternatives to WoWSQL are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/wowsql
