# Reported issues for mcp-server

Pod holds 13 of 13 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 [mcp-server](/mcp/mcp-server).

## Most discussed

### Add support for video generation to puter.js using Sora 2

Hey everyone, I just have to say that somebody should add support for `sora-2` and `sora-2-pro` models with the Sora-extend method to generate videos beyond the 12-second limit.

Here’s some links to the stuff:

Models in the OpenAI API: https://platform.openai.com/docs/models/sora-2 and https://platform.openai.com/docs/models/sora-2-pro
The Sora-extend method: https://github.com/mshumer/sora-extend (see the .ipynb file)

Anyways, adding the feature to the puter.js api would be appreciated!

[Read the thread](https://github.com/HeyPuter/puter/issues/1742) · 2025-10-12 · closed · external user · 5 comments

### Formalize current request/response formats for LLM calls via Puter's driver interface

We need to document the current accepted inputs and expected outputs for Puter's AI driver. This task is a prerequisite for regression testing. Since regressions can occur due to any layer between puter.js and the real LLM provider, we will need to document:
- from the perspective of an API caller
- from the perspective of a puter.js user

[Read the thread](https://github.com/HeyPuter/puter/issues/1377) · 2025-07-27 · closed · outside contributor · 2 comments

### Adapt `ai` command to use tool use / function calling

**clarification:** this issue is for the `ai` command in Puter's terminal, so that it uses tool calls to look at command history instead of data included in the prompt.

Recently the AI command [gained the ability to run commands](https://github.com/HeyPuter/puter/pull/1156). If we used the [streaming mode](https://docs.puter.com/playground/?example=ai-chat-stream) of the `puter-chat-completion` driver interface it would be possible to the AI command to take multiple steps and command execution 

[Read the thread](https://github.com/HeyPuter/puter/issues/1163) · 2025-03-08 · closed · outside contributor · 9 comments

### storage providers

I noticed from the source code that it seems to support the S3 storage protocol, and I would like to ask how to configure S3 related information

[Read the thread](https://github.com/HeyPuter/puter/issues/643) · 2024-07-30 · closed · external user · 2 comments

### which prerequsites are needed

I have tried to install on PoP!OS and on Mint 20. on both system, the script is failing.

Could you please add a section with which prerequsites are needed in your Readme file ?

[Read the thread](https://github.com/HeyPuter/puter/issues/301) · 2024-04-20 · closed · external user · 3 comments

### CompositeError: failed to initialize these services: database

**Issue Description**

The first time I started, there was a table creation error.

**Steps to Reproduce**

**Expected & Actual Behavior**

**Addition Information or Screenshots (if applicable)**

```shell
{
    "error": "CompositeError: failed to initialize these services: database\n    at Container.init (/data/git/puter/packages/backend/src/services/Container.js:81:19)\n    at process.processTicksAndRejections (node:internal/process/task_queues:95:5)\n    at async Kernel._install_m

[Read the thread](https://github.com/HeyPuter/puter/issues/258) · 2024-04-10 · closed · external user · 2 comments

### Feature Request: Allow for teams + team level development of apps

As a developer I want to be able to co-author an app in Puter.

This may be achievable via teams. 

I can create, view, join, leave, delete teams.
I can manage the team members and control their access ( admin, viewer, editor, beta tester )
I can publish an app via a team.
I can see other teams.
Users must have an account on puter to be able to join a team.

[Read the thread](https://github.com/HeyPuter/puter/issues/108) · 2024-03-15 · closed · external user · 3 comments

### Is there any API documentation for the backend?

I would like to build my API server for this front end. It would be helpful if you make the backend open-source as well. I just need the API requests payload's JSON format and the response JSON structure. By the way awesome project man hats off

[Read the thread](https://github.com/HeyPuter/puter/issues/44) · 2024-03-07 · closed · external user · 10 comments

## Most recent

### Add Moonshot AI Integration

Add [Moonshot AI](https://platform.kimi.ai/) (Kimi) as a new AI provider integration to Puter. Moonshot AI offers the Kimi model family, featuring long context windows (up to 262K tokens), multimodal input (text, image, video), built-in reasoning/thinking mode, and tool calling with up to 128 functions. Their flagship model `kimi-k2.6` is a trillion-parameter model competitive with frontier models.

Moonshot AI provides an OpenAI-compatible API (`https://api.moonshot.ai/v1`), which simplifies in

[Read the thread](https://github.com/HeyPuter/puter/issues/2891) · 2026-05-03 · closed · outside contributor · 0 comments

### AI SDK support

Is it possible to use puter with AI SDK? It would be helpful if we could do that so we can easily build agents.

[Read the thread](https://github.com/HeyPuter/puter/issues/2099) · 2025-12-05 · closed · external user · 1 comment

### Error 400 "usage-limited-chat" when using puter.ai.chat with model specification

<img width="757" height="210" alt="Image" src="https://github.com/user-attachments/assets/11956fb4-d5c3-4d93-92f3-c0ad54f259ef" />

**Description**
Getting a 400 error with delegate "usage-limited-chat" when calling `puter.ai.chat()` with a model specification in the options parameter.

 **Error Details**
```
Error: "BeyondAPIError"
code: "error_400_from_delegate"
delegate: "usage-limited-chat"
message: "Error 400 from delegate 'usage-limited-chat': Permission denied."
status: 400

**Code Exampl

[Read the thread](https://github.com/HeyPuter/puter/issues/1968) · 2025-11-14 · closed · external user · 2 comments

### [doc] Puter Drivers (code & architecture)

## Documentation Task

Although we already have [written](https://github.com/HeyPuter/puter/wiki/src-backend-howto_make_driver) and [video](https://www.youtube.com/watch?v=8znQmrKgNxA) documentation for contributing new **drivers** on Puter, we haven't documented very much about how Puter's driver subsystem works or its architecture.

### Recommended Proceedure
- Analyze the contents of [the driver service's code](https://github.com/HeyPuter/puter/tree/main/src/backend/src/services/drivers). The

[Read the thread](https://github.com/HeyPuter/puter/issues/1132) · 2025-03-01 · closed · outside contributor · 0 comments

### [doc] contributors/extensions/events

## Documentation Task

Puter extensions can listen to events, but we only have a few events documented. The task of this issue is to bring the documentation back in sync with all the events supported by Puter's backend.

### Instructions & Support
Video instruction: https://youtu.be/kdKu2znW_R4
Example commit: 3bd12fb5f27f045cb5fbd5a301757e9645e31456

### Editing the Document
- [wiki page](https://github.com/HeyPuter/puter/wiki/contributors-extensions-events) (do not edit)
- [source document](ht

[Read the thread](https://github.com/HeyPuter/puter/issues/1122) · 2025-02-25 · closed · outside contributor · 1 comment

The remaining reports are on [the project's issue tracker](https://github.com/HeyPuter/puter/issues).
