@nextmavens/mcp-server

Model Context Protocol (MCP) server for NextMavens platform - enables AI assistants (Claude, Cursor, Continue.dev, etc.) to directly interact with your NextMavens backend.

Quick Start

The MCP server is available as a hosted HTTP endpoint. No installation required!

Just get your API key from the NextMavens Developer Portal and configure your AI tool.

Features

- Database Operations: Query, insert, update, and delete data
- Authentication: Sign up and sign in users
- Storage: Get file info, download URLs, and list files
- GraphQL: Execute GraphQL queries and introspect schema
- 11 MCP Tools organized by service category

Configuration

Set your API key as an environment variable:

``bash
export NEXTMAVENS_API_KEY=nm_live_pk_your_key_here
`

Installation

$3

The MCP server is available at: https://api.nextmavens.cloud/mcp

#### Claude Code

`bash
claude mcp add --transport http nextmavens \
--url https://api.nextmavens.cloud/mcp \
--header "Authorization: Bearer $NEXTMAVENS_API_KEY"
`

#### Cursor (IDE)

Create .cursor/mcp.json in your project:

`json
{
"mcpServers": {
"nextmavens": {
"type": "http",
"url": "https://api.nextmavens.cloud/mcp",
"headers": {
"Authorization": "Bearer ${env:NEXTMAVENS_API_KEY}"
}
}
}
}
`

Then set your API key:
`bash
export NEXTMAVENS_API_KEY=nm_live_pk_your_key_here
`

$3

For local development, you can run the MCP server locally:

`bash


Clone repository

git clone https://github.com/Mkid095/nextmavens-mcp-server.git
cd nextmavens-mcp-server

Install dependencies

npm install

Build

npm run build

Run with your API key

NEXTMAVENS_API_KEY=your_key npm start
`

Then configure with the local URL: http://localhost:3000/mcp

Available Tools

$3

| Tool | Description |
|------|-------------|
| nextmavens_query | Query data with filters (eq, neq, gt, gte, lt, lte, like, ilike, in) |
| nextmavens_insert | Insert new rows into a table |
| nextmavens_update | Update existing rows with filters |
| nextmavens_delete | Delete rows with filters |

$3

| Tool | Description |
|------|-------------|
| nextmavens_signin | Sign in a user with email and password |
| nextmavens_signup | Register a new user with optional name and tenantId |

$3

| Tool | Description |
|------|-------------|
| nextmavens_file_info | Get file metadata by ID |
| nextmavens_file_download_url | Generate download URL for a file |
| nextmavens_list_files | List files with optional filters (tenantId, fileType) |

$3

| Tool | Description |
|------|-------------|
| nextmavens_graphql | Execute GraphQL queries |
| nextmavens_graphql_introspect | Explore database schema |

Filter Operators

- eq: Equals
- neq: Not equals
- gt: Greater than
- gte: Greater than or equal
- lt: Less than
- lte: Less than or equal
- like: LIKE (case-sensitive)
- ilike: ILIKE (case-insensitive)
- in: IN array

Example Usage

$3

`
You: "Show me all users created in the last 7 days"

Claude: Uses nextmavens_query with filters
{
"table": "users",
"filters": [
{ "column": "created_at", "operator": "gte", "value": "2024-01-20" }
],
"orderBy": { "column": "created_at", "ascending": false }
}
`

$3

`
You: "Create a new post for user 123"

Claude: Uses nextmavens_insert
{
"table": "posts",
"data": {
"title": "New Post",
"content": "Post content",
"user_id": 123
}
}
`

$3

`
You: "What tables are available in my database?"

Claude: Uses nextmavens_graphql_introspect to retrieve schema
`

Testing Your Setup

$3

`bash
curl https://api.nextmavens.cloud/mcp
`

$3

`bash
curl -X POST https://api.nextmavens.cloud/mcp \
-H "Content-Type: application/json" \
-H "Authorization: Bearer nm_live_pk_your_key_here" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list",
"params": {}
}'
`

$3

`bash
claude mcp list
claude mcp get nextmavens
`

Troubleshooting

$3

- Ensure you have set the NEXTMAVENS_API_KEY environment variable
- Get your API key from the dashboard at portal.nextmavens.cloud

$3

- Run claude mcp list to verify the server is configured
- Try removing and re-adding: claude mcp remove nextmavens then add again

$3

- Verify your API key is valid and has the correct permissions
- Get a new key from the dashboard if needed

$3

- Check that you can reach https://api.nextmavens.cloud/mcp
- Verify no firewall is blocking the connection

Security

- Always use public keys (nm_live_pk_*) for client-side operations
- Keep secret keys (nm_live_sk_*`) secure and never expose them
- The MCP server requires API key authentication for all operations
- All traffic is encrypted over HTTPS

License

MIT

Links

- Developer Portal
- Documentation
- GitHub Repository