aipaygen-mcp 1.3.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,135 @@
1
+ Metadata-Version: 2.4
2
+ Name: aipaygen-mcp
3
+ Version: 1.3.0
4
+ Summary: 85+ AI tools for Claude, Cursor, and any MCP-compatible agent — research, write, code, scrape, translate, and more
5
+ Author-email: AiPayGen <hello@aipaygen.com>
6
+ License: MIT
7
+ Project-URL: Homepage, https://aipaygen.com
8
+ Project-URL: Documentation, https://api.aipaygen.com/discover
9
+ Project-URL: Repository, https://github.com/djautomd-lab/aipaygen
10
+ Project-URL: Issues, https://github.com/djautomd-lab/aipaygen/issues
11
+ Keywords: mcp,claude,ai,tools,agent,llm,research,scraping,translation,code-generation,model-context-protocol,cursor,windsurf,anthropic
12
+ Classifier: Development Status :: 5 - Production/Stable
13
+ Classifier: Intended Audience :: Developers
14
+ Classifier: License :: OSI Approved :: MIT License
15
+ Classifier: Programming Language :: Python :: 3
16
+ Classifier: Programming Language :: Python :: 3.10
17
+ Classifier: Programming Language :: Python :: 3.11
18
+ Classifier: Programming Language :: Python :: 3.12
19
+ Classifier: Programming Language :: Python :: 3.13
20
+ Classifier: Topic :: Software Development :: Libraries
21
+ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
22
+ Requires-Python: >=3.10
23
+ Description-Content-Type: text/markdown
24
+ Requires-Dist: mcp>=1.0.0
25
+
26
+ # AiPayGen MCP Server
27
+
28
+ **85+ AI-powered tools for Claude, Cursor, Windsurf, and any MCP-compatible AI agent.**
29
+
30
+ Research, write, code, translate, analyze, scrape the web, store agent memory, and more — all through a single MCP server.
31
+
32
+ ## Quick Start
33
+
34
+ ```bash
35
+ pip install aipaygen-mcp
36
+ ```
37
+
38
+ ### Claude Desktop
39
+
40
+ Add to `claude_desktop_config.json`:
41
+
42
+ ```json
43
+ {
44
+ "mcpServers": {
45
+ "aipaygen": {
46
+ "command": "aipaygen-mcp"
47
+ }
48
+ }
49
+ }
50
+ ```
51
+
52
+ ### Claude Code
53
+
54
+ ```bash
55
+ claude mcp add aipaygen -- aipaygen-mcp
56
+ ```
57
+
58
+ ### Cursor / Windsurf
59
+
60
+ Add to your MCP config:
61
+
62
+ ```json
63
+ {
64
+ "aipaygen": {
65
+ "command": "aipaygen-mcp"
66
+ }
67
+ }
68
+ ```
69
+
70
+ ## What You Get
71
+
72
+ | Category | Tools |
73
+ |----------|-------|
74
+ | **AI Writing** | research, write, summarize, translate, rewrite, proofread, email, headline, social |
75
+ | **AI Analysis** | analyze, sentiment, classify, compare, score, fact, keywords, extract, tag |
76
+ | **AI Code** | code, sql, regex, test_cases, json_schema, mock |
77
+ | **AI Reasoning** | plan, decide, explain, debate, outline, questions, action, timeline, pitch |
78
+ | **Advanced AI** | vision (image analysis), rag (document Q&A), diagram, workflow, pipeline, chat |
79
+ | **Web Scraping** | Google Maps, Twitter/X, Instagram, TikTok, YouTube, any website |
80
+ | **Data** | weather, crypto prices, exchange rates, holidays, web search |
81
+ | **Agent Memory** | store, recall, search, list — persistent memory across sessions |
82
+ | **Marketplace** | list services, post your own agent services for others to discover |
83
+
84
+ ## Pricing Tiers
85
+
86
+ | Tier | Price/Call | Examples |
87
+ |------|-----------|----------|
88
+ | free | $0.00 | health check, discovery |
89
+ | standard | $0.002 | sentiment, keywords, classify |
90
+ | ai | $0.006 | research, summarize, analyze, write |
91
+ | scraping | $0.01 | web scraping, social media data |
92
+ | ai_heavy | $0.02 | deep analysis, multi-step reasoning |
93
+
94
+ **Free tier:** 10 calls/day without API key.
95
+ **API key:** Unlimited calls, starting at $5. Get one at https://aipaygen.com/buy-credits
96
+
97
+ ## API Key (Optional)
98
+
99
+ Free tier gives you 10 calls/day with no key needed.
100
+
101
+ For unlimited access, set your API key:
102
+
103
+ ```bash
104
+ export AIPAYGEN_API_KEY="apk_your_key_here"
105
+ ```
106
+
107
+ Get a key at [api.aipaygen.com/buy-credits](https://api.aipaygen.com/buy-credits) — plans start at $5.
108
+
109
+ ## How It Works
110
+
111
+ AiPayGen acts as middleware between your AI agent and powerful APIs:
112
+
113
+ ```
114
+ Your AI Agent (Claude/Cursor/etc.)
115
+ ↓ MCP protocol
116
+ AiPayGen MCP Server (this package)
117
+ ↓ HTTPS
118
+ api.aipaygen.com (85+ endpoints)
119
+ ↓
120
+ Claude, GPT-4, web APIs, scrapers, etc.
121
+ ```
122
+
123
+ Your agent gets instant access to research, writing, code generation, web scraping, and more — without managing API keys for each service individually.
124
+
125
+ ## Links
126
+
127
+ - **API Docs**: [api.aipaygen.com/discover](https://api.aipaygen.com/discover)
128
+ - **GitHub**: [github.com/djautomd-lab/aipaygen](https://github.com/djautomd-lab/aipaygen)
129
+ - **Buy Credits**: [api.aipaygen.com/buy-credits](https://api.aipaygen.com/buy-credits)
130
+
131
+ ## License
132
+
133
+ MIT
134
+
135
+ <!-- mcp-name: io.github.djautomd-lab/aipaygen -->
@@ -0,0 +1,110 @@
1
+ # AiPayGen MCP Server
2
+
3
+ **85+ AI-powered tools for Claude, Cursor, Windsurf, and any MCP-compatible AI agent.**
4
+
5
+ Research, write, code, translate, analyze, scrape the web, store agent memory, and more — all through a single MCP server.
6
+
7
+ ## Quick Start
8
+
9
+ ```bash
10
+ pip install aipaygen-mcp
11
+ ```
12
+
13
+ ### Claude Desktop
14
+
15
+ Add to `claude_desktop_config.json`:
16
+
17
+ ```json
18
+ {
19
+ "mcpServers": {
20
+ "aipaygen": {
21
+ "command": "aipaygen-mcp"
22
+ }
23
+ }
24
+ }
25
+ ```
26
+
27
+ ### Claude Code
28
+
29
+ ```bash
30
+ claude mcp add aipaygen -- aipaygen-mcp
31
+ ```
32
+
33
+ ### Cursor / Windsurf
34
+
35
+ Add to your MCP config:
36
+
37
+ ```json
38
+ {
39
+ "aipaygen": {
40
+ "command": "aipaygen-mcp"
41
+ }
42
+ }
43
+ ```
44
+
45
+ ## What You Get
46
+
47
+ | Category | Tools |
48
+ |----------|-------|
49
+ | **AI Writing** | research, write, summarize, translate, rewrite, proofread, email, headline, social |
50
+ | **AI Analysis** | analyze, sentiment, classify, compare, score, fact, keywords, extract, tag |
51
+ | **AI Code** | code, sql, regex, test_cases, json_schema, mock |
52
+ | **AI Reasoning** | plan, decide, explain, debate, outline, questions, action, timeline, pitch |
53
+ | **Advanced AI** | vision (image analysis), rag (document Q&A), diagram, workflow, pipeline, chat |
54
+ | **Web Scraping** | Google Maps, Twitter/X, Instagram, TikTok, YouTube, any website |
55
+ | **Data** | weather, crypto prices, exchange rates, holidays, web search |
56
+ | **Agent Memory** | store, recall, search, list — persistent memory across sessions |
57
+ | **Marketplace** | list services, post your own agent services for others to discover |
58
+
59
+ ## Pricing Tiers
60
+
61
+ | Tier | Price/Call | Examples |
62
+ |------|-----------|----------|
63
+ | free | $0.00 | health check, discovery |
64
+ | standard | $0.002 | sentiment, keywords, classify |
65
+ | ai | $0.006 | research, summarize, analyze, write |
66
+ | scraping | $0.01 | web scraping, social media data |
67
+ | ai_heavy | $0.02 | deep analysis, multi-step reasoning |
68
+
69
+ **Free tier:** 10 calls/day without API key.
70
+ **API key:** Unlimited calls, starting at $5. Get one at https://aipaygen.com/buy-credits
71
+
72
+ ## API Key (Optional)
73
+
74
+ Free tier gives you 10 calls/day with no key needed.
75
+
76
+ For unlimited access, set your API key:
77
+
78
+ ```bash
79
+ export AIPAYGEN_API_KEY="apk_your_key_here"
80
+ ```
81
+
82
+ Get a key at [api.aipaygen.com/buy-credits](https://api.aipaygen.com/buy-credits) — plans start at $5.
83
+
84
+ ## How It Works
85
+
86
+ AiPayGen acts as middleware between your AI agent and powerful APIs:
87
+
88
+ ```
89
+ Your AI Agent (Claude/Cursor/etc.)
90
+ ↓ MCP protocol
91
+ AiPayGen MCP Server (this package)
92
+ ↓ HTTPS
93
+ api.aipaygen.com (85+ endpoints)
94
+ ↓
95
+ Claude, GPT-4, web APIs, scrapers, etc.
96
+ ```
97
+
98
+ Your agent gets instant access to research, writing, code generation, web scraping, and more — without managing API keys for each service individually.
99
+
100
+ ## Links
101
+
102
+ - **API Docs**: [api.aipaygen.com/discover](https://api.aipaygen.com/discover)
103
+ - **GitHub**: [github.com/djautomd-lab/aipaygen](https://github.com/djautomd-lab/aipaygen)
104
+ - **Buy Credits**: [api.aipaygen.com/buy-credits](https://api.aipaygen.com/buy-credits)
105
+
106
+ ## License
107
+
108
+ MIT
109
+
110
+ <!-- mcp-name: io.github.djautomd-lab/aipaygen -->
@@ -0,0 +1,3 @@
1
+ """AiPayGen MCP Server — 65+ AI tools for Claude, Cursor, and any MCP client."""
2
+
3
+ __version__ = "1.3.0"
@@ -0,0 +1,542 @@
1
+ """
2
+ AiPayGen MCP Server — thin client that proxies 65+ AI tools via api.aipaygen.com.
3
+
4
+ Install:
5
+ pip install aipaygen-mcp
6
+
7
+ Add to Claude Desktop (claude_desktop_config.json):
8
+ {
9
+ "mcpServers": {
10
+ "aipaygen": {
11
+ "command": "aipaygen-mcp",
12
+ "env": { "AIPAYGEN_API_KEY": "apk_xxx" }
13
+ }
14
+ }
15
+ }
16
+
17
+ Add to Claude Code:
18
+ claude mcp add aipaygen -- aipaygen-mcp
19
+
20
+ Set AIPAYGEN_API_KEY for unlimited access, or use the free tier (10 calls/day).
21
+ """
22
+
23
+ import os
24
+ import sys
25
+ import json
26
+ import urllib.request
27
+ import urllib.error
28
+
29
+ from mcp.server.fastmcp import FastMCP
30
+
31
+ BASE_URL = os.environ.get("AIPAYGEN_BASE_URL", "https://api.aipaygen.com")
32
+ API_KEY = os.environ.get("AIPAYGEN_API_KEY", "")
33
+
34
+ mcp = FastMCP(
35
+ "AiPayGen",
36
+ instructions=(
37
+ "AiPayGen provides 65+ AI-powered tools: research, write, code, translate, "
38
+ "analyze, summarize, vision, RAG, web scraping, agent memory, marketplace, "
39
+ "data lookups (weather, crypto, stocks, news), and more. "
40
+ "Free tier: 10 calls/day. Set AIPAYGEN_API_KEY for unlimited access."
41
+ ),
42
+ )
43
+
44
+
45
+ def _call(endpoint: str, payload: dict) -> dict:
46
+ """Call an AiPayGen API endpoint and return the JSON response."""
47
+ url = f"{BASE_URL}/{endpoint.lstrip('/')}"
48
+ data = json.dumps(payload).encode()
49
+ headers = {"Content-Type": "application/json"}
50
+ if API_KEY:
51
+ headers["Authorization"] = f"Bearer {API_KEY}"
52
+ req = urllib.request.Request(url, data=data, headers=headers, method="POST")
53
+ try:
54
+ with urllib.request.urlopen(req, timeout=120) as resp:
55
+ return json.loads(resp.read().decode())
56
+ except urllib.error.HTTPError as e:
57
+ body = e.read().decode()
58
+ try:
59
+ return json.loads(body)
60
+ except Exception:
61
+ return {"error": e.reason, "status": e.code, "detail": body[:500]}
62
+ except Exception as e:
63
+ return {"error": str(e)}
64
+
65
+
66
+ def _get(endpoint: str, params: dict = None) -> dict:
67
+ """GET an AiPayGen API endpoint."""
68
+ url = f"{BASE_URL}/{endpoint.lstrip('/')}"
69
+ if params:
70
+ qs = "&".join(f"{k}={v}" for k, v in params.items() if v is not None)
71
+ if qs:
72
+ url += f"?{qs}"
73
+ headers = {}
74
+ if API_KEY:
75
+ headers["Authorization"] = f"Bearer {API_KEY}"
76
+ req = urllib.request.Request(url, headers=headers, method="GET")
77
+ try:
78
+ with urllib.request.urlopen(req, timeout=60) as resp:
79
+ return json.loads(resp.read().decode())
80
+ except urllib.error.HTTPError as e:
81
+ body = e.read().decode()
82
+ try:
83
+ return json.loads(body)
84
+ except Exception:
85
+ return {"error": e.reason, "status": e.code, "detail": body[:500]}
86
+ except Exception as e:
87
+ return {"error": str(e)}
88
+
89
+
90
+ # ── AI Tools ──────────────────────────────────────────────────────────────
91
+
92
+ @mcp.tool()
93
+ def research(topic: str) -> dict:
94
+ """Research any topic. Returns structured summary, key points, and sources."""
95
+ return _call("research", {"topic": topic})
96
+
97
+
98
+ @mcp.tool()
99
+ def summarize(text: str, length: str = "short") -> dict:
100
+ """Summarize text. Length: short, medium, or long."""
101
+ return _call("summarize", {"text": text, "length": length})
102
+
103
+
104
+ @mcp.tool()
105
+ def analyze(content: str, question: str = "Provide a structured analysis") -> dict:
106
+ """Analyze content with a specific question or lens."""
107
+ return _call("analyze", {"content": content, "question": question})
108
+
109
+
110
+ @mcp.tool()
111
+ def translate(text: str, language: str = "Spanish") -> dict:
112
+ """Translate text to any language."""
113
+ return _call("translate", {"text": text, "language": language})
114
+
115
+
116
+ @mcp.tool()
117
+ def write(spec: str, type: str = "article") -> dict:
118
+ """Generate written content. Types: article, blog, report, story, etc."""
119
+ return _call("write", {"spec": spec, "type": type})
120
+
121
+
122
+ @mcp.tool()
123
+ def code(description: str, language: str = "Python") -> dict:
124
+ """Generate code from a description."""
125
+ return _call("code", {"description": description, "language": language})
126
+
127
+
128
+ @mcp.tool()
129
+ def explain(concept: str, level: str = "beginner", analogy: bool = True) -> dict:
130
+ """Explain a concept at a given level with optional analogy."""
131
+ return _call("explain", {"concept": concept, "level": level, "analogy": analogy})
132
+
133
+
134
+ @mcp.tool()
135
+ def qa(context: str, question: str) -> dict:
136
+ """Answer a question given context text."""
137
+ return _call("qa", {"context": context, "question": question})
138
+
139
+
140
+ @mcp.tool()
141
+ def sentiment(text: str) -> dict:
142
+ """Analyze sentiment of text."""
143
+ return _call("sentiment", {"text": text})
144
+
145
+
146
+ @mcp.tool()
147
+ def keywords(text: str, max_keywords: int = 10) -> dict:
148
+ """Extract keywords from text."""
149
+ return _call("keywords", {"text": text, "max_keywords": max_keywords})
150
+
151
+
152
+ @mcp.tool()
153
+ def classify(text: str, categories: list[str]) -> dict:
154
+ """Classify text into provided categories."""
155
+ return _call("classify", {"text": text, "categories": categories})
156
+
157
+
158
+ @mcp.tool()
159
+ def compare(text_a: str, text_b: str, focus: str = "") -> dict:
160
+ """Compare two texts with optional focus area."""
161
+ return _call("compare", {"text_a": text_a, "text_b": text_b, "focus": focus})
162
+
163
+
164
+ @mcp.tool()
165
+ def transform(text: str, instruction: str) -> dict:
166
+ """Transform text according to an instruction."""
167
+ return _call("transform", {"text": text, "instruction": instruction})
168
+
169
+
170
+ @mcp.tool()
171
+ def extract(text: str, fields: list[str] = None, schema: str = "") -> dict:
172
+ """Extract structured data from text."""
173
+ return _call("extract", {"text": text, "fields": fields or [], "schema": schema})
174
+
175
+
176
+ @mcp.tool()
177
+ def chat(messages: list[dict], system: str = "") -> dict:
178
+ """Multi-turn chat with Claude. Messages: [{"role":"user","content":"..."}]."""
179
+ return _call("chat", {"messages": messages, "system": system})
180
+
181
+
182
+ @mcp.tool()
183
+ def plan(goal: str, context: str = "", steps: int = 7) -> dict:
184
+ """Generate a step-by-step plan to achieve a goal."""
185
+ return _call("plan", {"goal": goal, "context": context, "steps": steps})
186
+
187
+
188
+ @mcp.tool()
189
+ def decide(decision: str, options: list[str] = None, criteria: str = "") -> dict:
190
+ """Help make a decision by analyzing options against criteria."""
191
+ return _call("decide", {"decision": decision, "options": options or [], "criteria": criteria})
192
+
193
+
194
+ @mcp.tool()
195
+ def proofread(text: str, style: str = "professional") -> dict:
196
+ """Proofread and suggest corrections."""
197
+ return _call("proofread", {"text": text, "style": style})
198
+
199
+
200
+ @mcp.tool()
201
+ def outline(topic: str, depth: int = 2, sections: int = 6) -> dict:
202
+ """Generate a structured outline for a topic."""
203
+ return _call("outline", {"topic": topic, "depth": depth, "sections": sections})
204
+
205
+
206
+ @mcp.tool()
207
+ def email(purpose: str, tone: str = "professional", context: str = "", recipient: str = "", length: str = "medium") -> dict:
208
+ """Draft an email."""
209
+ return _call("email", {"purpose": purpose, "tone": tone, "context": context, "recipient": recipient, "length": length})
210
+
211
+
212
+ @mcp.tool()
213
+ def sql(description: str, dialect: str = "postgresql", schema: str = "") -> dict:
214
+ """Generate SQL from a natural language description."""
215
+ return _call("sql", {"description": description, "dialect": dialect, "schema": schema})
216
+
217
+
218
+ @mcp.tool()
219
+ def regex(description: str, language: str = "python", flags: str = "") -> dict:
220
+ """Generate regex from a description."""
221
+ return _call("regex", {"description": description, "language": language, "flags": flags})
222
+
223
+
224
+ @mcp.tool()
225
+ def mock(description: str, count: int = 5, format: str = "json") -> dict:
226
+ """Generate mock/sample data."""
227
+ return _call("mock", {"description": description, "count": count, "format": format})
228
+
229
+
230
+ @mcp.tool()
231
+ def score(content: str, criteria: list[str] = None, scale: int = 10) -> dict:
232
+ """Score content against criteria."""
233
+ return _call("score", {"content": content, "criteria": criteria, "scale": scale})
234
+
235
+
236
+ @mcp.tool()
237
+ def timeline(text: str, direction: str = "chronological") -> dict:
238
+ """Extract a timeline of events from text."""
239
+ return _call("timeline", {"text": text, "direction": direction})
240
+
241
+
242
+ @mcp.tool()
243
+ def action(text: str) -> dict:
244
+ """Extract action items from text."""
245
+ return _call("action", {"text": text})
246
+
247
+
248
+ @mcp.tool()
249
+ def pitch(product: str, audience: str = "general", length: str = "30s") -> dict:
250
+ """Generate a pitch for a product/idea."""
251
+ return _call("pitch", {"product": product, "audience": audience, "length": length})
252
+
253
+
254
+ @mcp.tool()
255
+ def debate(topic: str, perspective: str = "balanced") -> dict:
256
+ """Generate a structured debate on a topic."""
257
+ return _call("debate", {"topic": topic, "perspective": perspective})
258
+
259
+
260
+ @mcp.tool()
261
+ def headline(content: str, count: int = 5, style: str = "engaging") -> dict:
262
+ """Generate headlines for content."""
263
+ return _call("headline", {"content": content, "count": count, "style": style})
264
+
265
+
266
+ @mcp.tool()
267
+ def fact(text: str, count: int = 10) -> dict:
268
+ """Extract or generate facts from text."""
269
+ return _call("fact", {"text": text, "count": count})
270
+
271
+
272
+ @mcp.tool()
273
+ def rewrite(text: str, audience: str = "general audience", tone: str = "neutral") -> dict:
274
+ """Rewrite text for a target audience and tone."""
275
+ return _call("rewrite", {"text": text, "audience": audience, "tone": tone})
276
+
277
+
278
+ @mcp.tool()
279
+ def tag(text: str, taxonomy: list[str] = None, max_tags: int = 10) -> dict:
280
+ """Tag text with categories from a taxonomy."""
281
+ return _call("tag", {"text": text, "taxonomy": taxonomy, "max_tags": max_tags})
282
+
283
+
284
+ @mcp.tool()
285
+ def questions(content: str, type: str = "faq", count: int = 5) -> dict:
286
+ """Generate questions from content."""
287
+ return _call("questions", {"content": content, "type": type, "count": count})
288
+
289
+
290
+ @mcp.tool()
291
+ def social(topic: str, platforms: list[str] = None, tone: str = "engaging") -> dict:
292
+ """Generate social media posts for a topic."""
293
+ return _call("social", {"topic": topic, "platforms": platforms or ["twitter", "linkedin"], "tone": tone})
294
+
295
+
296
+ # ── Advanced AI ───────────────────────────────────────────────────────────
297
+
298
+ @mcp.tool()
299
+ def vision(image_url: str, question: str = "Describe this image in detail") -> dict:
300
+ """Analyze an image by URL. Supports any image format."""
301
+ return _call("vision", {"image_url": image_url, "question": question})
302
+
303
+
304
+ @mcp.tool()
305
+ def rag(documents: str, query: str) -> dict:
306
+ """RAG: Answer a query using provided documents as context."""
307
+ return _call("rag", {"documents": documents, "query": query})
308
+
309
+
310
+ @mcp.tool()
311
+ def diagram(description: str, diagram_type: str = "flowchart") -> dict:
312
+ """Generate a Mermaid diagram from a description."""
313
+ return _call("diagram", {"description": description, "type": diagram_type})
314
+
315
+
316
+ @mcp.tool()
317
+ def json_schema(description: str, example: str = "") -> dict:
318
+ """Generate a JSON schema from a description."""
319
+ return _call("json_schema", {"description": description, "example": example})
320
+
321
+
322
+ @mcp.tool()
323
+ def test_cases(code_or_description: str, language: str = "python") -> dict:
324
+ """Generate test cases for code or a feature description."""
325
+ return _call("test_cases", {"code": code_or_description, "language": language})
326
+
327
+
328
+ @mcp.tool()
329
+ def workflow(goal: str, context: str = "") -> dict:
330
+ """Design a multi-step workflow to achieve a goal."""
331
+ return _call("workflow", {"goal": goal, "context": context})
332
+
333
+
334
+ @mcp.tool()
335
+ def pipeline(steps: list[dict]) -> dict:
336
+ """Chain multiple AI operations. Each step: {"tool":"research","input":{"topic":"X"}}."""
337
+ return _call("pipeline", {"steps": steps})
338
+
339
+
340
+ # ── Data & Web ────────────────────────────────────────────────────────────
341
+
342
+ @mcp.tool()
343
+ def web_search(query: str, n_results: int = 10) -> dict:
344
+ """Search the web and return results."""
345
+ return _call("search", {"query": query, "n_results": n_results})
346
+
347
+
348
+ @mcp.tool()
349
+ def get_weather(city: str) -> dict:
350
+ """Get current weather for a city."""
351
+ return _get("data/weather", {"city": city})
352
+
353
+
354
+ @mcp.tool()
355
+ def get_crypto_prices(symbols: str = "bitcoin,ethereum") -> dict:
356
+ """Get current cryptocurrency prices."""
357
+ return _get("data/crypto", {"symbols": symbols})
358
+
359
+
360
+ @mcp.tool()
361
+ def get_exchange_rates(base_currency: str = "USD") -> dict:
362
+ """Get current exchange rates."""
363
+ return _get("data/exchange-rates", {"base": base_currency})
364
+
365
+
366
+ @mcp.tool()
367
+ def get_joke() -> dict:
368
+ """Get a random joke."""
369
+ return _get("data/joke")
370
+
371
+
372
+ @mcp.tool()
373
+ def get_quote() -> dict:
374
+ """Get an inspirational quote."""
375
+ return _get("data/quote")
376
+
377
+
378
+ @mcp.tool()
379
+ def get_holidays(country: str = "US", year: str = "2026") -> dict:
380
+ """Get public holidays for a country."""
381
+ return _get("data/holidays", {"country": country, "year": year})
382
+
383
+
384
+ # ── Web Scraping ──────────────────────────────────────────────────────────
385
+
386
+ @mcp.tool()
387
+ def scrape_google_maps(query: str, max_results: int = 5) -> dict:
388
+ """Scrape Google Maps for businesses matching a query."""
389
+ return _call("scrape", {"actor": "google_maps", "query": query, "max_results": max_results})
390
+
391
+
392
+ @mcp.tool()
393
+ def scrape_tweets(query: str, max_results: int = 20) -> dict:
394
+ """Scrape tweets matching a query."""
395
+ return _call("scrape", {"actor": "twitter", "query": query, "max_results": max_results})
396
+
397
+
398
+ @mcp.tool()
399
+ def scrape_website(url: str, max_pages: int = 3) -> dict:
400
+ """Scrape a website's content."""
401
+ return _call("scrape", {"actor": "website", "url": url, "max_pages": max_pages})
402
+
403
+
404
+ @mcp.tool()
405
+ def scrape_youtube(query: str, max_results: int = 5) -> dict:
406
+ """Search and scrape YouTube videos."""
407
+ return _call("scrape", {"actor": "youtube", "query": query, "max_results": max_results})
408
+
409
+
410
+ @mcp.tool()
411
+ def scrape_instagram(username: str, max_posts: int = 5) -> dict:
412
+ """Scrape Instagram posts from a user."""
413
+ return _call("scrape", {"actor": "instagram", "username": username, "max_posts": max_posts})
414
+
415
+
416
+ @mcp.tool()
417
+ def scrape_tiktok(username: str, max_videos: int = 5) -> dict:
418
+ """Scrape TikTok videos from a user."""
419
+ return _call("scrape", {"actor": "tiktok", "username": username, "max_videos": max_videos})
420
+
421
+
422
+ # ── Agent Memory ──────────────────────────────────────────────────────────
423
+
424
+ @mcp.tool()
425
+ def memory_store(agent_id: str, key: str, value: str, tags: str = "") -> dict:
426
+ """Store a value in persistent agent memory. Survives across sessions."""
427
+ return _call("memory/set", {"agent_id": agent_id, "key": key, "value": value, "tags": tags})
428
+
429
+
430
+ @mcp.tool()
431
+ def memory_recall(agent_id: str, key: str) -> dict:
432
+ """Recall a specific memory by key."""
433
+ return _call("memory/get", {"agent_id": agent_id, "key": key})
434
+
435
+
436
+ @mcp.tool()
437
+ def memory_find(agent_id: str, query: str) -> dict:
438
+ """Search agent memory by semantic query."""
439
+ return _call("memory/search", {"agent_id": agent_id, "query": query})
440
+
441
+
442
+ @mcp.tool()
443
+ def memory_keys(agent_id: str) -> dict:
444
+ """List all memory keys for an agent."""
445
+ return _call("memory/list", {"agent_id": agent_id})
446
+
447
+
448
+ # ── Marketplace ───────────────────────────────────────────────────────────
449
+
450
+ @mcp.tool()
451
+ def list_marketplace(category: str = None) -> dict:
452
+ """Browse the agent services marketplace."""
453
+ params = {}
454
+ if category:
455
+ params["category"] = category
456
+ return _get("marketplace/services", params)
457
+
458
+
459
+ @mcp.tool()
460
+ def post_to_marketplace(agent_id: str, name: str, description: str,
461
+ category: str = "general", price: float = 0.0,
462
+ endpoint: str = "") -> dict:
463
+ """List your agent service on the marketplace for other agents to discover."""
464
+ return _call("marketplace/list", {
465
+ "agent_id": agent_id, "name": name, "description": description,
466
+ "category": category, "price": price, "endpoint": endpoint,
467
+ })
468
+
469
+
470
+ # ── Utility ───────────────────────────────────────────────────────────────
471
+
472
+ @mcp.tool()
473
+ def generate_api_key(label: str = "") -> dict:
474
+ """Generate a free AiPayGen API key. Top up at https://api.aipaygen.com/buy-credits."""
475
+ return _call("keys/generate", {"label": label})
476
+
477
+
478
+ @mcp.tool()
479
+ def check_balance(key: str) -> dict:
480
+ """Check the balance of an AiPayGen API key."""
481
+ return _get("keys/balance", {"key": key})
482
+
483
+
484
+ @mcp.tool()
485
+ def list_models() -> dict:
486
+ """List all available AI models and their pricing."""
487
+ return _get("models")
488
+
489
+
490
+ # ── Skills System ─────────────────────────────────────────────────────────
491
+
492
+ @mcp.tool()
493
+ def ask(question: str) -> dict:
494
+ """Universal endpoint — ask anything. AiPayGen picks the best skill and model automatically."""
495
+ return _call("ask", {"question": question})
496
+
497
+
498
+ @mcp.tool()
499
+ def list_skills(category: str = "") -> dict:
500
+ """List all available skills. AiPayGen has 65+ built-in skills and absorbs new ones dynamically."""
501
+ params = {}
502
+ if category:
503
+ params["category"] = category
504
+ return _get("skills", params)
505
+
506
+
507
+ @mcp.tool()
508
+ def execute_skill(skill_name: str, input_text: str) -> dict:
509
+ """Execute a specific skill by name. Use list_skills to see available skills."""
510
+ return _call("skills/execute", {"skill": skill_name, "input": input_text})
511
+
512
+
513
+ @mcp.tool()
514
+ def create_skill(name: str, description: str, prompt_template: str, category: str = "general") -> dict:
515
+ """Create a new reusable skill. prompt_template must contain {{input}} placeholder."""
516
+ return _call("skills/create", {
517
+ "name": name, "description": description,
518
+ "prompt_template": prompt_template, "category": category,
519
+ })
520
+
521
+
522
+ @mcp.tool()
523
+ def absorb_skill(url: str = "", text: str = "") -> dict:
524
+ """Absorb a new skill from a URL or text description. AiPayGen reads it and creates a callable skill."""
525
+ return _call("skills/absorb", {"url": url, "text": text})
526
+
527
+
528
+ @mcp.tool()
529
+ def search_skills(query: str) -> dict:
530
+ """Search for skills by keyword."""
531
+ return _get("skills/search", {"q": query})
532
+
533
+
534
+ def main():
535
+ if "--http" in sys.argv:
536
+ mcp.run(transport="streamable-http")
537
+ else:
538
+ mcp.run(transport="stdio")
539
+
540
+
541
+ if __name__ == "__main__":
542
+ main()
@@ -0,0 +1,135 @@
1
+ Metadata-Version: 2.4
2
+ Name: aipaygen-mcp
3
+ Version: 1.3.0
4
+ Summary: 85+ AI tools for Claude, Cursor, and any MCP-compatible agent — research, write, code, scrape, translate, and more
5
+ Author-email: AiPayGen <hello@aipaygen.com>
6
+ License: MIT
7
+ Project-URL: Homepage, https://aipaygen.com
8
+ Project-URL: Documentation, https://api.aipaygen.com/discover
9
+ Project-URL: Repository, https://github.com/djautomd-lab/aipaygen
10
+ Project-URL: Issues, https://github.com/djautomd-lab/aipaygen/issues
11
+ Keywords: mcp,claude,ai,tools,agent,llm,research,scraping,translation,code-generation,model-context-protocol,cursor,windsurf,anthropic
12
+ Classifier: Development Status :: 5 - Production/Stable
13
+ Classifier: Intended Audience :: Developers
14
+ Classifier: License :: OSI Approved :: MIT License
15
+ Classifier: Programming Language :: Python :: 3
16
+ Classifier: Programming Language :: Python :: 3.10
17
+ Classifier: Programming Language :: Python :: 3.11
18
+ Classifier: Programming Language :: Python :: 3.12
19
+ Classifier: Programming Language :: Python :: 3.13
20
+ Classifier: Topic :: Software Development :: Libraries
21
+ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
22
+ Requires-Python: >=3.10
23
+ Description-Content-Type: text/markdown
24
+ Requires-Dist: mcp>=1.0.0
25
+
26
+ # AiPayGen MCP Server
27
+
28
+ **85+ AI-powered tools for Claude, Cursor, Windsurf, and any MCP-compatible AI agent.**
29
+
30
+ Research, write, code, translate, analyze, scrape the web, store agent memory, and more — all through a single MCP server.
31
+
32
+ ## Quick Start
33
+
34
+ ```bash
35
+ pip install aipaygen-mcp
36
+ ```
37
+
38
+ ### Claude Desktop
39
+
40
+ Add to `claude_desktop_config.json`:
41
+
42
+ ```json
43
+ {
44
+ "mcpServers": {
45
+ "aipaygen": {
46
+ "command": "aipaygen-mcp"
47
+ }
48
+ }
49
+ }
50
+ ```
51
+
52
+ ### Claude Code
53
+
54
+ ```bash
55
+ claude mcp add aipaygen -- aipaygen-mcp
56
+ ```
57
+
58
+ ### Cursor / Windsurf
59
+
60
+ Add to your MCP config:
61
+
62
+ ```json
63
+ {
64
+ "aipaygen": {
65
+ "command": "aipaygen-mcp"
66
+ }
67
+ }
68
+ ```
69
+
70
+ ## What You Get
71
+
72
+ | Category | Tools |
73
+ |----------|-------|
74
+ | **AI Writing** | research, write, summarize, translate, rewrite, proofread, email, headline, social |
75
+ | **AI Analysis** | analyze, sentiment, classify, compare, score, fact, keywords, extract, tag |
76
+ | **AI Code** | code, sql, regex, test_cases, json_schema, mock |
77
+ | **AI Reasoning** | plan, decide, explain, debate, outline, questions, action, timeline, pitch |
78
+ | **Advanced AI** | vision (image analysis), rag (document Q&A), diagram, workflow, pipeline, chat |
79
+ | **Web Scraping** | Google Maps, Twitter/X, Instagram, TikTok, YouTube, any website |
80
+ | **Data** | weather, crypto prices, exchange rates, holidays, web search |
81
+ | **Agent Memory** | store, recall, search, list — persistent memory across sessions |
82
+ | **Marketplace** | list services, post your own agent services for others to discover |
83
+
84
+ ## Pricing Tiers
85
+
86
+ | Tier | Price/Call | Examples |
87
+ |------|-----------|----------|
88
+ | free | $0.00 | health check, discovery |
89
+ | standard | $0.002 | sentiment, keywords, classify |
90
+ | ai | $0.006 | research, summarize, analyze, write |
91
+ | scraping | $0.01 | web scraping, social media data |
92
+ | ai_heavy | $0.02 | deep analysis, multi-step reasoning |
93
+
94
+ **Free tier:** 10 calls/day without API key.
95
+ **API key:** Unlimited calls, starting at $5. Get one at https://aipaygen.com/buy-credits
96
+
97
+ ## API Key (Optional)
98
+
99
+ Free tier gives you 10 calls/day with no key needed.
100
+
101
+ For unlimited access, set your API key:
102
+
103
+ ```bash
104
+ export AIPAYGEN_API_KEY="apk_your_key_here"
105
+ ```
106
+
107
+ Get a key at [api.aipaygen.com/buy-credits](https://api.aipaygen.com/buy-credits) — plans start at $5.
108
+
109
+ ## How It Works
110
+
111
+ AiPayGen acts as middleware between your AI agent and powerful APIs:
112
+
113
+ ```
114
+ Your AI Agent (Claude/Cursor/etc.)
115
+ ↓ MCP protocol
116
+ AiPayGen MCP Server (this package)
117
+ ↓ HTTPS
118
+ api.aipaygen.com (85+ endpoints)
119
+ ↓
120
+ Claude, GPT-4, web APIs, scrapers, etc.
121
+ ```
122
+
123
+ Your agent gets instant access to research, writing, code generation, web scraping, and more — without managing API keys for each service individually.
124
+
125
+ ## Links
126
+
127
+ - **API Docs**: [api.aipaygen.com/discover](https://api.aipaygen.com/discover)
128
+ - **GitHub**: [github.com/djautomd-lab/aipaygen](https://github.com/djautomd-lab/aipaygen)
129
+ - **Buy Credits**: [api.aipaygen.com/buy-credits](https://api.aipaygen.com/buy-credits)
130
+
131
+ ## License
132
+
133
+ MIT
134
+
135
+ <!-- mcp-name: io.github.djautomd-lab/aipaygen -->
@@ -0,0 +1,10 @@
1
+ README.md
2
+ pyproject.toml
3
+ aipaygen_mcp/__init__.py
4
+ aipaygen_mcp/server.py
5
+ aipaygen_mcp.egg-info/PKG-INFO
6
+ aipaygen_mcp.egg-info/SOURCES.txt
7
+ aipaygen_mcp.egg-info/dependency_links.txt
8
+ aipaygen_mcp.egg-info/entry_points.txt
9
+ aipaygen_mcp.egg-info/requires.txt
10
+ aipaygen_mcp.egg-info/top_level.txt
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ aipaygen-mcp = aipaygen_mcp.server:main
@@ -0,0 +1 @@
1
+ mcp>=1.0.0
@@ -0,0 +1 @@
1
+ aipaygen_mcp
@@ -0,0 +1,41 @@
1
+ [build-system]
2
+ requires = ["setuptools>=68.0", "wheel"]
3
+ build-backend = "setuptools.build_meta"
4
+
5
+ [project]
6
+ name = "aipaygen-mcp"
7
+ version = "1.3.0"
8
+ description = "85+ AI tools for Claude, Cursor, and any MCP-compatible agent — research, write, code, scrape, translate, and more"
9
+ readme = "README.md"
10
+ license = {text = "MIT"}
11
+ requires-python = ">=3.10"
12
+ authors = [{name = "AiPayGen", email = "hello@aipaygen.com"}]
13
+ keywords = [
14
+ "mcp", "claude", "ai", "tools", "agent", "llm",
15
+ "research", "scraping", "translation", "code-generation",
16
+ "model-context-protocol", "cursor", "windsurf", "anthropic",
17
+ ]
18
+ classifiers = [
19
+ "Development Status :: 5 - Production/Stable",
20
+ "Intended Audience :: Developers",
21
+ "License :: OSI Approved :: MIT License",
22
+ "Programming Language :: Python :: 3",
23
+ "Programming Language :: Python :: 3.10",
24
+ "Programming Language :: Python :: 3.11",
25
+ "Programming Language :: Python :: 3.12",
26
+ "Programming Language :: Python :: 3.13",
27
+ "Topic :: Software Development :: Libraries",
28
+ "Topic :: Scientific/Engineering :: Artificial Intelligence",
29
+ ]
30
+ dependencies = [
31
+ "mcp>=1.0.0",
32
+ ]
33
+
34
+ [project.urls]
35
+ Homepage = "https://aipaygen.com"
36
+ Documentation = "https://api.aipaygen.com/discover"
37
+ Repository = "https://github.com/djautomd-lab/aipaygen"
38
+ Issues = "https://github.com/djautomd-lab/aipaygen/issues"
39
+
40
+ [project.scripts]
41
+ aipaygen-mcp = "aipaygen_mcp.server:main"
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+