Reported issues for mcp-server

Pod holds 17 of 21 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.

Most discussed

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 · 2024-03-07 · closed · external user · 10 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. If we used the streaming mode 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 · 2025-03-08 · closed · outside contributor · 9 comments

Unsupported mime types for `puter.ai.chat` file upload

we have received a report from user about the model not being able to read some files, for example docx because of unsupported mime type

this can be seen best in this example https://docs.puter.com/playground/ai-resume-analyzer/

here are 3 example files you can try:

Resume.pdf joma.txt resume.docx

Read the thread · 2025-12-23 · closed · 6 comments

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 · 2025-10-12 · closed · external user · 5 comments

Show worker sandbox app_uuid when running `puter.workers.get`

https://docs.puter.com/Workers/get/

hi team, ideally we can show the sandbox app_uuid when running the get command having this available will allow us (or ai agent) to easily debug the shared kv store, since we can access app's kv using its app_uuid

Read the thread · 2026-08-14 · closed · 4 comments

Add Meta API direct integration

https://research.meta.ai/blog/introducing-muse-code-and-muse-spark-1-2 http://dev.meta.ai/

Read the thread · 2026-08-07 · closed · 4 comments

Add example of function call with streaming mode

Right now in our docs, the example for function call uses non streaming mode https://docs.puter.com/AI/chat/#function-calling

We would like to add example to use it in streaming mode

this should be possible given all the providers behind the scenes we use also support it

reference of function call with streaming

Read the thread · 2026-01-28 · closed · 4 comments

Enable tool calling (web search) for openai direct integration

newer openai models support features that are done via their Responses API tool calling

we have received a feedback to enable this on puter as well

Read the thread · 2025-12-23 · closed · 3 comments

Most recent

[Tests] Add unit tests for XAIImageProvider

XAIImageProvider.ts has no tests. Add an offline XAIImageProvider.test.ts (separate from any future integration test) covering size/format params, request shape, error paths, and cost reporting.

Read the thread · 2026-05-08 · closed · 0 comments

Add Moonshot AI Integration

Add Moonshot 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 · 2026-05-03 · closed · outside contributor · 0 comments

Add Anthropic API compatibility

hi team, as the title suggests, is to add an anthropic compatible api in addition to our existing openai compatibility turns out anthropic has their own compatible api

one use case blocked by this is using claude code, because it doesn't accept openai compatibility

reference for anthropic compatible api: https://docs.ollama.com/api/anthropic-compatibility

Read the thread · 2026-02-26 · closed · 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 · 2025-12-05 · closed · external user · 1 comment

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

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

### Write AI tests around streaming responses

## Issue
We had some bugs with streaming for some models, which were missed during testing due to lack of streaming tests

## Request
Add test to get stream responses and read from them.

[Read the thread](https://github.com/HeyPuter/puter/issues/1722) · 2025-10-09 · closed · 2 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

### [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).