diff --git a/plugins/khmuhtadin/1toolring/LICENSE b/plugins/khmuhtadin/1toolring/LICENSE new file mode 100644 index 00000000..d8d5025d --- /dev/null +++ b/plugins/khmuhtadin/1toolring/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 Khaisa Studio (Khairul Muhtadin) + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/plugins/khmuhtadin/1toolring/README.md b/plugins/khmuhtadin/1toolring/README.md new file mode 100644 index 00000000..52c7881e --- /dev/null +++ b/plugins/khmuhtadin/1toolring/README.md @@ -0,0 +1,36 @@ +# 1ToolRing + +Pay-per-call access to thousands of tools from third-party providers through one 1ToolRing key: web search, maps and places, shopping and prices, market data (stocks, crypto, FX), web pages, images, weather, jobs and more. The price is shown before every call and failed calls are never charged. There is no subscription: you top up a prepaid balance and spend it per call. + +## What you need + +- A 1ToolRing account and API key from https://app.1toolring.com/keys (free sign-up, starter balance after email verification). +- MiniMax Code with this Plugin installed. + +## MCP server + +| | | +|-|-| +| Endpoint | `https://mcp.1toolring.com/mcp` (Streamable HTTP) | +| Auth | `Authorization: Bearer ` | +| Tools | `discover_tools` (free), `inspect_tool` (free), `run_tool` (paid), `get_tool_run` (free) | +| Docs | https://docs.1toolring.com/overview/ | + +The Plugin ships the server definition in `mcp.json` and a Skill that teaches the model the discover, inspect, run order. The API key is not stored in this package: fill it into the server headers in your client's MCP settings. + +## Example prompts + +- "Find a supplier price for a Raspberry Pi 5 and show the cheapest three options." +- "What is the weather in Pontianak tomorrow at 09:00?" +- "Search the web for the latest GLM release notes and summarise the changes." + +## Network, data and side effects + +- Every tool call goes over HTTPS to `https://mcp.1toolring.com/mcp`. +- Data sent: the arguments you pass to the tool (for example a search query or a URL to scrape). +- Paid calls debit your prepaid balance; the price is returned by `inspect_tool` before you spend. +- No local file writes, no command execution, no telemetry from this package. + +## Licence and provenance + +Plugin wrapper by Khaisa Studio (Khairul Muhtadin), MIT licensed. The hosted service is operated by Khaisa Studio. Source and examples: https://github.com/khmuhtadin/1toolring-mcp. diff --git a/plugins/khmuhtadin/1toolring/mcp.json b/plugins/khmuhtadin/1toolring/mcp.json new file mode 100644 index 00000000..8cdbbbe0 --- /dev/null +++ b/plugins/khmuhtadin/1toolring/mcp.json @@ -0,0 +1,12 @@ +{ + "$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json", + "mcpServers": { + "1toolring": { + "type": "streamable-http", + "url": "https://mcp.1toolring.com/mcp", + "headers": { + "Authorization": "Bearer YOUR_API_KEY" + } + } + } +} diff --git a/plugins/khmuhtadin/1toolring/plugin.json b/plugins/khmuhtadin/1toolring/plugin.json new file mode 100644 index 00000000..369c9a67 --- /dev/null +++ b/plugins/khmuhtadin/1toolring/plugin.json @@ -0,0 +1,24 @@ +{ + "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json", + "name": "1toolring", + "version": "0.1.0", + "description": "Pay-per-call access to thousands of tools from third-party providers through one 1ToolRing key: web search, maps and places, shopping and prices, market data, web pages, images, weather and more.", + "author": { + "name": "Khaisa Studio", + "url": "https://1toolring.com" + }, + "license": "MIT", + "homepage": "https://1toolring.com", + "repository": "https://github.com/khmuhtadin/1toolring-mcp", + "keywords": [ + "minimax-code", + "plugin", + "mcp", + "search", + "maps", + "shopping", + "market-data", + "web-scraping", + "pay-per-call" + ] +} diff --git a/plugins/khmuhtadin/1toolring/skills/1toolring-tools/SKILL.md b/plugins/khmuhtadin/1toolring/skills/1toolring-tools/SKILL.md new file mode 100644 index 00000000..8747935f --- /dev/null +++ b/plugins/khmuhtadin/1toolring/skills/1toolring-tools/SKILL.md @@ -0,0 +1,25 @@ +--- +name: 1toolring-tools +description: Discover, price and run pay-per-call third-party tools through 1ToolRing. +--- + +# 1ToolRing tools + +Use this skill when the request needs live data instead of a guess: web search results, places and maps, product or supplier prices, stock/crypto/FX quotes, page scraping, jobs, weather, images, or AI media generation. + +## Tools exposed by the `1toolring` MCP server + +| Tool | Cost | Use it for | +|-|-|-| +| `discover_tools` | free | Search the catalog with a short intent such as `search`, `price`, `crypto`, `weather`, `places`. | +| `inspect_tool` | free | Read a tool's input schema and the exact price of the next call. | +| `run_tool` | paid | Execute the tool with arguments that match the schema. | +| `get_tool_run` | free | Re-read a run by id when a call is slow or you need the payload again. | + +## Working rules + +1. Always `discover_tools` first, then `inspect_tool` on the candidate before spending. +2. State the price from `inspect_tool` when a run is not trivial, and pick the cheaper tool when the user only needs the headline value. +3. Match the schema exactly; a rejected call wastes a round trip. +4. Never invent numbers. If the run returns nothing usable, say so plainly. +5. Balance and top-ups live at https://1toolring.com/pricing. A depleted balance is returned as an API error rather than an empty result. diff --git a/plugins/khmuhtadin/api-indonesia/LICENSE b/plugins/khmuhtadin/api-indonesia/LICENSE new file mode 100644 index 00000000..d8d5025d --- /dev/null +++ b/plugins/khmuhtadin/api-indonesia/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 Khaisa Studio (Khairul Muhtadin) + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/plugins/khmuhtadin/api-indonesia/README.md b/plugins/khmuhtadin/api-indonesia/README.md new file mode 100644 index 00000000..a7070f0c --- /dev/null +++ b/plugins/khmuhtadin/api-indonesia/README.md @@ -0,0 +1,36 @@ +# API Indonesia + +Official Indonesian public data through one MCP server: administrative regions down to villages and postal codes, region boundaries, public holidays and joint leave days, prayer times, Hijri dates, schools, universities, hospitals, BMKG earthquakes, weather, air quality, Bank Indonesia exchange rates, provincial minimum wage, NIK and NPWP format checks, QRIS parsing, rupiah formatting, halal (BPJPH), BPOM, DJKI trademarks, OJK lists, food prices, Transjakarta, KBBI, Al-Quran and Alkitab. + +## What you need + +- An API Indonesia account and API key from https://dashboard.apiindonesia.id/register (3,000 free credits on sign-up, no card). +- MiniMax Code with this Plugin installed. + +## MCP server + +| | | +|-|-| +| Endpoint | `https://mcp.apiindonesia.id/mcp` (Streamable HTTP, 84 tools) | +| Auth | `Authorization: Bearer aip_live_...` | +| Pricing | 2 credits per successful request, failed requests are not billed | +| Docs | https://docs.apiindonesia.id | + +The Plugin ships the server definition in `mcp.json` and a Skill that explains how to pick the right tool and how to report missing records. The API key is not stored in this package: fill it into the server headers in your client's MCP settings. A REST API with the same data is available at `https://use.apiindonesia.id` using the `x-api-key` header. + +## Example prompts + +- "Which villages are in Kecamatan Pontianak Kota, with postal codes?" +- "Is 17 August 2027 a public holiday in Indonesia, and is there joint leave around it?" +- "Show BMKG earthquakes above magnitude 5 in the last 24 hours." +- "What is the minimum wage in West Kalimantan this year?" + +## Network, data and side effects + +- Every tool call goes over HTTPS to `https://mcp.apiindonesia.id/mcp`. +- Data sent: the arguments you pass (for example a region code or a date). +- No local file writes, no command execution, no telemetry from this package. + +## Licence and provenance + +Plugin wrapper by Khaisa Studio (Khairul Muhtadin), MIT licensed. The hosted service is operated by Khaisa Studio and serves data from official Indonesian sources. Source and examples: https://github.com/khmuhtadin/api-indonesia-examples. diff --git a/plugins/khmuhtadin/api-indonesia/mcp.json b/plugins/khmuhtadin/api-indonesia/mcp.json new file mode 100644 index 00000000..035548cf --- /dev/null +++ b/plugins/khmuhtadin/api-indonesia/mcp.json @@ -0,0 +1,12 @@ +{ + "$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json", + "mcpServers": { + "api-indonesia": { + "type": "streamable-http", + "url": "https://mcp.apiindonesia.id/mcp", + "headers": { + "Authorization": "Bearer YOUR_API_KEY" + } + } + } +} diff --git a/plugins/khmuhtadin/api-indonesia/plugin.json b/plugins/khmuhtadin/api-indonesia/plugin.json new file mode 100644 index 00000000..44a31f9d --- /dev/null +++ b/plugins/khmuhtadin/api-indonesia/plugin.json @@ -0,0 +1,23 @@ +{ + "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json", + "name": "api-indonesia", + "version": "0.1.0", + "description": "Official Indonesian public data through one MCP server: regions down to villages and postal codes, holidays, prayer times, schools, hospitals, earthquakes, weather, exchange rates, minimum wage and more.", + "author": { + "name": "Khaisa Studio", + "url": "https://apiindonesia.id" + }, + "license": "MIT", + "homepage": "https://apiindonesia.id", + "repository": "https://github.com/khmuhtadin/api-indonesia-examples", + "keywords": [ + "minimax-code", + "plugin", + "mcp", + "indonesia", + "government-data", + "regions", + "holidays", + "geodata" + ] +} diff --git a/plugins/khmuhtadin/api-indonesia/skills/api-indonesia-data/SKILL.md b/plugins/khmuhtadin/api-indonesia/skills/api-indonesia-data/SKILL.md new file mode 100644 index 00000000..fcc87b07 --- /dev/null +++ b/plugins/khmuhtadin/api-indonesia/skills/api-indonesia-data/SKILL.md @@ -0,0 +1,20 @@ +--- +name: api-indonesia-data +description: Look up official Indonesian public data through the API Indonesia MCP server. +--- + +# API Indonesia data + +Use this skill for questions about Indonesia that need official data rather than an estimate. + +## Coverage + +Administrative regions (province, regency or city, district, village, postal code), region boundaries as GeoJSON, public holidays and joint leave days, prayer times, Hijri dates, schools by NPSN, universities, hospitals, BMKG earthquakes, weather and warnings, air quality, Bank Indonesia exchange rates, provincial minimum wage, NIK and NPWP format checks, QRIS parsing, rupiah formatting and terbilang, halal (BPJPH), BPOM, DJKI trademarks, OJK lists, food prices, Transjakarta, KBBI, Al-Quran and Alkitab. + +## Working rules + +1. Pick the tool that matches the data type; the server exposes 84 tools, each with a title and hints. +2. Pass region codes or names exactly as the schema asks; do not translate or romanise them. +3. Quote the source the tool returns, and the data date when it is present. +4. If a lookup returns nothing, say the registry has no record for that value instead of filling the gap with a guess. +5. A successful request costs 2 credits; a failed request is not billed.