# OneSky MCP for AI Agents AI Agent Connect

> OneSky (App & Web Localization API). It lets you manage your entire translation pipeline, from creating project groups to tracking progress across dozens of languages, directly through your AI agent. Stop jumping between tabs to see if the Spanish strings are done or if the iOS app project is ready for export.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_hM5I4x0nbbcgZakSNqHK5TLTG2QgyADcKVAfTmnj/ai-agent-connect
- **Tags:** i18n, l10n, app-localization, translation-management, globalization

## Description

Localization is usually a mess of spreadsheets and constant status checks. You're constantly tab-switching between your project management tool and your translation platform just to see if the Spanish strings are ready or if the iOS app project is live. This Connector changes that. You can talk to your AI agent to set up entire project groups, launch new projects for mobile or web, and check the real-time progress of every language you're targeting. It handles the heavy lifting of organizing assets so you can focus on the actual product. Because Vinkius hosts this, you get a unified way to manage these complex global workflows without the manual overhead. You just tell your agent what needs to happen, and it handles the API calls to get the job done.

## Tools

### create_project
Create a new project within a project group. This is how you start a specific localization task.

### delete_file
Delete a file from a project. Use this to remove outdated or incorrect source files from your current task.

### list_all_locales
List all locales supported by OneSky. Use this to see every language you can target globally.

### list_enabled_languages
List enabled languages of a project group. This shows you which markets are currently active in a specific group.

### list_import_tasks
List import tasks for a project. Use this to see if your source files were processed correctly.

### list_orders
List orders for a project. This gives you a high-level view of all active work.

### list_project_groups
List all project groups. Use this to see your entire organizational structure.

### list_project_languages
List languages of a project with translation progress. This gives you a quick status report on all languages.

### list_project_types
List all available project types. Use this to see what formats OneSky supports for your tech stack.

### list_projects
List projects of a project group. This helps you see all active tasks within a specific category.

### translation_status
Return the progress of the translation of a specific file. Use this to see exactly how much of a file is done.

### update_project
Update project details. This lets you change the metadata or settings of an existing project.

### upload_file
Upload a file to a project. This is how you send your source strings to the translation team.

### delete_project_group
Remove a project group. This helps keep your workspace clean of old campaigns.

### list_uploaded_files
List uploaded files for a project. Use this to verify which source files are currently in the system.

### show_project
Retrieve details of a project. This gives you the full metadata for a specific localization task.

### create_order
Create an order. This allows you to start new translation requests quickly.

### create_project_group
Create a new project group. Use this to organize your localization assets by platform or product line.

### delete_project
Remove a project. This deletes a specific localization task from your active list.

### export_app_store_description
Export translations of App Store Description in JSON. This gets your mobile metadata ready for the store.

### export_multilingual_file
Export translations in multilingual formats. This lets you grab all languages at once for your dev team.

### export_translations
Export translations for a specific locale and source file. This is perfect for pulling specific language sets.

### make_quotation
Make a quotation for translation. This helps you get cost estimates for new localization work.

### show_import_task
Show details of an import task. Use this to debug issues with file uploads.

### show_order_details
Show details of an order. This provides a deep dive into a specific translation request.

### show_project_group
Retrieve details of a specific project group. Use this to see the configuration of a group.

## Prompt Examples

**Prompt:** 
```
What's the status of the French translations for our new mobile app project?
```

**Response:** 
```
I've checked the progress for your mobile app project. Here is the current status for the French locale:

| Language | Progress | Status |
| :--- | :--- | :--- |
| French | 88% | In Progress |

Most of the strings are finished. Would you like me to check the status of any other languages?
```

**Prompt:** 
```
Create a new project group called 'Summer Sale' and list all the languages we can use for it.
```

**Response:** 
```
I've created the new project group **Summer Sale**. 

Here are the languages you can use for this group:
- English (en)
- Spanish (es)
- French (fr)
- German (de)
- Portuguese (pt)
- Japanese (ja)

Would you like to start adding projects to this group?
```

**Prompt:** 
```
Can you export the App Store descriptions for the current project into a JSON file?
```

**Response:** 
```
I've exported the App Store descriptions for your current project. You can find the JSON file ready for your next build.

**File Details:**
- **Format:** JSON
- **Content:** App Store Descriptions
- **Status:** Ready for export

Is there anything else you need for the store submission?
```

## Capabilities

### Create new project groups
Set up organized buckets for different platforms like iOS, Android, or Web.

### Launch translation projects
Start new localization tasks for specific products or campaigns.

### Check real-time progress
See exactly how much of a specific file is translated at any moment.

### Export multilingual files
Grab all localized strings for your dev team in one go.

### List supported locales
See every language available for your global expansion.

### Manage project files
Upload source files and manage the assets within your projects.

## Use Cases

### Checking French translation status
A product manager needs to know if the French translation for the new marketing site is done. They ask the agent for the status of the French file using `translation_status`.

### Exporting mobile metadata
A developer wants to export all the localized strings for the Android app. They ask the agent to export the multilingual file using `export_multilingual_file`.

### Setting up a holiday campaign
A localization lead needs to create a new group for a 'Holiday Campaign' and add five new projects to it using `create_project_group` and `create_project`.

### Getting a cost estimate
A manager wants to see a cost estimate for a new project. They ask the agent to make a quotation for the translation using `make_quotation`.

## Benefits

- Stop manual status checking by using `translation_status` to see real-time progress of every file.
- Organize your entire localization workspace by using `create_project_group` for different platforms like iOS or Web.
- Get your app store metadata ready faster by using `export_app_store_description` to grab JSON files.
- Ensure global coverage by using `list_all_locales` to see every language you can target globally.
- Speed up project setup by using `create_project` to launch new localization tasks without clicking through menus.
- Keep your workspace organized by using `delete_project_group` to prune old campaigns and outdated data.

## How It Works

The bottom line is you get a conversational interface for your entire translation pipeline.

1. Connect your OneSky API keys to the Connector.
2. Tell your AI agent which project group or project to focus on.
3. Get real-time updates on translation status or export files directly.

## Frequently Asked Questions

**Does the OneSky MCP handle multiple platforms?**
Yes, it supports creating projects for iOS, Android, and Web. You can organize these into different groups to keep your mobile and web assets separate.

**How do I check if my translation files are finished?**
You can ask your agent for the translation status of a specific file. It will return the exact progress percentage for that locale.

**Can I use this to manage my project groups?**
Yes, you can list, create, and delete project groups. It's a great way to organize your localization assets by region or product line.

**Does it support exporting specific file formats?**
Yes, it can export translations in various multilingual formats or as specific JSON files for App Store descriptions.

**How do I see which languages are available?**
You can ask your agent to list all supported locales. This helps you see every market OneSky can cover.

**Can I use the OneSky MCP to get cost estimates?**
Yes, you can use the make_quotation tool to get a price estimate for new translation work.

**How can I check the translation progress for a specific project?**
You can use the `list_project_languages` tool by providing the Project ID. It will return a list of all languages associated with the project along with their respective translation progress percentages.

**Can I see which project types OneSky supports through this agent?**
Yes, simply run the `list_project_types` tool. It will provide a comprehensive list of all available project formats, such as 'website', 'ios', or 'android', that you can use when creating new projects.

**Is it possible to create a new project group directly from the conversation?**
Absolutely. Use the `create_project_group` tool, specifying the name and optionally the base locale. The agent will handle the API request and confirm the creation of your new group.