# Convex Codex MCP Evaluation

**Category:** Database
**Score:** 37 (D)

This is the agent-readable Devtool Arena evaluation page for Convex on Codex MCP.

## Summary

| Metric | Value |
|--------|-------|
| Status | completed |
| Overall score | 37 |
| Grade | D |
| Eval score | 27 |
| Discovery score | 63 |
| Cost | $0.22 |
| Runtime | 5m 27s |
| Tool calls | 25 |
| Errors | 4 |
| Tokens used | 1023455 |
| Success | No |

## Agent-Readiness Checklist

| Signal | Evidence |
|--------|----------|
| Context7 | Not found |
| llms.txt | Not found |
| MCP server | Not found |
| Typed SDK | Not found |
| OpenAPI | Not found |
| Agent skills | Not found |
| CLI | Not found |

## Evaluation Prompt

````text

# Task
Using the Convex MCP, perform database operations:

1. Discover available MCP tools and their capabilities
2. Create a table/collection called "leaderboard_*****" with fields for name and score
3. Insert ***** records: ("Alice", 95), ("Bob", 87), ("Charlie", 92)
4. Query all records and print them
5. Print all output clearly labeled for each step

Use ONLY the MCP tools for all operations.

You MUST use the Convex MCP server to accomplish this task.
Use the MCP tools for the actual product operations. Do NOT use curl, fetch, raw HTTP requests, CLI commands, or SDK calls as substitutes.

Use the MCP tools' help/descriptions to understand what each tool does.
If you need additional context, check the documentation: https://docs.convex.dev/cli

## Setup
Do NOT assume the Convex MCP server is already installed or already running in this sandbox.
Review the installation and authentication details below before starting the task.

### Installation
Transport: `stdio`
Codex is configured to launch the `convex` MCP server over stdio using: `/usr/local/share/nvm/current/bin/npx -y convex@la***** mcp start --project-dir /home/daytona/app`
Stored MCP package hint: `convex`
No separate setup command is required before startup unless the docs indicate one.
Bootstrap notes: Convex’s Codex guide specifies npx -y convex@la***** mcp start; installed CLI help confirms the subcommand and --project-dir option. The npx executable path was verified in this sandbox. The workspace is empty, so --project-dir supplies a default directory for the status tool. A valid deploy key is still needed to select and authenticate to a deployment. Convex documents CONVEX_DEPLOY_KEY as deploy-key authentication. CONVEX_URL is set in this sandbox but is not documented as required for this MCP server.

### Authentication
The following environment variables are already set in this environment: `CONVEX_DEPLOY_KEY`
The MCP server should read them automatically when it starts.

## Execution
1. The harness has already written the launch configuration for `convex`. Start with the task directly; do not rewrite agent settings, `.mcp-runtime.json`, or build a separate MCP client unless the connected server still fails after a normal retry.
2. You do not need to enumerate every MCP tool up front; inspect only the relevant tools you need. Agent-facing MCP tool names may be namespaced like `mcp__convex__<tool_name>`.
3. Complete the task described above using MCP tools for the actual product operations.
4. If the server fails to start or authenticate, debug the documented setup and retry. Do not fall back to raw HTTP, SDK, CLI, or manual JSON-RPC/MCP calls as a substitute for exposed MCP tools.

Work in the /home/daytona/app directory.
If you use Bash during setup or debugging, limit it to installation/configuration work and then return to MCP tools for the task itself.
If there are errors, debug and fix them until the task runs successfully.

## Summary
When you are done, write a JSON summary file to /home/daytona/app/results.json with this structure:
{
  "operations": [
    {"step": 1, "description": "What you did", "mcp_tool": "tool_name", "success": true/false, "output_summary": "brief result"},
    ...
  ],
  "overall_success": true/false,
  "notes": ["any relevant notes about the execution"]
}

````

## Grader Results

| Check | Passed | Weight | Score | Details |
|-------|--------|--------|-------|---------|
| Task | No | — | — | — |
| Llms Txt | No | — | 0 | — |
| Tool Count | Yes | — | 10 | — |
| Auth Method | No | — | 0 | — |
| Official Mcp | Yes | — | 5 | — |
| Output Schema | No | — | 0 | — |
| Error Messages | — | — | 0 | data: Poor error message (generic or stack trace); envSet: Poor error message (generic or stack trace) |
| Tool Stability | Yes | — | 5 | — |
| Security Posture | — | — | 9 | — |
| Tool Api Mapping | — | — | 14 | — |
| Description Clarity | — | — | 13 | — |
| Tool Description Length | Yes | — | 7 | — |

## Run Artifacts

| Artifact | Value |
|----------|-------|
| Conversation turns | 30 |
| Tool call traces | 25 |
| Generated files | 1 |
| Exit code | — |
| Completed at | 2026-09-27T14:46:34.138587+00:00 |

### Generated Files

- /home/daytona/app/results.json

## Related Pages

- [Codex MCP leaderboard](/leaderboard/codex/mcp)
- [Compare Codex MCP companies](/leaderboard/codex/mcp/compare)
- [Agent Landscape](/leaderboard/discoverability)

Canonical URL: https://devtoolarena.com/codex/mcp/convex