feat(api): add claude 4 models, files API, code execution tool, MCP connector and more

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 21
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic%2Fanthropic-087f1149681ef9bc1074184df28ed4b4b9cc37b86cba50eb18e6c18452864446.yml
-openapi_spec_hash: 2007ff815a3f39af8cebe1976d50f17d
-config_hash: 7b88da171a1b1bdb963ec2311e417cbe
+configured_endpoints: 26
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic%2Fanthropic-1fdf23e8226430012c21819427e8d1ed16c08c0fb2d4abf69b8e318a42e99552.yml
+openapi_spec_hash: 836bbb4ab7c33c37456d1842876d7aba
+config_hash: 7b17fe2f10f5942177ff51b0a13506fa

README.md

@@ -398,6 +398,23 @@ message = client.messages.create(
 print(message.metadata)
 ```
 
+## File uploads
+
+Request parameters that correspond to file uploads can be passed as `bytes`, or a [`PathLike`](https://docs.python.org/3/library/os.html#os.PathLike) instance or a tuple of `(filename, contents, media type)`.
+
+```python
+from pathlib import Path
+from anthropic import Anthropic
+
+client = Anthropic()
+
+client.beta.files.upload(
+    file=Path("/path/to/file"),
+)
+```
+
+The async client uses the exact same interface. If you pass a [`PathLike`](https://docs.python.org/3/library/os.html#os.PathLike) instance, the file contents will be read asynchronously automatically.
+
 ## Handling errors
 
 When the library is unable to connect to the API (for example, due to network connection problems or a timeout), a subclass of `anthropic.APIConnectionError` is raised.

api.md

@@ -200,6 +200,7 @@ from anthropic.types.beta import (
     BetaBase64PDFBlock,
     BetaBase64PDFSource,
     BetaCacheControlEphemeral,
+    BetaCacheCreation,
     BetaCitationCharLocation,
     BetaCitationCharLocationParam,
     BetaCitationContentBlockLocation,
@@ -210,12 +211,32 @@ from anthropic.types.beta import (
     BetaCitationsConfigParam,
     BetaCitationsDelta,
     BetaCitationsWebSearchResultLocation,
+    BetaCodeExecutionOutputBlock,
+    BetaCodeExecutionOutputBlockParam,
+    BetaCodeExecutionResultBlock,
+    BetaCodeExecutionResultBlockParam,
+    BetaCodeExecutionTool20250522,
+    BetaCodeExecutionToolResultBlock,
+    BetaCodeExecutionToolResultBlockContent,
+    BetaCodeExecutionToolResultBlockParam,
+    BetaCodeExecutionToolResultBlockParamContent,
+    BetaCodeExecutionToolResultError,
+    BetaCodeExecutionToolResultErrorCode,
+    BetaCodeExecutionToolResultErrorParam,
+    BetaContainer,
+    BetaContainerUploadBlock,
+    BetaContainerUploadBlockParam,
     BetaContentBlock,
     BetaContentBlockParam,
     BetaContentBlockSource,
     BetaContentBlockSourceContent,
+    BetaFileDocumentSource,
+    BetaFileImageSource,
     BetaImageBlockParam,
     BetaInputJSONDelta,
+    BetaMCPToolResultBlock,
+    BetaMCPToolUseBlock,
+    BetaMCPToolUseBlockParam,
     BetaMessage,
     BetaMessageDeltaUsage,
     BetaMessageParam,
@@ -232,6 +253,9 @@ from anthropic.types.beta import (
     BetaRawMessageStreamEvent,
     BetaRedactedThinkingBlock,
     BetaRedactedThinkingBlockParam,
+    BetaRequestMCPServerToolConfiguration,
+    BetaRequestMCPServerURLDefinition,
+    BetaRequestMCPToolResultBlockParam,
     BetaServerToolUsage,
     BetaServerToolUseBlock,
     BetaServerToolUseBlockParam,
@@ -261,6 +285,7 @@ from anthropic.types.beta import (
     BetaToolResultBlockParam,
     BetaToolTextEditor20241022,
     BetaToolTextEditor20250124,
+    BetaToolTextEditor20250429,
     BetaToolUnion,
     BetaToolUseBlock,
     BetaToolUseBlockParam,
@@ -276,6 +301,7 @@ from anthropic.types.beta import (
     BetaWebSearchToolResultBlockParam,
     BetaWebSearchToolResultBlockParamContent,
     BetaWebSearchToolResultError,
+    BetaWebSearchToolResultErrorCode,
 )
 ```
 
@@ -310,3 +336,19 @@ Methods:
 - <code title="delete /v1/messages/batches/{message_batch_id}?beta=true">client.beta.messages.batches.<a href="./src/anthropic/resources/beta/messages/batches.py">delete</a>(message_batch_id) -> <a href="./src/anthropic/types/beta/messages/beta_deleted_message_batch.py">BetaDeletedMessageBatch</a></code>
 - <code title="post /v1/messages/batches/{message_batch_id}/cancel?beta=true">client.beta.messages.batches.<a href="./src/anthropic/resources/beta/messages/batches.py">cancel</a>(message_batch_id) -> <a href="./src/anthropic/types/beta/messages/beta_message_batch.py">BetaMessageBatch</a></code>
 - <code title="get /v1/messages/batches/{message_batch_id}/results?beta=true">client.beta.messages.batches.<a href="./src/anthropic/resources/beta/messages/batches.py">results</a>(message_batch_id) -> <a href="./src/anthropic/types/beta/messages/beta_message_batch_individual_response.py">JSONLDecoder[BetaMessageBatchIndividualResponse]</a></code>
+
+## Files
+
+Types:
+
+```python
+from anthropic.types.beta import DeletedFile, FileMetadata
+```
+
+Methods:
+
+- <code title="get /v1/files?beta=true">client.beta.files.<a href="./src/anthropic/resources/beta/files.py">list</a>(\*\*<a href="src/anthropic/types/beta/file_list_params.py">params</a>) -> <a href="./src/anthropic/types/beta/file_metadata.py">SyncPage[FileMetadata]</a></code>
+- <code title="delete /v1/files/{file_id}?beta=true">client.beta.files.<a href="./src/anthropic/resources/beta/files.py">delete</a>(file_id) -> <a href="./src/anthropic/types/beta/deleted_file.py">DeletedFile</a></code>
+- <code title="get /v1/files/{file_id}/content?beta=true">client.beta.files.<a href="./src/anthropic/resources/beta/files.py">download</a>(file_id) -> BinaryAPIResponse</code>
+- <code title="get /v1/files/{file_id}?beta=true">client.beta.files.<a href="./src/anthropic/resources/beta/files.py">retrieve_metadata</a>(file_id) -> <a href="./src/anthropic/types/beta/file_metadata.py">FileMetadata</a></code>
+- <code title="post /v1/files?beta=true">client.beta.files.<a href="./src/anthropic/resources/beta/files.py">upload</a>(\*\*<a href="src/anthropic/types/beta/file_upload_params.py">params</a>) -> <a href="./src/anthropic/types/beta/file_metadata.py">FileMetadata</a></code>

examples/mcp.py

@@ -0,0 +1,31 @@
+#!/usr/bin/env -S rye run python
+
+from anthropic import Anthropic
+
+anthropic = Anthropic()
+
+response = anthropic.beta.messages.create(
+    model="claude-3-7-sonnet-20250219",
+    max_tokens=1000,
+    messages=[
+        {
+            "role": "user",
+            "content": 'Calculate 1+2',
+        },
+    ],
+    mcp_servers=[
+        {
+            "type": "url",
+            "url": "http://example-server.modelcontextprotocol.io/sse",
+            "name": "example",
+            "tool_configuration": {  # Optional, by default all tools are enabled
+                "enabled": True,
+                "allowed_tools": ['echo', 'add'],  # Optional
+            },
+        }
+    ],
+    extra_headers={
+        "anthropic-beta": "mcp-client-2025-04-04",
+    },
+)
+print(response.content)

examples/messages_stream.py

@@ -1,3 +1,5 @@
+#!/usr/bin/env -S rye run python
+
 import asyncio
 
 from anthropic import AsyncAnthropic

src/anthropic/_base_client.py

@@ -689,12 +689,12 @@ def platform_headers(self) -> Dict[str, str]:
         # https://github.com/python/cpython/issues/88476
         return platform_headers(self._version, platform=self._platform)
 
-    def _calculate_nonstreaming_timeout(self, max_tokens: int) -> Timeout:
+    def _calculate_nonstreaming_timeout(self, max_tokens: int, max_nonstreaming_tokens: int | None) -> Timeout:
         maximum_time = 60 * 60
         default_time = 60 * 10
 
         expected_time = maximum_time * max_tokens / 128_000
-        if expected_time > default_time:
+        if expected_time > default_time or (max_nonstreaming_tokens and max_tokens > max_nonstreaming_tokens):
             raise ValueError(
                 "Streaming is strongly recommended for operations that may take longer than 10 minutes. "
                 + "See https://github.com/anthropics/anthropic-sdk-python#long-requests for more details",

src/anthropic/_constants.py

@@ -16,3 +16,11 @@
 HUMAN_PROMPT = "\n\nHuman:"
 
 AI_PROMPT = "\n\nAssistant:"
+
+MODEL_NONSTREAMING_TOKENS = {
+    "claude-opus-4-20250514": 8_192,
+    "claude-opus-4-0": 8_192,
+    "claude-4-opus-20250514": 8_192,
+    "anthropic.claude-opus-4-20250514-v1:0": 8_192,
+    "claude-opus-4@20250514": 8_192,
+}

src/anthropic/_files.py

@@ -34,7 +34,7 @@ def assert_is_file_content(obj: object, *, key: str | None = None) -> None:
     if not is_file_content(obj):
         prefix = f"Expected entry at `{key}`" if key is not None else f"Expected file input `{obj!r}`"
         raise RuntimeError(
-            f"{prefix} to be bytes, an io.IOBase instance, PathLike or a tuple but received {type(obj)} instead."
+            f"{prefix} to be bytes, an io.IOBase instance, PathLike or a tuple but received {type(obj)} instead. See https://github.com/anthropics/anthropic-sdk-python/tree/main#file-uploads"
         ) from None
 
 

src/anthropic/lib/streaming/_beta_messages.py

@@ -329,7 +329,7 @@ def build_events(
                     )
                 )
         elif event.delta.type == "input_json_delta":
-            if content_block.type == "tool_use":
+            if content_block.type == "tool_use" or content_block.type == "mcp_tool_use":
                 events_to_fire.append(
                     build(
                         BetaInputJsonEvent,
@@ -425,7 +425,7 @@ def accumulate_event(
             if content.type == "text":
                 content.text += event.delta.text
         elif event.delta.type == "input_json_delta":
-            if content.type == "tool_use":
+            if content.type == "tool_use" or content.type == "mcp_tool_use":
                 from jiter import from_json
 
                 # we need to keep track of the raw JSON string as well so that we can
@@ -455,6 +455,7 @@ def accumulate_event(
             if TYPE_CHECKING:  # type: ignore[unreachable]
                 assert_never(event.delta)
     elif event.type == "message_delta":
+        current_snapshot.container = event.delta.container
         current_snapshot.stop_reason = event.delta.stop_reason
         current_snapshot.stop_sequence = event.delta.stop_sequence
         current_snapshot.usage.output_tokens = event.usage.output_tokens

src/anthropic/lib/vertex/_auth.py

@@ -19,7 +19,9 @@ def load_auth(*, project_id: str | None) -> tuple[Credentials, str]:
     try:
         from google.auth.transport.requests import Request  # type: ignore[import-untyped]
     except ModuleNotFoundError as err:
-        raise RuntimeError(f'Could not import google.auth, you need to install the SDK with `pip install anthropic[vertex]`') from err
+        raise RuntimeError(
+            f"Could not import google.auth, you need to install the SDK with `pip install anthropic[vertex]`"
+        ) from err
 
     credentials, loaded_project_id = google_auth.default(
         scopes=["https://www.googleapis.com/auth/cloud-platform"],