# Reported issues for ainative-strapi-mcp-server

Pod holds 9 of 9 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to [ainative-strapi-mcp-server](/mcp/ainative-strapi-mcp-server).

## Most discussed

### Package Configuration and NPM Setup

## Summary
Configured package.json for npm publication and distribution.

## Configuration Details

### Package Metadata
- **Name**: ainative-strapi-mcp-server
- **Version**: 1.0.0
- **License**: MIT
- **Author**: AINative Studio

### Binary Configuration
- **Executable**: ainative-strapi-mcp
- **Main Entry**: index.js
- **Type**: CommonJS

### Dependencies
- @modelcontextprotocol/sdk: ^1.0.0
- axios: ^1.7.7

### NPM Publishing
- Public access
- Registry: https://registry.npmjs.org/
- Files incl

[Read the thread](https://github.com/AINative-Studio/ainative-strapi-mcp-server/issues/4) · 2025-12-13 · closed · 1 comment

### Comprehensive Test Suite - 100% Pass Rate

## Summary
Created comprehensive test suite covering all 18 MCP operations plus error handling and edge cases.

## Test Coverage

### Test Suite 1: Comprehensive Tests
**Result: 27/27 tests passing (100% success rate)**

#### Coverage Breakdown
- ✅ Authentication (1 test)
- ✅ Metadata Operations (3 tests) - authors, categories, tags
- ✅ Blog Post Operations (6 tests)
- ✅ Tutorial Operations (5 tests)
- ✅ Event Operations (6 tests)
- ✅ Error Handling (2 tests)
- ✅ Edge Cases (3 tests)

### Test S

[Read the thread](https://github.com/AINative-Studio/ainative-strapi-mcp-server/issues/3) · 2025-12-13 · closed · 1 comment

### Blog Post Operations: documentId Fix

## Issue
Blog post operations were failing with 404 errors because they were using numeric `id` instead of string `documentId`.

## Root Cause
- Strapi 5 uses `documentId` (string) for single document operations
- Initial implementation used numeric `id` parameter
- Created blog posts returned `documentId` in response, but operations expected `id`

## Fix Applied
1. **Schema Updates**: Changed all blog post operation schemas from `id: { type: 'number' }` to `document_id: { type: 'string' }`
2. *

[Read the thread](https://github.com/AINative-Studio/ainative-strapi-mcp-server/issues/2) · 2025-12-13 · closed · 1 comment

### Initial MCP Server Implementation

## Summary
Implemented the core MCP (Model Context Protocol) server for AINative Strapi CMS integration.

## Implementation Details

### Core Features
- ✅ MCP SDK integration (@modelcontextprotocol/sdk v1.0.0)
- ✅ Strapi Content Manager API integration
- ✅ JWT authentication with automatic token management
- ✅ CommonJS module system for broad compatibility

### Operations Implemented (18 total)
**Blog Posts (8 operations)**
- strapi_create_blog_post
- strapi_list_blog_posts (with advanced filter

[Read the thread](https://github.com/AINative-Studio/ainative-strapi-mcp-server/issues/1) · 2025-12-13 · closed · 1 comment

### test: Add Integration Test for Upload

Create a test script that attempts to upload a dummy .png file to a running Strapi instance and asserts that a valid ID is returned. Part of #5.

[Read the thread](https://github.com/AINative-Studio/ainative-strapi-mcp-server/issues/8) · 2026-01-27 · open · 0 comments

### docs: Document Upload Tool

Update README.md and STRAPI_MCP_QUICK_START.md with examples of how to use the new upload tool. Part of #5.

[Read the thread](https://github.com/AINative-Studio/ainative-strapi-mcp-server/issues/9) · 2026-01-27 · open · 0 comments

### feat: Implement File Upload Logic

Implement the handler for strapi_upload_file. It should read the file from the local filesystem using fs, construct a FormData object, POST to ${STRAPI_URL}/api/upload with correct headers, and return the uploaded file metadata. Part of #5.

[Read the thread](https://github.com/AINative-Studio/ainative-strapi-mcp-server/issues/7) · 2026-01-27 · open · 0 comments

### feat: Define strapi_upload_file Schema

Update index.js to include the strapi_upload_file tool definition in the ListToolsRequestSchema handler. Define input arguments for filePath and fileInfo. Part of #5.

[Read the thread](https://github.com/AINative-Studio/ainative-strapi-mcp-server/issues/6) · 2026-01-27 · open · 0 comments

## Most recent

### feat: Add strapi_upload_file Tool

## Context
The current MCP server lacks the ability to upload assets (images, diagrams) to Strapi. This blocks the automated publishing pipeline from handling rich content.

## Goal
Implement a new tool `strapi_upload_file` that allows agents to upload local files to the Strapi Media Library.

## Requirements
- Tool Name: `strapi_upload_file`
- Inputs: `filePath` (string, required), `fileInfo` (object: altText, caption, name).
- Output: JSON object containing the Strapi File ID and URL.
- API: U

[Read the thread](https://github.com/AINative-Studio/ainative-strapi-mcp-server/issues/5) · 2026-01-27 · open · 0 comments

The remaining reports are on [the project's issue tracker](https://github.com/AINative-Studio/ainative-strapi-mcp-server/issues).