Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions .antigravity-plugin/plugin.json
Original file line number Diff line number Diff line change
Expand Up @@ -19,8 +19,8 @@
"stackone actions"
],
"suggestedPrompts": [
"Use StackOne to list the accounts I have connected.",
"Use StackOne to find and run the action that creates a Jira issue.",
"Use StackOne to pull my open Workday time-off requests."
"Which apps do I have connected through StackOne?",
"Use StackOne to show me the five most recently updated records in a connected app.",
"Help me update a record through StackOne. Show me the proposed change before saving it."
]
}
6 changes: 3 additions & 3 deletions .codex-plugin/plugin.json
Original file line number Diff line number Diff line change
Expand Up @@ -34,9 +34,9 @@
"composerIcon": "./assets/logo.png",
"brandColor": "#000000",
"defaultPrompt": [
"Use StackOne to list the accounts I have connected.",
"Use StackOne to find and run the action that creates a Jira issue.",
"Use StackOne to pull my open Workday time-off requests."
"Which apps do I have connected through StackOne?",
"Use StackOne to show me the five most recently updated records in a connected app.",
"Help me update a record through StackOne. Show me the proposed change before saving it."
]
}
}
11 changes: 6 additions & 5 deletions .github/workflows/validate.yml
Original file line number Diff line number Diff line change
Expand Up @@ -45,15 +45,15 @@ jobs:
"https://storage.googleapis.com/antigravity-public/antigravity-cli/$AGY_BUILD/linux-x64/cli_linux_x64.tar.gz" -o agy.tar.gz
echo "$AGY_SHA512 agy.tar.gz" | sha512sum --check
tar -xzf agy.tar.gz antigravity
- name: Validate the bundle and check the installed MCP server
- name: Validate the bundle and check the installed skill and MCP server
shell: bash
run: |
"$RUNNER_TEMP/antigravity" plugin validate --json . | jq -e '
.manifest == ".antigravity-plugin/plugin.json" and .components.mcpServers == 1 and
.manifest == ".antigravity-plugin/plugin.json" and .components.mcpServers == 1 and .components.skills >= 1 and
all(.findings[]; .severity == "warning" and (.file == ".mcp.json" or .file == "mcp.json"))'
"$RUNNER_TEMP/antigravity" plugin install .
"$RUNNER_TEMP/antigravity" plugin list --json | jq -e '
any(.[]; .name == "stackone" and .enabled and .mcpServers == ["stackone"])'
any(.[]; .name == "stackone" and .enabled and .mcpServers == ["stackone"] and (.skills | index("stackone-actions") != null))'

claude-code:
name: Claude Code (claude plugin validate + install from source)
Expand All @@ -76,15 +76,16 @@ jobs:
run: |
claude plugin validate .claude-plugin/plugin.json
claude plugin validate .claude-plugin/marketplace.json
- name: install from this repo as a marketplace and confirm the MCP server is detected
- name: install from this repo as a marketplace and confirm the skill and MCP server are detected
env:
CLAUDE_CONFIG_DIR: ${{ runner.temp }}/claude
run: |
claude plugin marketplace add "$PWD"
claude plugin install stackone@stackone
claude plugin details stackone@stackone | tee details.txt
grep -q "MCP servers (1)" details.txt
grep -q "Skills (0)" details.txt
grep -q "Skills (1)" details.txt
grep -q "stackone-actions" details.txt

codex:
name: Codex / ChatGPT (install from source)
Expand Down
13 changes: 8 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,18 +31,20 @@ The server exposes four tools:
| `stackone_list_accounts` | List the accounts (Workday, Salesforce, Notion, Jira, …) linked to your session and their ids. |
| `stackone_submit_feedback` | Report a tool result that was wrong or unhelpful. |

Example prompts once connected:
### Try it with your connected apps

- "List the accounts I have connected through StackOne."
- "Use StackOne to find my open Workday time-off requests."
- "Create a Jira issue for the bug we just discussed, via StackOne."
- “Which apps do I have connected through StackOne?”
- “Use StackOne to show me the five most recently updated records in a connected app.”
- “Help me update a record through StackOne. Show me the proposed change before saving it.”

In Antigravity, you can also type `/stackone-actions` and describe a task. The [workflow](skills/stackone-actions/SKILL.md) finds actions available to your account, uses their input schemas, and previews changes for approval.

## Authentication and data

- **Auth:** OAuth 2.1 with PKCE against `https://idp-api.stackone.com/api/auth`. The server takes either kind of client the host brings: a URL-based client ID backed by a client ID metadata document, or one from dynamic client registration. On first use your host opens the StackOne sign-in page. No API keys or secrets live in this repo.
- **Scopes:** `mcp`, `offline_access` (refresh tokens so you sign in once).
- **Network endpoints this plugin calls:** `mcp.stackone.com` (the MCP server) and `idp-api.stackone.com` (sign-in). Nothing else.
- **What runs locally:** nothing. No hooks, no scripts, no bundled binaries. The plugin is a manifest and a server URL.
- **What runs locally:** nothing. No hooks, no scripts, no bundled binaries. The bundled skill is Markdown. StackOne runs the actions on its hosted MCP server.
- **Data:** actions run against the SaaS accounts you have linked in StackOne, under the permissions of that link. Privacy policy: <https://www.stackone.com/terms/privacy-policy/>. Terms: <https://www.stackone.com/terms/saas-terms/>.

## Repository layout
Expand All @@ -61,6 +63,7 @@ stackone-plugin/
├── mcp_config.json # server config read by Antigravity
├── mcp.json # server config read by Cursor
├── .mcp.json # server config read by Claude Code, Grok Build, Codex
├── skills/stackone-actions/SKILL.md # Connected-app workflow
├── assets/logo.png, logo.svg
└── scripts/check-manifests.py
```
Expand Down
2 changes: 1 addition & 1 deletion scripts/validate-grok.py
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ def load(name, rel):
errors.append(f"xAI extractor sees transport {servers[0].get('description')!r}, expected 'http'")
for k in ("hooks", "lspServers", "commands", "agents"):
if extracted.get("components", {}).get(k):
errors.append(f"plugin unexpectedly ships {k}: {extracted['components'][k]} (this plugin is MCP-only)")
errors.append(f"plugin unexpectedly ships {k}: {extracted['components'][k]}")

entry = json.loads((repo / "marketplace/xai-catalog-entry.json").read_text())
sha = os.environ.get("GITHUB_SHA") or subprocess.check_output(["git", "rev-parse", "HEAD"], cwd=repo, text=True).strip()
Expand Down
15 changes: 15 additions & 0 deletions skills/stackone-actions/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
---
name: stackone-actions
description: Use StackOne to discover connected apps, look up records, or make a user-approved change in a connected account.
---

# Work with connected apps through StackOne

For “what do I have connected?”, call `stackone_list_accounts` and show the app and account names. If the list is empty, explain that the user needs to link an account in StackOne. If the tool requires sign-in, direct the user to the host’s StackOne sign-in control.

For a task in a connected app:

1. Describe the task to `stackone_search_actions`. Narrow by provider when the user names an app. Use the returned `available_accounts` to identify the destination. If several accounts fit and the request leaves the choice open, ask which one to use.
2. Build the request from the selected action’s `example_request` and `input_schema`. Keep the returned `action_id` and `session_id`, fill the required fields with real values, and pass the selected `stackone_account_id` when needed. Resolve a record by searching or listing it if the user supplied a name. Ask when multiple records match.
3. For a lookup, call `stackone_execute_action` and summarize the requested results. Honor filters, ordering, and limits supported by the action. If you cannot establish which records are most recent, say so. For a change, show the account, target and proposed values. Execute only after the user approves that specific change. A request for a draft ends at the preview.
4. Report what the tool confirmed, with the record link or ID when available. If a write times out, check the target before retrying to avoid applying the change twice.