MCP Server Framework and Tool Development library for building custom capabilities into agents.
Find a file
Renato Byrro 30739dc44a
Support for multiple Atlassian Clouds in the Jira Toolkit (#506)
Adds `Jira.GetAvailableAtlassianClouds` tool, which provides a list of
clouds available (checking which Clouds were actually authorized by the
current auth token).

Refactors the interface of every tool to accept an `atlassian_cloud_id`
argument (when not provided, try to get a unique cloud ID - if multiple
are available, raises a Retryable error with the list of Clouds
available instructing to select one).

Gets rid of all caching. Now storing the global semaphore to the context
object. The global semaphore is important because some tools depend on
others, and each tool instantiates its own Jira HTTP client. Storing the
semaphore in the context object ensures that all HTTP clients will
respect the concurrency limit.

Removes from tool responses the Atlassian URLs linking to objects in the
Jira GUI (users, projects, issues, etc. We do not keep track of the
cloud name anymore, which is required to build the objects' URLs.

Extends/refactors unit tests accordingly.

Evals checking LLM behavior when:

- a cloud ID is explicitly mentioned in the prompt;
- no cloud ID is mentioned;
- a "multiple clouds available" error is raised and the user is prompted
to pick one;
- user request triggers another tool call after having previously picked
a cloud ID (in the same chat context);
2025-07-23 18:09:54 -03:00
.github skip tests with GHA secrets on forks (#496) 2025-07-17 10:27:24 -07:00
.vscode 🏗️ Restructure: Multi-Package Architecture + uv Migration (#412) 2025-06-11 16:48:17 -07:00
contrib Common changes in all toolkits (#345) 2025-04-04 09:32:37 -07:00
docker Fix setuptools install (#508) 2025-07-22 17:38:40 -07:00
examples Update dependencies (#473) 2025-07-02 14:37:13 -03:00
libs Fix arcade worker list endpoints (#504) 2025-07-21 14:43:58 -07:00
porter Build staging from source (#421) 2025-06-10 12:05:00 -07:00
schemas/preview Tool Metadata (#357) 2025-04-16 19:17:36 -08:00
toolkits Support for multiple Atlassian Clouds in the Jira Toolkit (#506) 2025-07-23 18:09:54 -03:00
.editorconfig Fix ruff (#64) 2024-09-25 09:47:30 -07:00
.gitignore Remove toml (#210) 2025-01-17 09:56:43 -08:00
.pre-commit-config.yaml 🏗️ Restructure: Multi-Package Architecture + uv Migration (#412) 2025-06-11 16:48:17 -07:00
.prettierignore Fix ruff (#64) 2024-09-25 09:47:30 -07:00
.prettierrc.toml Fix ruff (#64) 2024-09-25 09:47:30 -07:00
.ruff.toml 🏗️ Restructure: Multi-Package Architecture + uv Migration (#412) 2025-06-11 16:48:17 -07:00
CONTRIBUTING.md 🏗️ Restructure: Multi-Package Architecture + uv Migration (#412) 2025-06-11 16:48:17 -07:00
cspell.config.yaml Replace arcade.client with arcadepy (#119) 2024-10-23 15:29:02 -07:00
LICENSE Update README and LICENSE (#220) 2025-01-23 19:43:48 -08:00
Makefile Update release containers GH Action (#439) 2025-06-17 10:21:08 -07:00
pyproject.toml Fix arcade worker list endpoints (#504) 2025-07-21 14:43:58 -07:00
README.md Update README.md (#450) 2025-06-17 18:02:45 -07:00
worker.toml Worker Deploy (#278) 2025-03-13 09:02:36 -07:00

DocumentationToolsQuickstartContact Us

Arcade AI Platform

Arcade is a developer platform that lets you build, deploy, and manage tools for AI agents.

This repository contains the core Arcade libraries, organized as separate packages for maximum flexibility and modularity:

  • arcade-core - Core platform functionality and schemas | Source code | pip install arcade-core |
  • arcade-tdk - Tool Development Kit with the @tool decorator | Source code | pip install arcade-tdk |
  • arcade-serve - Serving infrastructure for workers and MCP servers | Source code | pip install arcade-serve |
  • arcade-evals - Evaluation framework for testing tool performance | Source code | pip install 'arcade-ai[evals] |
  • arcade-cli - Command-line interface for the Arcade platform | Source code | pip install arcade-ai |

diagram

To learn more about Arcade.dev, check out our documentation.

Pst. hey, you, give us a star if you like it!

GitHub stars

Quick Start

Installation

For development, install all packages with dependencies using uv workspace:

# Install all packages and dev dependencies
uv sync --extra all --dev

# Or use the Makefile (includes pre-commit hooks)
make install

For production use, install individual packages as needed:

pip install arcade-ai          # CLI
pip install 'arcade-ai[evals]' # CLI + Evaluation framework
pip install 'arcade-ai[all]'   # CLI + Serving infra + eval framework + TDK
pip install arcade_serve       # Serving infrastructure
pip install arcade-tdk         # Tool Development Kit

Development

Use the Makefile for standard tasks:

# Run tests
make test

# Run linting and type checking
make check

# Build all packages
make build

# See all available commands
make help

Client Libraries

Support and Community