spice-mcp 0.1.2__tar.gz → 0.1.3__tar.gz

{spice_mcp-0.1.2 → spice_mcp-0.1.3}/.gitignore

@@ -21,3 +21,6 @@ bin/
 .github/
 .factory/
 debug_api.py
+
+# Local testing environment
+test_spice_mcp/

spice_mcp-0.1.3/.hypothesis/constants/03230d036f66298e

@@ -0,0 +1,4 @@
+# file: /Users/evandekim/Documents/spice_mcp/src/spice_mcp/mcp/tools/base.py
+# hypothesis_version: 6.142.5
+
+['query']

spice_mcp-0.1.3/.hypothesis/constants/06eb11a7027a88cd

@@ -0,0 +1,4 @@
+# file: /Users/evandekim/Documents/spice_mcp/src/spice_mcp/__init__.py
+# hypothesis_version: 6.142.5
+
+[]

spice_mcp-0.1.3/.hypothesis/constants/0f801575b114e021

@@ -0,0 +1,4 @@
+# file: /Users/evandekim/Documents/spice_mcp/src/spice_mcp/mcp/tools/sui_package_overview.py
+# hypothesis_version: 6.142.5
+
+['additionalProperties', 'array', 'default', 'hours', 'integer', 'items', 'number', 'object', 'packages', 'properties', 'required', 'string', 'sui_package_overview', 'timeout_seconds', 'tool', 'type']

spice_mcp-0.1.3/.hypothesis/constants/1eeb4d051122e156

@@ -0,0 +1,4 @@
+# file: /Users/evandekim/Documents/spice_mcp/src/spice_mcp/config.py
+# hypothesis_version: 6.142.5
+
+[500, '0.35', '15', '3', '30', '5', '5.0', '500', 'DUNE_API_KEY', 'DUNE_API_URL', 'SPICE_ARTIFACT_ROOT', 'SPICE_CACHE_DIR', 'SPICE_CACHE_MODE', 'SPICE_HTTP_BACKOFF', 'SPICE_HTTP_RETRIES', 'SPICE_HTTP_TIMEOUT', 'SPICE_QUERY_HISTORY', 'disabled', 'enabled', 'read_only', 'refresh', 'true']

spice_mcp-0.1.3/.hypothesis/constants/366c70be49a7442b

@@ -0,0 +1,4 @@
+# file: /Users/evandekim/Documents/spice_mcp/src/spice_mcp/service_layer/query_admin_service.py
+# hypothesis_version: 6.142.5
+
+[]

spice_mcp-0.1.3/.hypothesis/constants/4753a088eccf5421

@@ -0,0 +1,4 @@
+# file: /Users/evandekim/Documents/spice_mcp/src/spice_mcp/core/ports.py
+# hypothesis_version: 6.142.5
+
+[]

spice_mcp-0.1.3/.hypothesis/constants/4a324fb33357cad2

@@ -0,0 +1,4 @@
+# file: /Users/evandekim/Documents/spice_mcp/src/spice_mcp/adapters/dune/types.py
+# hypothesis_version: 6.142.5
+
+['large', 'medium']

spice_mcp-0.1.3/.hypothesis/constants/4cc858fdf36f013d

@@ -0,0 +1,4 @@
+# file: /Users/evandekim/Documents/spice_mcp/src/spice_mcp/mcp/tools/execute_query.py
+# hypothesis_version: 6.142.5
+
+[10.0, 1000, '4060379', 'DUNE_API_KEY', 'DUNE_API_KEY_present', 'GET', 'Query parameters', 'User-Agent', 'X-Dune-API-Key', 'additionalProperties', 'array', 'boolean', 'columns', 'compute_query_sha256', 'data', 'data_preview', 'debug_info', 'default', 'description', 'dune.com/queries', 'dune_error', 'dune_query', 'dune_state', 'duration_ms', 'enum', 'environment_vars', 'error', 'execution', 'execution_ended_at', 'execution_id', 'execution_started_at', 'extras', 'format', 'https://', 'integer', 'items', 'large', 'limit', 'max_age', 'medium', 'metadata', 'next_offset', 'next_uri', 'number', 'object', 'offset', 'parameters', 'performance', 'poll', 'preview', 'properties', 'query', 'query_id', 'query_sha256', 'query_sql', 'query_type', 'query_url', 'raw', 'raw_sql', 'refresh', 'required', 'rowcount', 'sample_count', 'sort_by', 'state', 'status', 'string', 'submitted', 'success', 'suggested_action', 'template_query_id', 'timeout_seconds', 'tool', 'type', 'unknown', 'url', 'write_sql_artifact']

spice_mcp-0.1.3/.hypothesis/constants/5405706eff340311

@@ -0,0 +1,4 @@
+# file: /Users/evandekim/Documents/spice_mcp/src/spice_mcp/adapters/dune/urls.py
+# hypothesis_version: 6.142.5
+
+['&', ',', '.', '/', '/api/v1/query/(\\d+)', '/query/', '/query/{query_id}', '?', 'DUNE_API_KEY', 'DUNE_API_URL', 'X-Dune-API-Key', 'execution_results', 'execution_status', 'invalid query id: ', 'params', 'query', 'query_create', 'query_execution', 'query_fork', 'query_parameters', 'query_results', 'query_results_json']

spice_mcp-0.1.3/.hypothesis/constants/6cfc775ad89a5b6a

@@ -0,0 +1,4 @@
+# file: /Users/evandekim/Documents/spice_mcp/src/spice_mcp/service_layer/sui_service.py
+# hypothesis_version: 6.142.5
+
+[200, 1000, 3600, ' OR ', ',', '0x', 'columns', 'data_preview', 'events_count', 'events_error', 'events_preview', 'events_timeout', 'large', 'objects_count', 'objects_error', 'objects_preview', 'objects_timeout', 'ok', 'rowcount', 'transactions_count', 'transactions_error', 'transactions_preview', 'transactions_timeout']

spice_mcp-0.1.3/.hypothesis/constants/71bc6f8cf28bcc19

@@ -0,0 +1,4 @@
+# file: /Users/evandekim/Documents/spice_mcp/src/spice_mcp/adapters/dune/cache.py
+# hypothesis_version: 6.142.5
+
+['/tmp/dune_spice', '_tmp_', 'all_types', 'cache_dir', 'columns', 'execution_id', 'extras', 'include_execution', 'invalid format for ', 'limit', 'offset', 'parameters', 'query_id', 'sample_count', 'sort_by', 'spice-mcp', 'spice_version', 'timestamp', 'types', 'utf-8', 'verbose']

spice_mcp-0.1.3/.hypothesis/constants/851c74a7cccd312b

@@ -0,0 +1,4 @@
+# file: /Users/evandekim/Documents/spice_mcp/src/spice_mcp/logging/query_history.py
+# hypothesis_version: 6.142.5
+
+[200, '.spice_mcp', 'SPICE_ARTIFACT_ROOT', 'SPICE_QUERY_HISTORY', 'a', 'artifacts', 'by_sha', 'cache_hit', 'disabled', 'duration_ms', 'error', 'execution_id', 'logs', 'queries', 'queries.jsonl', 'query_preview', 'query_sha256', 'query_type', 'reason', 'rowcount', 'sql_path', 'status', 'timestamp', 'ts', 'utf-8']

spice_mcp-0.1.3/.hypothesis/constants/8c85c7b24d65d86a

@@ -0,0 +1,4 @@
+# file: /Users/evandekim/Documents/spice_mcp/src/spice_mcp/adapters/dune/admin.py
+# hypothesis_version: 6.142.5
+
+['Content-Type', 'GET', 'PATCH', 'POST', 'User-Agent', 'X-Dune-API-Key', 'application/json', 'description', 'is_private', 'name', 'parameters', 'query', 'query_create', 'query_fork', 'query_sql', 'spice-mcp-admin/1', 'tags']

spice_mcp-0.1.3/.hypothesis/constants/8d1eb008907ca218

@@ -0,0 +1,4 @@
+# file: /Users/evandekim/Documents/spice_mcp/src/spice_mcp/adapters/dune/transport.py
+# hypothesis_version: 6.142.5
+
+['GET', 'POST']

spice_mcp-0.1.3/.hypothesis/constants/9da684ed8a9b8d9c

@@ -0,0 +1,4 @@
+# file: /Users/evandekim/Documents/spice_mcp/src/spice_mcp/adapters/dune/__init__.py
+# hypothesis_version: 6.142.5
+
+['query', 'urls']

spice_mcp-0.1.3/.hypothesis/constants/adc83b19e793491b

@@ -0,0 +1,4 @@
+# file: /Users/evandekim/Documents/spice_mcp/src/spice_mcp/mcp/__init__.py
+# hypothesis_version: 6.142.5
+
+[]

spice_mcp-0.1.3/.hypothesis/constants/ae79689a9c0be3fc

@@ -0,0 +1,4 @@
+# file: /Users/evandekim/Documents/spice_mcp/src/spice_mcp/service_layer/discovery_service.py
+# hypothesis_version: 6.142.5
+
+[]

spice_mcp-0.1.3/.hypothesis/constants/c9f1afd2a84c92ac

@@ -0,0 +1,4 @@
+# file: /Users/evandekim/Documents/spice_mcp/src/spice_mcp/adapters/dune/extract.py
+# hypothesis_version: 6.142.5
+
+[0.5, 1.0, 1.5, 2.5, 5.0, 15.0, 404, 429, 502, '%.02f', ',', ', t = ', '30', '<nil>', 'GET', 'QUERY_STATE_FAILED', 'SPICE_HTTP_TIMEOUT', 'User-Agent', 'X-Dune-API-Key', 'Z', 'all_types', 'api.dune.com', 'api_key', 'cache', 'cache_dir', 'columns', 'dune.com/queries', 'empty query', 'error', 'execute_kwargs', 'execution_id', 'execution_started_at', 'extras', 'https://', 'include_execution', 'latest result age:', 'limit', 'medium', 'offset', 'parameters', 'performance', 'poll_interval', 'query', 'query_id', 'query_parameters', 'result_kwargs', 'sample_count', 'save_to_cache', 'sort_by', 'spice-mcp-adapter', 'spice-mcp/', 'state', 'timeout_seconds', 'timestamp', 'true', 'types', 'unknown', 'verbose', 'x-dune-next-offset', 'x-dune-next-uri']

spice_mcp-0.1.3/.hypothesis/constants/d427659fa4d8fdef

@@ -0,0 +1,4 @@
+# file: /Users/evandekim/Documents/spice_mcp/src/spice_mcp/adapters/dune/client.py
+# hypothesis_version: 6.142.5
+
+[1000, 'Column', 'Comment', 'DUNE_API_KEY', 'Extra', 'GET', 'Schema', 'Table', 'Type', 'User-Agent', 'X-Dune-API-Key', 'column_name', 'columns', 'data_type', 'error', 'limit', 'medium', 'metadata', 'name', 'next_offset', 'next_uri', 'offset', 'query_parameters', 'result', 'sample_count', 'sort_by', 'state']

spice_mcp-0.1.3/.hypothesis/constants/d946c4cbd3f551fb

@@ -0,0 +1,4 @@
+# file: /Users/evandekim/Documents/spice_mcp/src/spice_mcp/mcp/server.py
+# hypothesis_version: 6.142.5
+
+[5.0, 10.0, 30.0, 200, 1000, '#', ',', '.env', '1', '=', 'Create Saved Query', 'DUNE_API_KEY', 'Describe Table', 'ERROR', 'FASTMCP_LOG_LEVEL', 'FASTMCP_NO_BANNER', 'Find Tables', 'Fork Saved Query', 'GET', 'Health Check', 'Query History Tail', 'Query Info', 'Run Dune Query', 'SQL Artifact', 'Sui Events Preview', 'Sui Package Overview', 'Update Saved Query', 'User-Agent', 'X-Dune-API-Key', '[a-f0-9]{64}', '_', '__main__', 'admin', 'api_key_present', 'application/json', 'artifact_root', 'by_sha', 'columns', 'comment', 'content-type', 'degraded', 'description', 'dune', 'dune_describe_table', 'dune_find_tables', 'dune_health_check', 'dune_query', 'dune_query_create', 'dune_query_fork', 'dune_query_info', 'dune_query_update', 'dune_type', 'extra', 'health', 'history_path', 'hours', 'keyword', 'limit', 'logging_enabled', 'metadata', 'name', 'offset', 'ok', 'packages', 'parameters', 'polars_dtype', 'poll', 'preview', 'queries', 'query', 'query_history_path', 'query_id', 'query_sql', 'query_url', 'raw', 'resource', 'schema', 'schemas', 'source_query_id', 'spice-mcp', 'spice:artifact/{sha}', 'status', 'sui', 'sui_events_preview', 'sui_package_overview', 'table', 'tables', 'tags', 'template_query_id', 'template_query_ok', 'timeout_seconds', 'tool', 'utf-8', 'version', '~/.env']

spice_mcp-0.1.3/.hypothesis/constants/da39a3ee5e6b4b0d

@@ -0,0 +1,4 @@
+# file: /Users/evandekim/Documents/spice_mcp/src/spice_mcp/service_layer/__init__.py
+# hypothesis_version: 6.142.5
+
+[]

spice_mcp-0.1.3/.hypothesis/constants/df167ab23556209e

@@ -0,0 +1,4 @@
+# file: /Users/evandekim/Documents/spice_mcp/src/spice_mcp/adapters/http_client.py
+# hypothesis_version: 6.142.5
+
+[0.35, 1.25, 2.25, 5.0, 15.0, 408, 409, 425, 429, 500, 502, 503, 504, 1000, 'attempt', 'duration_ms', 'error', 'http_request', 'http_request_error', 'http_request_failed', 'method', 'spice_mcp.http', 'status', 'url']

spice_mcp-0.1.3/.hypothesis/constants/e5d028d6ca3bc6c6

@@ -0,0 +1,4 @@
+# file: /Users/evandekim/Documents/spice_mcp/src/spice_mcp/service_layer/query_service.py
+# hypothesis_version: 6.142.5
+
+['columns', 'data', 'data_preview', 'duration_ms', 'execution', 'lazyframe', 'metadata', 'next_offset', 'next_uri', 'rowcount']

spice_mcp-0.1.3/.hypothesis/constants/ea30e4add0a6171c

@@ -0,0 +1,4 @@
+# file: /Users/evandekim/Documents/spice_mcp/src/spice_mcp/adapters/dune/typing_utils.py
+# hypothesis_version: 6.142.5
+
+[4060379]

spice_mcp-0.1.3/.hypothesis/constants/ebbaf5778e99a3e9

@@ -0,0 +1,4 @@
+# file: /Users/evandekim/Documents/spice_mcp/src/spice_mcp/core/models.py
+# hypothesis_version: 6.142.5
+
+[]

spice_mcp-0.1.3/.hypothesis/constants/ebfda9399227f401

@@ -0,0 +1,4 @@
+# file: /Users/evandekim/Documents/spice_mcp/src/spice_mcp/polars_utils.py
+# hypothesis_version: 6.142.5
+
+[]

spice_mcp-0.1.3/.hypothesis/constants/f8058dd8f3978a9f

@@ -0,0 +1,4 @@
+# file: /Users/evandekim/Documents/spice_mcp/src/spice_mcp/core/errors.py
+# hypothesis_version: 6.142.5
+
+['****', '401', '429', 'AUTH_ERROR', 'QUERY_ERROR', 'QUERY_TIMEOUT', 'Query timed out', 'RATE_LIMIT', 'Retry the request.', 'UNKNOWN_ERROR', 'api key', 'api_key', 'code', 'context', 'data', 'error', 'message', 'ok', 'query failed', 'rate limit', 'secret', 'sql', 'suggestions', 'syntax', 'timed out', 'timeout', 'token', 'unauthorized']

spice_mcp-0.1.3/.hypothesis/examples/04e6b3400353b141/5206044c103f45ca

@@ -0,0 +1,2 @@
+���ޭ��Ͼ���ٛ;0�FlHO��� )�fa&$0��]{a>��
+�

spice_mcp-0.1.3/.hypothesis/examples/04e6b3400353b141/8c16f33e2460573e

@@ -0,0 +1 @@
+�%�%�=��0��X����E.@��C

spice_mcp-0.1.3/.hypothesis/examples/04e6b3400353b141/c67ab7f30dd41ebd

@@ -0,0 +1 @@
+�%�%�=��0��X����E.@��C

spice_mcp-0.1.3/.hypothesis/examples/5206044c103f45ca/e4201915c9a55aa8

@@ -0,0 +1 @@
+A

spice_mcp-0.1.3/.hypothesis/examples/8c16f33e2460573e/05f4853fe973fb8f

@@ -0,0 +1 @@
+�LPT

spice_mcp-0.1.3/.hypothesis/examples/8c16f33e2460573e/57bd1d7010b0a3e5

@@ -0,0 +1 @@
+�U󇔑üœ

spice_mcp-0.1.3/.hypothesis/examples/8c16f33e2460573e/6c3ff7a3026f98fd

@@ -0,0 +1 @@
+�LPT1

spice_mcp-0.1.3/.hypothesis/examples/8c16f33e2460573e/ccd03e0f6bc2e1a2

@@ -0,0 +1 @@
+�LP

spice_mcp-0.1.3/.hypothesis/examples/8c16f33e2460573e/d179779eaa64628d

@@ -0,0 +1 @@
+�L

spice_mcp-0.1.3/.hypothesis/examples/c67ab7f30dd41ebd/31f5e37d90db6ce6

@@ -0,0 +1 @@
+�1

{spice_mcp-0.1.2 → spice_mcp-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spice-mcp
-Version: 0.1.2
+Version: 0.1.3
 Summary: MCP server for Dune Analytics data access
 Author-email: Evan-Kim2028 <ekcopersonal@gmail.com>
 License-File: LICENSE
@@ -21,7 +21,12 @@ Description-Content-Type: text/markdown
 
 # spice-mcp
 
-spice-mcp is an MCP server for [Dune](https://dune.com/) Analytics. It wraps a curated subset of the original Spice client inside a clean architecture (`core` models/ports → `adapters.dune` → service layer → FastMCP tools) and adds agent-friendly workflows for discovery and Sui package exploration. Results are Polars-first in Python and compact, token-efficient in MCP responses.
+spice-mcp is an MCP server for [Dune](https://dune.com/) Analytics. It wraps a curated subset of the original Spice client inside a clean architecture (`core` models/ports → `adapters.dune` → service layer → FastMCP tools) and adds agent-friendly workflows for discovery. Results are Polars-first in Python and compact, token-efficient in MCP responses.
+
+[![PyPI version](https://img.shields.io/pypi/v/spice-mcp.svg)](https://pypi.org/project/spice-mcp/)
+<a href="https://glama.ai/mcp/servers/@Evan-Kim2028/spice-mcp">
+  <img width="380" height="200" src="https://glama.ai/mcp/servers/@Evan-Kim2028/spice-mcp/badge" alt="Spice MCP server" />
+</a>
 
 Requirements: Python 3.13+
 
@@ -31,16 +36,17 @@ This project uses FastMCP for typed, decorator-registered tools and resources.
 - Polars LazyFrame-first pipeline: results stay lazy until explicitly materialized
 - Ports/adapters layering for maintainable integrations ([docs/architecture.md](docs/architecture.md))
 - Discovery utilities (find schemas/tables, describe columns)
-- Sui package workflows (events/transactions/objects) with safe defaults
 - JSONL query history + SQL artifacts (SHA-256) for reproducibility
-- Rich MCP surface: query info/run, discovery, health, Sui, and Dune admin (create/update/fork)
+- Rich MCP surface: query info/run, discovery, health, and Dune admin (create/update/fork)
 
 ## What is Dune?
 [Dune](https://dune.com/) is a crypto data platform providing curated blockchain datasets and a public API to run and fetch query results. See the [Dune Docs](https://dune.com/docs) and [Dune API](https://dune.com/docs/api/) for full details.
 
 ## Quick Start
 - Export `DUNE_API_KEY` in your shell (the server can also load a local `.env`; set `SPICE_MCP_SKIP_DOTENV=1` to skip during tests).
-- Install dependencies (`uv sync` or `pip install -e .`).
+- Install from PyPI: `uv pip install spice-mcp`
+- Or install from source:
+  - `uv sync` then `uv pip install -e .`
 - Start the FastMCP stdio server:
   - `python -m spice_mcp.mcp.server --env PYTHONPATH=$(pwd)/src`
   - or install the console script via `uv tool install .` and run `spice-mcp`.
@@ -51,9 +57,12 @@ To use spice-mcp with Cursor IDE:
 
 1. **Install the MCP Server**:
    ```bash
-   # Install dependencies and package
+   # Install from PyPI (recommended)
+   uv pip install spice-mcp
+   
+   # Or install from source
    uv sync
-   pip install -e .
+   uv pip install -e .
    
    # Or install via uv tool (creates console script)
    uv tool install .
@@ -97,7 +106,6 @@ To use spice-mcp with Cursor IDE:
    - `dune_query`: Run Dune queries by ID, URL, or raw SQL
    - `dune_find_tables`: Search schemas and list tables
    - `dune_describe_table`: Get column metadata
-   - `sui_package_overview`: Analyze Sui packages
    - `dune_health_check`: Verify API connection
 
 **Tip**: Create a `.env` file in your project root with `DUNE_API_KEY=your-key-here` for easier configuration.
@@ -121,9 +129,6 @@ All tools expose typed parameters, titles, and tags; failures return a consisten
 - `dune_describe_table` (Describe Table, tags: dune, schema)
   - Column metadata for `schema.table` (Dune types + Polars inferred dtypes when available).
 
-- `sui_package_overview` (Sui Package Overview, tag: sui)
-  - Compact Sui activity overview for `packages[]` with `hours` (default 72) and `timeout_seconds`.
-
 - Dune Admin tools (tags: dune, admin)
   - `dune_query_create(name, query_sql, description?, tags?, parameters?)`
   - `dune_query_update(query_id, name?, query_sql?, description?, tags?, parameters?)`
@@ -178,7 +183,7 @@ Core Tools (with parameters)
 - See [docs/index.md](docs/index.md) for full documentation:
   - Dune API structure and capabilities: [docs/dune_api.md](docs/dune_api.md)
   - Discovery patterns and examples: [docs/discovery.md](docs/discovery.md)
-  - Sui package workflows: [docs/sui_packages.md](docs/sui_packages.md)
+  
   - Tool reference and schemas: [docs/tools.md](docs/tools.md)
   - Codex CLI + tooling integration: [docs/codex_cli.md](docs/codex_cli.md), [docs/codex_cli_tools.md](docs/codex_cli_tools.md)
   - Architecture overview: [docs/architecture.md](docs/architecture.md)
@@ -190,4 +195,4 @@ Notes
 - Ports and models live in `src/spice_mcp/core`; services consume ports and are exercised by FastMCP tools.
 - Query history and SQL artefacts are always-on (see `src/spice_mcp/logging/query_history.py`).
 - To bypass dot-env loading during tests/CI, export `SPICE_MCP_SKIP_DOTENV=1`.
-- LazyFrames everywhere: eager `.collect()` or `pl.DataFrame` usage outside dedicated helpers is blocked by `tests/style/test_polars_lazy.py`; materialization helpers live in `src/spice_mcp/polars_utils.py`.
+- LazyFrames everywhere: eager `.collect()` or `pl.DataFrame` usage outside dedicated helpers is blocked by `tests/style/test_polars_lazy.py`; materialization helpers live in `src/spice_mcp/polars_utils.py`.

{spice_mcp-0.1.2 → spice_mcp-0.1.3}/README.md

@@ -1,6 +1,11 @@
 # spice-mcp
 
-spice-mcp is an MCP server for [Dune](https://dune.com/) Analytics. It wraps a curated subset of the original Spice client inside a clean architecture (`core` models/ports → `adapters.dune` → service layer → FastMCP tools) and adds agent-friendly workflows for discovery and Sui package exploration. Results are Polars-first in Python and compact, token-efficient in MCP responses.
+spice-mcp is an MCP server for [Dune](https://dune.com/) Analytics. It wraps a curated subset of the original Spice client inside a clean architecture (`core` models/ports → `adapters.dune` → service layer → FastMCP tools) and adds agent-friendly workflows for discovery. Results are Polars-first in Python and compact, token-efficient in MCP responses.
+
+[![PyPI version](https://img.shields.io/pypi/v/spice-mcp.svg)](https://pypi.org/project/spice-mcp/)
+<a href="https://glama.ai/mcp/servers/@Evan-Kim2028/spice-mcp">
+  <img width="380" height="200" src="https://glama.ai/mcp/servers/@Evan-Kim2028/spice-mcp/badge" alt="Spice MCP server" />
+</a>
 
 Requirements: Python 3.13+
 
@@ -10,16 +15,17 @@ This project uses FastMCP for typed, decorator-registered tools and resources.
 - Polars LazyFrame-first pipeline: results stay lazy until explicitly materialized
 - Ports/adapters layering for maintainable integrations ([docs/architecture.md](docs/architecture.md))
 - Discovery utilities (find schemas/tables, describe columns)
-- Sui package workflows (events/transactions/objects) with safe defaults
 - JSONL query history + SQL artifacts (SHA-256) for reproducibility
-- Rich MCP surface: query info/run, discovery, health, Sui, and Dune admin (create/update/fork)
+- Rich MCP surface: query info/run, discovery, health, and Dune admin (create/update/fork)
 
 ## What is Dune?
 [Dune](https://dune.com/) is a crypto data platform providing curated blockchain datasets and a public API to run and fetch query results. See the [Dune Docs](https://dune.com/docs) and [Dune API](https://dune.com/docs/api/) for full details.
 
 ## Quick Start
 - Export `DUNE_API_KEY` in your shell (the server can also load a local `.env`; set `SPICE_MCP_SKIP_DOTENV=1` to skip during tests).
-- Install dependencies (`uv sync` or `pip install -e .`).
+- Install from PyPI: `uv pip install spice-mcp`
+- Or install from source:
+  - `uv sync` then `uv pip install -e .`
 - Start the FastMCP stdio server:
   - `python -m spice_mcp.mcp.server --env PYTHONPATH=$(pwd)/src`
   - or install the console script via `uv tool install .` and run `spice-mcp`.
@@ -30,9 +36,12 @@ To use spice-mcp with Cursor IDE:
 
 1. **Install the MCP Server**:
    ```bash
-   # Install dependencies and package
+   # Install from PyPI (recommended)
+   uv pip install spice-mcp
+   
+   # Or install from source
    uv sync
-   pip install -e .
+   uv pip install -e .
    
    # Or install via uv tool (creates console script)
    uv tool install .
@@ -76,7 +85,6 @@ To use spice-mcp with Cursor IDE:
    - `dune_query`: Run Dune queries by ID, URL, or raw SQL
    - `dune_find_tables`: Search schemas and list tables
    - `dune_describe_table`: Get column metadata
-   - `sui_package_overview`: Analyze Sui packages
    - `dune_health_check`: Verify API connection
 
 **Tip**: Create a `.env` file in your project root with `DUNE_API_KEY=your-key-here` for easier configuration.
@@ -100,9 +108,6 @@ All tools expose typed parameters, titles, and tags; failures return a consisten
 - `dune_describe_table` (Describe Table, tags: dune, schema)
   - Column metadata for `schema.table` (Dune types + Polars inferred dtypes when available).
 
-- `sui_package_overview` (Sui Package Overview, tag: sui)
-  - Compact Sui activity overview for `packages[]` with `hours` (default 72) and `timeout_seconds`.
-
 - Dune Admin tools (tags: dune, admin)
   - `dune_query_create(name, query_sql, description?, tags?, parameters?)`
   - `dune_query_update(query_id, name?, query_sql?, description?, tags?, parameters?)`
@@ -157,7 +162,7 @@ Core Tools (with parameters)
 - See [docs/index.md](docs/index.md) for full documentation:
   - Dune API structure and capabilities: [docs/dune_api.md](docs/dune_api.md)
   - Discovery patterns and examples: [docs/discovery.md](docs/discovery.md)
-  - Sui package workflows: [docs/sui_packages.md](docs/sui_packages.md)
+  
   - Tool reference and schemas: [docs/tools.md](docs/tools.md)
   - Codex CLI + tooling integration: [docs/codex_cli.md](docs/codex_cli.md), [docs/codex_cli_tools.md](docs/codex_cli_tools.md)
   - Architecture overview: [docs/architecture.md](docs/architecture.md)
@@ -169,4 +174,4 @@ Notes
 - Ports and models live in `src/spice_mcp/core`; services consume ports and are exercised by FastMCP tools.
 - Query history and SQL artefacts are always-on (see `src/spice_mcp/logging/query_history.py`).
 - To bypass dot-env loading during tests/CI, export `SPICE_MCP_SKIP_DOTENV=1`.
-- LazyFrames everywhere: eager `.collect()` or `pl.DataFrame` usage outside dedicated helpers is blocked by `tests/style/test_polars_lazy.py`; materialization helpers live in `src/spice_mcp/polars_utils.py`.
+- LazyFrames everywhere: eager `.collect()` or `pl.DataFrame` usage outside dedicated helpers is blocked by `tests/style/test_polars_lazy.py`; materialization helpers live in `src/spice_mcp/polars_utils.py`.

{spice_mcp-0.1.2 → spice_mcp-0.1.3}/docs/architecture.md

@@ -24,8 +24,8 @@
 ## Layers
 
 ### Core (`src/spice_mcp/core`)
-- `models.py` – dataclass representations for query requests, previews, metadata, schema descriptions, and Sui artefacts.
-- `ports.py` – protocols defining the boundaries (`QueryExecutor`, `CatalogExplorer`, `SuiInspector`).
+- `models.py` – dataclass representations for query requests, previews, metadata, schema descriptions.
+- `ports.py` – protocols defining the boundaries (`QueryExecutor`, `CatalogExplorer`).
 - `errors.py` – MCP-oriented error categorisation and envelope helpers (`error_response`).
 
 These modules contain zero infrastructure concerns; they define the shapes that higher layers orchestrate.
@@ -39,13 +39,12 @@ These modules contain zero infrastructure concerns; they define the shapes that
 ### Service Layer (`src/spice_mcp/service_layer`)
 - `query_service.py` – orchestrates `QueryExecutor` calls and shapes the dictionaries returned to MCP tools. Handles `performance` passthrough, metadata merging, and preview formatting.
 - `discovery_service.py` – thin façade around `CatalogExplorer`, returning friendlier lists for schema/table introspection.
-- `sui_service.py` – composes `QueryService` to deliver Sui-specific behaviours (events preview, package overview defaults).
 
 Services are pure Python and easily testable with stubbed ports (see `tests/tools/test_query_service.py`).
 
 ### MCP Integration (`src/spice_mcp/mcp`)
 - `server.py` – FastMCP stdio bridge. Lazily initialises configuration, adapters, services, tools, and resources. Provides resource URIs and tools while keeping stdout clean.
-- `tools/execute_query.py`, `tools/sui_package_overview.py` – thin glue calling into services, handling logging/audit trails, and shaping agent-friendly responses.
+- `tools/execute_query.py` – thin glue calling into services, handling logging/audit trails, and shaping agent-friendly responses.
 - Uses `QueryHistory` (`src/spice_mcp/logging/query_history.py`) for JSONL audit trails and SQL artefact storage.
 
 ### Observability (`src/spice_mcp/observability`)

{spice_mcp-0.1.2 → spice_mcp-0.1.3}/docs/codex_cli.md

@@ -1,7 +1,7 @@
 Codex CLI MCP Setup (spice_mcp_beta)
 
 Goal
-- Register the spice-mcp server as an MCP provider named `spice_mcp_beta` for Codex CLI, so you can call tools like `dune_query` and use the Sui command URIs.
+- Register the spice-mcp server as an MCP provider named `spice_mcp_beta` for Codex CLI, so you can call tools like `dune_query`.
 
 Prereqs
 - Dune API key in your shell (e.g., export `DUNE_API_KEY=...`)
@@ -54,23 +54,17 @@ Verify configuration
 - `codex mcp list` should list `spice_mcp_beta` with the python command and no secrets in Env.
 
 Try some tools
-- Find Sui schemas
-  - `mcp__spice_mcp_beta__dune_find_tables {"keyword": "sui"}`
-- Describe `sui.transactions`
-  - `mcp__spice_mcp_beta__dune_describe_table {"schema": "sui", "table": "transactions"}`
+- Find schemas
+  - `mcp__spice_mcp_beta__dune_find_tables {"keyword": "dex"}`
+- Describe a table
+  - `mcp__spice_mcp_beta__dune_describe_table {"schema": "dex", "table": "trades"}`
 - Query preview (with metadata/pagination)
   - `mcp__spice_mcp_beta__dune_query {"query": "4388", "limit": 5}`
-  - `mcp__spice_mcp_beta__dune_query {"query": "SELECT * FROM sui.events LIMIT 5"}`
-MCP command URIs (resources)
-- You can read command-style resources for safe defaults (3-day windows, small LIMITs):
-  - Events preview: `spice:sui/events_preview/72/50/0xcaf6...,0x2c8d...`
-  - Package overview (cmd): `spice:sui/package_overview/72/30/0xcaf6...,0x2c8d...`
-  - Global preview (no package filter): `spice:sui/events_preview/72/50/_`
-  - See `docs/commands.md` for details. (Your client must support reading MCP resources.)
+  - `mcp__spice_mcp_beta__dune_query {"query": "SELECT * FROM dex.trades LIMIT 5"}`
 
 Notes & troubleshooting
 - Secret safety: Never store `DUNE_API_KEY` in Codex config; use `shell_environment_policy.inherit=["DUNE_API_KEY"]` or set it in your shell.
 - Missing key error: If you see `DUNE_API_KEY required`, export it in your shell and relaunch. The server also attempts to load `.env` from the project or home directory as a fallback.
 - FastMCP stdout: This server disables FastMCP banners/logging to keep stdio clean; if handshakes fail, ensure you used the exact `python -m spice_mcp.mcp.server` and PYTHONPATH as shown.
-- Heavy scans: Start with `format="metadata"` on `dune_query`, use `performance="large"`, and small `limit` with a recent time window; the Sui command URIs default to safe windows and limits.
+- Heavy scans: Start with `format="metadata"` on `dune_query`, use `performance="large"`, and small `limit` with a recent time window.
 - Tests/CI: set `SPICE_MCP_SKIP_DOTENV=1` to stop `_ensure_initialized` from reading local `.env` files when the key is intentionally absent.

{spice_mcp-0.1.2 → spice_mcp-0.1.3}/docs/config.md

@@ -15,7 +15,7 @@ Optional
   - `SPICE_LOGGING_ENABLED`: true/false (default: true)
 - Timeouts
   - `SPICE_TIMEOUT_SECONDS`: default polling timeout (seconds)
-  - `SPICE_MAX_CONCURRENT_QUERIES`: max concurrent dune_query executions (default: 5)
+  - `SPICE_MAX_CONCURRENT_QUERIES`: reserved for future concurrency control (default: 5, not currently enforced)
 - Raw SQL
   - `SPICE_RAW_SQL_QUERY_ID`: ID of the template query used to execute raw SQL (default: 4060379). Health is reported by `dune_health_check` when set.
 

{spice_mcp-0.1.2 → spice_mcp-0.1.3}/docs/development.md

@@ -4,7 +4,7 @@ This document summarizes local development workflows for spice-mcp.
 
 ## Tooling
 
-- Tests: `pytest` (+ `pytest-asyncio`, `responses`, `aioresponses`, `vcrpy`)
+- Tests: `pytest` (+ `responses`, `vcrpy`, `hypothesis`)
 - Lint/Format: `ruff` (lint + import sort + formatting)
 - Types: `mypy`
 
@@ -27,7 +27,7 @@ Enable live tests explicitly:
 - `tests/offline/`: pure unit tests; no network.
 - `tests/http_stubbed/`: HTTP boundary via `responses`.
 - `tests/tools/`: service + MCP tool unit tests.
-- `tests/mcp/`: FastMCP contract tests with stubbed services (preview/raw/metadata, Sui resources).
+- `tests/mcp/`: FastMCP contract tests with stubbed services (preview/raw/metadata).
 - `tests/fastmcp/`: registration/metadata smoke tests for FastMCP wiring.
 - `tests/style/`: static safety checks (lazyframe enforcement, etc.).
 - `tests/live/`: opt-in integrations; require `SPICE_TEST_LIVE=1` and `DUNE_API_KEY`.
@@ -36,7 +36,7 @@ Most unit/contract tests construct stub implementations of the ports in `src/spi
 
 ## Style
 
-- Follow Ruff + ruff-format defaults (88 cols, py39).
+- Follow Ruff + ruff-format defaults (88 cols, py313).
 - Prefer small, focused functions and explicit typing in `src/`.
 - Tests prioritize readability over strict typing.
 - Export `SPICE_MCP_SKIP_DOTENV=1` when running tests that expect the API key to be unset.

{spice_mcp-0.1.2 → spice_mcp-0.1.3}/docs/discovery.md

@@ -17,10 +17,6 @@ Approach
   - Some deployments allow: information_schema.schemata/tables/columns
   - If blocked, use SHOW + probes
 
-Sui Examples
-- Find Sui schemas: SHOW SCHEMAS LIKE '%sui%'
-- Confirm core tables: SELECT * FROM sui.events/transactions/checkpoints/objects LIMIT 1
-- SHOW TABLES works on some Sui-related schemas (e.g., sui_base), but not all
 
 Helpers in this repo
 - `src/spice_mcp/service_layer/discovery_service.py` provides service wrappers around the Dune adapter:

{spice_mcp-0.1.2 → spice_mcp-0.1.3}/docs/index.md

@@ -7,7 +7,7 @@ spice-mcp Documentation
 - Architecture Overview: `docs/architecture.md`
 - Dune API Overview: `docs/dune_api.md`
 - Catalog Discovery Guide: `docs/discovery.md`
-- Sui Packages (Deepbook) Workflow: `docs/sui_packages.md`
+
 - Codex CLI MCP Setup: `docs/codex_cli.md`
 - Development & Testing: `docs/development.md`
 

{spice_mcp-0.1.2 → spice_mcp-0.1.3}/docs/tools.md

@@ -53,20 +53,7 @@ Logging & Artifacts
   - columns: [{ name, dune_type?, polars_dtype?, extra?, comment? }]
   - Errors follow the standard MCP envelope.
 
-4) sui_package_overview
-- Purpose: Preview Sui package activity (events, transactions, objects) over a time window; timeouts supported.
-- Input schema:
-  - packages: string[] (required)
-  - hours?: integer (default 72)
-  - timeout_seconds?: number (default 30)
-- Output fields (best-effort):
-  - ok: boolean
-  - events_count?, events_preview?, events_timeout?, events_error?
-  - transactions_count?, transactions_preview?, transactions_timeout?, transactions_error?
-  - objects_count?, objects_preview?, objects_timeout?, objects_error?
-  - On error: { ok: false, error: { … } }
-
- 5) dune_health_check
+4) dune_health_check
 - Purpose: Basic environment and logging readiness check.
 - Output fields: ok, api_key_present, status
 

{spice_mcp-0.1.2 → spice_mcp-0.1.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "spice-mcp"
-version = "0.1.2"
+version = "0.1.3"
 description = "MCP server for Dune Analytics data access"
 authors = [
     { name = "Evan-Kim2028", email = "ekcopersonal@gmail.com" }

{spice_mcp-0.1.2 → spice_mcp-0.1.3}/src/spice_mcp/adapters/dune/__init__.py

@@ -2,9 +2,11 @@
 
 This module provides a thin façade used by the new service layer while
 keeping the battle-tested logic that the original spice client offered.
+
+Only synchronous interfaces are exposed.
 """
 
 from . import urls  # re-export for callers needing low-level helpers
-from .extract import async_query, query  # noqa: F401
+from .extract import query  # noqa: F401
 
-__all__ = ["query", "async_query", "urls"]
+__all__ = ["query", "urls"]