tiwall-mcp 0.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,43 @@
1
+ name: Bug report
2
+ description: A tool failed or returned wrong data
3
+ labels: [bug]
4
+ body:
5
+ - type: input
6
+ id: tool
7
+ attributes:
8
+ label: Tool
9
+ description: Which tool, e.g. ins_quote_travel
10
+ validations:
11
+ required: true
12
+ - type: textarea
13
+ id: input
14
+ attributes:
15
+ label: Arguments and result
16
+ description: The arguments the agent sent and the error or wrong output. Remove anything personal.
17
+ render: json
18
+ validations:
19
+ required: true
20
+ - type: textarea
21
+ id: expected
22
+ attributes:
23
+ label: What you expected
24
+ description: e.g. what tiwall.com shows for the same input
25
+ - type: input
26
+ id: client
27
+ attributes:
28
+ label: MCP client and OS
29
+ placeholder: Claude Desktop 1.x on Windows 11
30
+ - type: dropdown
31
+ id: network
32
+ attributes:
33
+ label: Network
34
+ options:
35
+ - Direct connection from Iran
36
+ - Direct connection outside Iran
37
+ - VPN or proxy
38
+ - TIWALL_MCP_PROXY set
39
+ - type: input
40
+ id: version
41
+ attributes:
42
+ label: tiwall-mcp version
43
+ placeholder: "0.1.0"
@@ -0,0 +1,5 @@
1
+ blank_issues_enabled: true
2
+ contact_links:
3
+ - name: Question or idea
4
+ url: https://github.com/sepehr071/tiwall-mcp/discussions
5
+ about: Ask how to use it or suggest a new tool
Binary file
@@ -0,0 +1,10 @@
1
+ version: 2
2
+ updates:
3
+ - package-ecosystem: github-actions
4
+ directory: /
5
+ schedule:
6
+ interval: monthly
7
+ - package-ecosystem: uv
8
+ directory: /
9
+ schedule:
10
+ interval: monthly
@@ -0,0 +1,22 @@
1
+ name: CI
2
+
3
+ on:
4
+ push:
5
+ branches: [main]
6
+ pull_request:
7
+
8
+ jobs:
9
+ test:
10
+ runs-on: ubuntu-latest
11
+ strategy:
12
+ matrix:
13
+ python: ["3.10", "3.11", "3.12", "3.13"]
14
+ steps:
15
+ - uses: actions/checkout@v7
16
+ - uses: astral-sh/setup-uv@v10.2.0
17
+ with:
18
+ python-version: ${{ matrix.python }}
19
+ - run: uv sync --locked
20
+ - run: uv run ruff check .
21
+ - run: uv run ruff format --check .
22
+ - run: uv run pytest -q
@@ -0,0 +1,51 @@
1
+ name: Publish
2
+
3
+ # Tag a release (git tag v0.1.0 && git push --tags) after bumping the version in
4
+ # pyproject.toml and server.json.
5
+ on:
6
+ push:
7
+ tags: ["v*"]
8
+
9
+ jobs:
10
+ pypi:
11
+ runs-on: ubuntu-latest
12
+ environment: pypi
13
+ permissions:
14
+ id-token: write # PyPI trusted publishing
15
+ contents: write # GitHub Release
16
+ steps:
17
+ - uses: actions/checkout@v7
18
+ - uses: astral-sh/setup-uv@v10.2.0
19
+ - name: Check versions match the tag
20
+ run: |
21
+ TAG=${GITHUB_REF_NAME#v}
22
+ grep -q "^version = \"$TAG\"" pyproject.toml
23
+ test "$(jq -r .version server.json)" = "$TAG"
24
+ test "$(jq -r '.packages[0].version' server.json)" = "$TAG"
25
+ - run: uv sync --locked && uv run pytest -q
26
+ - run: uv build
27
+ - uses: pypa/gh-action-pypi-publish@release/v1
28
+ - run: gh release create "$GITHUB_REF_NAME" dist/* --generate-notes --title "$GITHUB_REF_NAME"
29
+ env:
30
+ GH_TOKEN: ${{ github.token }}
31
+
32
+ mcp-registry:
33
+ needs: pypi
34
+ runs-on: ubuntu-latest
35
+ permissions:
36
+ id-token: write # MCP Registry login via GitHub OIDC
37
+ contents: read
38
+ steps:
39
+ - uses: actions/checkout@v7
40
+ - name: Wait for PyPI to serve the new version
41
+ run: |
42
+ for i in $(seq 1 30); do
43
+ curl -sf "https://pypi.org/pypi/tiwall-mcp/${GITHUB_REF_NAME#v}/json" >/dev/null && exit 0
44
+ sleep 10
45
+ done
46
+ exit 1
47
+ - name: Install mcp-publisher
48
+ run: |
49
+ curl -L "https://github.com/modelcontextprotocol/registry/releases/download/v1.8.1/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher
50
+ - run: ./mcp-publisher login github-oidc
51
+ - run: ./mcp-publisher publish
@@ -0,0 +1,6 @@
1
+ .venv/
2
+ __pycache__/
3
+ *.pyc
4
+ dist/
5
+ .pytest_cache/
6
+ .ruff_cache/
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Sepehr Radmard
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,152 @@
1
+ Metadata-Version: 2.5
2
+ Name: tiwall-mcp
3
+ Version: 0.1.0
4
+ Summary: Unofficial read-only MCP server for Tiwall (tiwall.com), the Iranian ticketing site: theatre, concerts, exhibitions, workshops, venues, sessions, prices, reviews.
5
+ Project-URL: Homepage, https://github.com/sepehr071/tiwall-mcp
6
+ Project-URL: Repository, https://github.com/sepehr071/tiwall-mcp
7
+ Project-URL: Issues, https://github.com/sepehr071/tiwall-mcp/issues
8
+ Project-URL: Website, https://mcpfarsi.ir/
9
+ Author-email: Sepehr Radmard <sepehrr80@gmail.com>
10
+ License-Expression: MIT
11
+ License-File: LICENSE
12
+ Keywords: ai-agents,claude,concert,events,farsi,iran,mcp,mcp-server,model-context-protocol,persian,theater,theatre,tickets,tivall,tiwall,venues
13
+ Classifier: Development Status :: 4 - Beta
14
+ Classifier: Intended Audience :: Developers
15
+ Classifier: Operating System :: OS Independent
16
+ Classifier: Programming Language :: Python :: 3
17
+ Classifier: Programming Language :: Python :: 3.10
18
+ Classifier: Programming Language :: Python :: 3.11
19
+ Classifier: Programming Language :: Python :: 3.12
20
+ Classifier: Programming Language :: Python :: 3.13
21
+ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
22
+ Requires-Python: >=3.10
23
+ Requires-Dist: curl-cffi>=0.16.3
24
+ Requires-Dist: httpx-curl-cffi>=0.1.5
25
+ Requires-Dist: httpx>=0.27
26
+ Requires-Dist: mcp<3,>=2.2
27
+ Description-Content-Type: text/markdown
28
+
29
+ <!-- mcp-name: io.github.sepehr071/tiwall-mcp -->
30
+
31
+ <div align="center">
32
+
33
+ <img src="https://raw.githubusercontent.com/sepehr071/tiwall-mcp/main/.github/banner.png" alt="tiwall-mcp: unofficial Tiwall (تیوال) MCP server that reads Iranian theatre, concert and event listings, show times and ticket prices for Claude, Cursor and Copilot" width="100%">
34
+
35
+ # tiwall-mcp: Tiwall (تیوال) Iranian theatre and event tickets MCP server for AI agents
36
+
37
+ **tiwall-mcp is an unofficial, read-only MCP server that lets an AI agent read events on Tiwall (تیوال, tiwall.com), the Iranian ticketing site for theatre, concerts, exhibitions, workshops and film screenings.**<br>
38
+ Its 9 tools list and filter events by category, city, venue and date, show one event with cast, venue, price and rating, its show times and sale status, venues, popular events and audience reviews.<br>
39
+ No API key or account is needed; it works in Claude, Cursor, Copilot and any other MCP client.
40
+
41
+ [![PyPI](https://img.shields.io/pypi/v/tiwall-mcp?color=2563eb)](https://pypi.org/project/tiwall-mcp/)
42
+ [![Python](https://img.shields.io/pypi/pyversions/tiwall-mcp)](https://pypi.org/project/tiwall-mcp/)
43
+ [![CI](https://github.com/sepehr071/tiwall-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/sepehr071/tiwall-mcp/actions/workflows/ci.yml)
44
+ [![License: MIT](https://img.shields.io/badge/license-MIT-16a34a)](https://github.com/sepehr071/tiwall-mcp/blob/main/LICENSE)
45
+
46
+ [For AI agents](#for-ai-agents) · [Quick start](#quick-start) · [Tools](#tools) · [Limits](#limits) · [فارسی](#فارسی)
47
+
48
+ </div>
49
+
50
+ ---
51
+
52
+ ## For AI agents
53
+
54
+ - **What:** unofficial MCP server (model context protocol) for tiwall.com: events by category, city, venue and day, one event in full, its show times, venues, popular events, audience reviews.
55
+ - **Install:** `uvx tiwall-mcp` or `claude mcp add tiwall -- uvx tiwall-mcp`. Transport: stdio. Needs [uv](https://docs.astral.sh/uv/getting-started/installation/) (Python 3.10+).
56
+ - **Auth:** none. Optional `TIWALL_MCP_PROXY` (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.
57
+ - **Access:** read-only; no confirmation needed. It cannot log in, reserve seats or pay. `tw_sessions` reads the public session list only, never the seat map.
58
+ - **Tools:** 9, all prefixed `tw_`. Typical flow: `tw_categories` -> `tw_events` (or `tw_search`) -> `tw_event(slug)` -> `tw_sessions(slug)` / `tw_reviews(slug)`; `tw_venues(name)` -> `tw_venue(slug)`.
59
+ - **Use when:** the user asks which plays or concerts are on, when and where, what tickets cost, what people say about a show, or what a venue is staging.
60
+ - **Do not use when:** the user wants to buy tickets or needs seats left.
61
+ - **Output:** compact JSON. Prices in Toman, ratings 0-5, ASCII digits; listing dates are Persian (Jalali) as on the site, session dates also Gregorian. Text is Persian.
62
+ - **Machine-readable:** [`server.json`](https://github.com/sepehr071/tiwall-mcp/blob/main/server.json).
63
+
64
+ ## Quick start
65
+
66
+ You need [uv](https://docs.astral.sh/uv/getting-started/installation/). No API key or account.
67
+
68
+ Claude Code:
69
+
70
+ ```bash
71
+ claude mcp add tiwall -- uvx tiwall-mcp
72
+ ```
73
+
74
+ Claude Desktop, Cursor, VS Code and other clients:
75
+
76
+ ```json
77
+ {
78
+ "mcpServers": {
79
+ "tiwall": { "command": "uvx", "args": ["tiwall-mcp"] }
80
+ }
81
+ }
82
+ ```
83
+
84
+ Example prompts:
85
+
86
+ - "Which plays are on in Tehran this weekend?"
87
+ - "Best-selling concerts right now."
88
+ - "Show times and price for Baroot."
89
+ - "What do people say about Crocodile?"
90
+ - <span dir="rtl">امشب در تهران چه نمایشی هست؟</span>
91
+ - <span dir="rtl">سانس‌ها و قیمت بلیت نمایش باروت چیست؟</span>
92
+
93
+ A real call on 17 Nov 2026: `tw_events(category="theater", city="تهران")` listed 154 events, among them «دشمن خدا» (3.9 from 252 votes, عمارت هما, 600,000 Toman) and «باغ بی‌آلبالو» (3.8 from 31 votes, 600,000 Toman); `tw_sessions("baroot")` returned three sessions, 3 to 5 Azar 1405 at 18:30, price 750,000 Toman.
94
+
95
+ ## Tools
96
+
97
+ | Tool | What it does |
98
+ |---|---|
99
+ | `tw_categories` | Category codes, sort orders and main cities with ids |
100
+ | `tw_events` | Current events by category, city, venue, day or range, kids/comedy/online, order, paging |
101
+ | `tw_popular` | Best-selling, best-rated or newest events |
102
+ | `tw_search` | Search events by title, artist or venue words |
103
+ | `tw_event` | One event: venue, address, dates, time, duration, price, cast and crew, summary, tags, rating, sale status |
104
+ | `tw_sessions` | Show times of an event with seat wording and ticket price |
105
+ | `tw_venues` | Search venues and cities by name (ids, address, coordinates, rating) |
106
+ | `tw_venue` | A venue page (contacts, followers) and its current events |
107
+ | `tw_reviews` | Rating breakdown and audience posts of an event |
108
+
109
+ ## Limits
110
+
111
+ - Tiwall is server-rendered HTML, so the tools parse pages; if the site changes its markup a tool can return empty fields until the parser is updated.
112
+ - The showcase has no paging: the whole list is fetched and sliced; past events are cut off.
113
+ - Seats left are not given as a number, only the site's wording ("مانده دارد") per session. The seat map is never opened.
114
+ - Unverified: sold-out wording on session pages, a venue with no events, and Persian-calendar `day=` input.
115
+ - No buying, reserving or login.
116
+
117
+ ## How it works
118
+
119
+ Tiwall has no public API. The pages and its one JSON search endpoint were mapped in Chrome, and each tool was compared with the real rendered pages in Chrome on 2026-11-16 (all matched, see the map's test report). Requests use a Chrome-like TLS client, a short cache and a low request rate; the ArvanCloud challenge cookie is handled by the client's cookie jar. The server ignores system proxy variables on purpose.
120
+
121
+ ## فارسی
122
+
123
+ <div dir="rtl">
124
+
125
+ tiwall-mcp یک سرور MCP غیررسمی و فقط‌خواندنی برای تیوال (tiwall.com) است. عامل هوش مصنوعی با آن رویدادهای تئاتر، کنسرت، نمایشگاه و کارگاه را بر اساس دسته، شهر، سالن و روز فهرست می‌کند و برای هر رویداد عوامل، قیمت، امتیاز، سانس‌ها و دیدگاه تماشاگران را می‌خواند. بدون کلید API و حساب کاربری کار می‌کند. خرید بلیت و رزرو صندلی ندارد. نصب در Claude Code:
126
+
127
+ </div>
128
+
129
+ ```bash
130
+ claude mcp add tiwall -- uvx tiwall-mcp
131
+ ```
132
+
133
+ ## Development
134
+
135
+ ```bash
136
+ uv sync
137
+ uv run ruff check . && uv run ruff format --check .
138
+ uv run python -m pytest -q # offline tests on trimmed real HTML
139
+ uv run python -m pytest -m live -q # live calls to tiwall.com
140
+ ```
141
+
142
+ Releases: bump the version in `pyproject.toml` and `server.json`, run `uv lock`, then push a `v*` tag; GitHub Actions publishes to PyPI.
143
+
144
+ ## Disclaimer
145
+
146
+ Unofficial: not affiliated with, endorsed by or sponsored by Tiwall. Data and logos belong to their owners.
147
+
148
+ Author: Sepehr Radmard (سپهر رادمرد), [github.com/sepehr071](https://github.com/sepehr071) · [linkedin.com/in/sepehr-radmard](https://www.linkedin.com/in/sepehr-radmard)
149
+
150
+ ## Related servers
151
+
152
+ More Iranian-site MCP servers (shops, travel, news, finance, jobs, maps): [github.com/sepehr071/iran-mcp](https://github.com/sepehr071/iran-mcp).
@@ -0,0 +1,124 @@
1
+ <!-- mcp-name: io.github.sepehr071/tiwall-mcp -->
2
+
3
+ <div align="center">
4
+
5
+ <img src="https://raw.githubusercontent.com/sepehr071/tiwall-mcp/main/.github/banner.png" alt="tiwall-mcp: unofficial Tiwall (تیوال) MCP server that reads Iranian theatre, concert and event listings, show times and ticket prices for Claude, Cursor and Copilot" width="100%">
6
+
7
+ # tiwall-mcp: Tiwall (تیوال) Iranian theatre and event tickets MCP server for AI agents
8
+
9
+ **tiwall-mcp is an unofficial, read-only MCP server that lets an AI agent read events on Tiwall (تیوال, tiwall.com), the Iranian ticketing site for theatre, concerts, exhibitions, workshops and film screenings.**<br>
10
+ Its 9 tools list and filter events by category, city, venue and date, show one event with cast, venue, price and rating, its show times and sale status, venues, popular events and audience reviews.<br>
11
+ No API key or account is needed; it works in Claude, Cursor, Copilot and any other MCP client.
12
+
13
+ [![PyPI](https://img.shields.io/pypi/v/tiwall-mcp?color=2563eb)](https://pypi.org/project/tiwall-mcp/)
14
+ [![Python](https://img.shields.io/pypi/pyversions/tiwall-mcp)](https://pypi.org/project/tiwall-mcp/)
15
+ [![CI](https://github.com/sepehr071/tiwall-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/sepehr071/tiwall-mcp/actions/workflows/ci.yml)
16
+ [![License: MIT](https://img.shields.io/badge/license-MIT-16a34a)](https://github.com/sepehr071/tiwall-mcp/blob/main/LICENSE)
17
+
18
+ [For AI agents](#for-ai-agents) · [Quick start](#quick-start) · [Tools](#tools) · [Limits](#limits) · [فارسی](#فارسی)
19
+
20
+ </div>
21
+
22
+ ---
23
+
24
+ ## For AI agents
25
+
26
+ - **What:** unofficial MCP server (model context protocol) for tiwall.com: events by category, city, venue and day, one event in full, its show times, venues, popular events, audience reviews.
27
+ - **Install:** `uvx tiwall-mcp` or `claude mcp add tiwall -- uvx tiwall-mcp`. Transport: stdio. Needs [uv](https://docs.astral.sh/uv/getting-started/installation/) (Python 3.10+).
28
+ - **Auth:** none. Optional `TIWALL_MCP_PROXY` (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.
29
+ - **Access:** read-only; no confirmation needed. It cannot log in, reserve seats or pay. `tw_sessions` reads the public session list only, never the seat map.
30
+ - **Tools:** 9, all prefixed `tw_`. Typical flow: `tw_categories` -> `tw_events` (or `tw_search`) -> `tw_event(slug)` -> `tw_sessions(slug)` / `tw_reviews(slug)`; `tw_venues(name)` -> `tw_venue(slug)`.
31
+ - **Use when:** the user asks which plays or concerts are on, when and where, what tickets cost, what people say about a show, or what a venue is staging.
32
+ - **Do not use when:** the user wants to buy tickets or needs seats left.
33
+ - **Output:** compact JSON. Prices in Toman, ratings 0-5, ASCII digits; listing dates are Persian (Jalali) as on the site, session dates also Gregorian. Text is Persian.
34
+ - **Machine-readable:** [`server.json`](https://github.com/sepehr071/tiwall-mcp/blob/main/server.json).
35
+
36
+ ## Quick start
37
+
38
+ You need [uv](https://docs.astral.sh/uv/getting-started/installation/). No API key or account.
39
+
40
+ Claude Code:
41
+
42
+ ```bash
43
+ claude mcp add tiwall -- uvx tiwall-mcp
44
+ ```
45
+
46
+ Claude Desktop, Cursor, VS Code and other clients:
47
+
48
+ ```json
49
+ {
50
+ "mcpServers": {
51
+ "tiwall": { "command": "uvx", "args": ["tiwall-mcp"] }
52
+ }
53
+ }
54
+ ```
55
+
56
+ Example prompts:
57
+
58
+ - "Which plays are on in Tehran this weekend?"
59
+ - "Best-selling concerts right now."
60
+ - "Show times and price for Baroot."
61
+ - "What do people say about Crocodile?"
62
+ - <span dir="rtl">امشب در تهران چه نمایشی هست؟</span>
63
+ - <span dir="rtl">سانس‌ها و قیمت بلیت نمایش باروت چیست؟</span>
64
+
65
+ A real call on 17 Nov 2026: `tw_events(category="theater", city="تهران")` listed 154 events, among them «دشمن خدا» (3.9 from 252 votes, عمارت هما, 600,000 Toman) and «باغ بی‌آلبالو» (3.8 from 31 votes, 600,000 Toman); `tw_sessions("baroot")` returned three sessions, 3 to 5 Azar 1405 at 18:30, price 750,000 Toman.
66
+
67
+ ## Tools
68
+
69
+ | Tool | What it does |
70
+ |---|---|
71
+ | `tw_categories` | Category codes, sort orders and main cities with ids |
72
+ | `tw_events` | Current events by category, city, venue, day or range, kids/comedy/online, order, paging |
73
+ | `tw_popular` | Best-selling, best-rated or newest events |
74
+ | `tw_search` | Search events by title, artist or venue words |
75
+ | `tw_event` | One event: venue, address, dates, time, duration, price, cast and crew, summary, tags, rating, sale status |
76
+ | `tw_sessions` | Show times of an event with seat wording and ticket price |
77
+ | `tw_venues` | Search venues and cities by name (ids, address, coordinates, rating) |
78
+ | `tw_venue` | A venue page (contacts, followers) and its current events |
79
+ | `tw_reviews` | Rating breakdown and audience posts of an event |
80
+
81
+ ## Limits
82
+
83
+ - Tiwall is server-rendered HTML, so the tools parse pages; if the site changes its markup a tool can return empty fields until the parser is updated.
84
+ - The showcase has no paging: the whole list is fetched and sliced; past events are cut off.
85
+ - Seats left are not given as a number, only the site's wording ("مانده دارد") per session. The seat map is never opened.
86
+ - Unverified: sold-out wording on session pages, a venue with no events, and Persian-calendar `day=` input.
87
+ - No buying, reserving or login.
88
+
89
+ ## How it works
90
+
91
+ Tiwall has no public API. The pages and its one JSON search endpoint were mapped in Chrome, and each tool was compared with the real rendered pages in Chrome on 2026-11-16 (all matched, see the map's test report). Requests use a Chrome-like TLS client, a short cache and a low request rate; the ArvanCloud challenge cookie is handled by the client's cookie jar. The server ignores system proxy variables on purpose.
92
+
93
+ ## فارسی
94
+
95
+ <div dir="rtl">
96
+
97
+ tiwall-mcp یک سرور MCP غیررسمی و فقط‌خواندنی برای تیوال (tiwall.com) است. عامل هوش مصنوعی با آن رویدادهای تئاتر، کنسرت، نمایشگاه و کارگاه را بر اساس دسته، شهر، سالن و روز فهرست می‌کند و برای هر رویداد عوامل، قیمت، امتیاز، سانس‌ها و دیدگاه تماشاگران را می‌خواند. بدون کلید API و حساب کاربری کار می‌کند. خرید بلیت و رزرو صندلی ندارد. نصب در Claude Code:
98
+
99
+ </div>
100
+
101
+ ```bash
102
+ claude mcp add tiwall -- uvx tiwall-mcp
103
+ ```
104
+
105
+ ## Development
106
+
107
+ ```bash
108
+ uv sync
109
+ uv run ruff check . && uv run ruff format --check .
110
+ uv run python -m pytest -q # offline tests on trimmed real HTML
111
+ uv run python -m pytest -m live -q # live calls to tiwall.com
112
+ ```
113
+
114
+ Releases: bump the version in `pyproject.toml` and `server.json`, run `uv lock`, then push a `v*` tag; GitHub Actions publishes to PyPI.
115
+
116
+ ## Disclaimer
117
+
118
+ Unofficial: not affiliated with, endorsed by or sponsored by Tiwall. Data and logos belong to their owners.
119
+
120
+ Author: Sepehr Radmard (سپهر رادمرد), [github.com/sepehr071](https://github.com/sepehr071) · [linkedin.com/in/sepehr-radmard](https://www.linkedin.com/in/sepehr-radmard)
121
+
122
+ ## Related servers
123
+
124
+ More Iranian-site MCP servers (shops, travel, news, finance, jobs, maps): [github.com/sepehr071/iran-mcp](https://github.com/sepehr071/iran-mcp).
@@ -0,0 +1,56 @@
1
+ [project]
2
+ name = "tiwall-mcp"
3
+ version = "0.1.0"
4
+ description = "Unofficial read-only MCP server for Tiwall (tiwall.com), the Iranian ticketing site: theatre, concerts, exhibitions, workshops, venues, sessions, prices, reviews."
5
+ readme = "README.md"
6
+ license = "MIT"
7
+ license-files = ["LICENSE"]
8
+ authors = [{ name = "Sepehr Radmard", email = "sepehrr80@gmail.com" }]
9
+ requires-python = ">=3.10"
10
+ keywords = ["mcp", "model-context-protocol", "mcp-server", "tiwall", "tivall", "iran", "tickets", "theatre", "theater", "concert", "events", "venues", "claude", "persian", "farsi", "ai-agents"]
11
+ classifiers = [
12
+ "Development Status :: 4 - Beta",
13
+ "Intended Audience :: Developers",
14
+ "Operating System :: OS Independent",
15
+ "Programming Language :: Python :: 3",
16
+ "Programming Language :: Python :: 3.10",
17
+ "Programming Language :: Python :: 3.11",
18
+ "Programming Language :: Python :: 3.12",
19
+ "Programming Language :: Python :: 3.13",
20
+ "Topic :: Scientific/Engineering :: Artificial Intelligence",
21
+ ]
22
+ dependencies = [
23
+ "mcp>=2.2,<3",
24
+ "httpx>=0.27",
25
+ "httpx-curl-cffi>=0.1.5",
26
+ "curl-cffi>=0.16.3",
27
+ ]
28
+
29
+ [project.urls]
30
+ Homepage = "https://github.com/sepehr071/tiwall-mcp"
31
+ Repository = "https://github.com/sepehr071/tiwall-mcp"
32
+ Issues = "https://github.com/sepehr071/tiwall-mcp/issues"
33
+ Website = "https://mcpfarsi.ir/"
34
+
35
+ [project.scripts]
36
+ tiwall-mcp = "tiwall_mcp.server:main"
37
+
38
+ [dependency-groups]
39
+ dev = ["pytest>=8", "ruff>=0.6"]
40
+
41
+ [build-system]
42
+ requires = ["hatchling"]
43
+ build-backend = "hatchling.build"
44
+
45
+ [tool.pytest.ini_options]
46
+ testpaths = ["tests"]
47
+ addopts = "-m 'not live'"
48
+ markers = ["live: calls the real Tiwall site (run with -m live)"]
49
+
50
+ [tool.ruff]
51
+ line-length = 120
52
+ target-version = "py310"
53
+
54
+ [tool.ruff.lint]
55
+ select = ["E", "F", "I", "B", "UP"]
56
+ ignore = ["E501"] # long Field(description=...) strings read better on one line
@@ -0,0 +1,32 @@
1
+ {
2
+ "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
3
+ "name": "io.github.sepehr071/tiwall-mcp",
4
+ "title": "Tiwall Events",
5
+ "description": "Read-only Tiwall (tiwall.com) Iranian event tickets: theatre, concerts, venues, sessions, prices.",
6
+ "repository": {
7
+ "url": "https://github.com/sepehr071/tiwall-mcp",
8
+ "source": "github"
9
+ },
10
+ "websiteUrl": "https://github.com/sepehr071/tiwall-mcp",
11
+ "version": "0.1.0",
12
+ "packages": [
13
+ {
14
+ "registryType": "pypi",
15
+ "registryBaseUrl": "https://pypi.org",
16
+ "identifier": "tiwall-mcp",
17
+ "version": "0.1.0",
18
+ "runtimeHint": "uvx",
19
+ "transport": {
20
+ "type": "stdio"
21
+ },
22
+ "environmentVariables": [
23
+ {
24
+ "name": "TIWALL_MCP_PROXY",
25
+ "description": "Optional HTTP proxy URL for the Tiwall requests; system proxy settings are ignored. Also accepts a comma-separated list: one is used until it gets blocked or fails to connect, then the next.",
26
+ "isRequired": false,
27
+ "isSecret": false
28
+ }
29
+ ]
30
+ }
31
+ ]
32
+ }
@@ -0,0 +1,5 @@
1
+ """Unofficial MCP server for Tiwall (tiwall.com), the Iranian ticketing site: theatre, concerts, venues, sessions."""
2
+
3
+ from importlib.metadata import version
4
+
5
+ __version__ = version("tiwall-mcp")