diff --git a/packages/server/src/api.ts b/packages/server/src/api.ts
index 9f50b390..7610c97f 100644
--- a/packages/server/src/api.ts
+++ b/packages/server/src/api.ts
@@ -1,5 +1,5 @@
 import * as API from '@ucanto/interface'
-import { InferCaveats, CanIssue } from '@ucanto/interface'
+import { InferCaveats, CanIssue, ParsedCapability } from '@ucanto/interface'
 
 export * from '@ucanto/interface'
 
@@ -28,3 +28,10 @@ export interface ProviderContext<
 
   context: API.InvocationContext
 }
+
+export interface ProviderInput<T extends ParsedCapability> {
+  capability: T
+  invocation: API.Invocation<API.Capability<T['can'], T['with']> & T['caveats']>
+
+  context: API.InvocationContext
+}
diff --git a/packages/server/src/handler.js b/packages/server/src/handler.js
index 20ef648d..f2a9afed 100644
--- a/packages/server/src/handler.js
+++ b/packages/server/src/handler.js
@@ -2,15 +2,11 @@ import * as API from './api.js'
 import { access } from '@ucanto/validator'
 
 /**
- * @template {API.Ability} A
- * @template {API.Caveats} C
- * @template {API.URI} R
+ * @template {API.ParsedCapability} T
  * @template {unknown} U
- * @template {API.Match} Z
- * @template {API.ParsedCapability<A, R, API.InferCaveats<C>>} T
- * @param {API.CapabilityParser<API.Match<T, Z>>} capability
- * @param {(input:API.ProviderContext<A, R, C>) => API.Await<U>} handler
- * @returns {API.ServiceMethod<API.Capability<A, R['href']> & API.InferCaveats<C>, Exclude<U, {error:true}>, Exclude<U, Exclude<U, {error:true}>>>}
+ * @param {API.CapabilityParser<API.Match<T>>} capability
+ * @param {(input:API.ProviderInput<T>) => API.Await<U>} handler
+ * @returns {API.ServiceMethod<API.Capability<T['can'], T['with']> & T['caveats'], Exclude<U, {error:true}>, Exclude<U, Exclude<U, {error:true}>>>}
  */
 
 export const provide =
@@ -18,7 +14,6 @@ export const provide =
   /**
    * @param {API.Invocation<API.Capability<T['can'], T['with']> & T['caveats']>} invocation
    * @param {API.InvocationContext} options
-   * @return {Promise<API.Result<Exclude<U, {error:true}>, Exclude<U, Exclude<U, {error:true}>>|API.InvocationError>>}
    */
   async (invocation, options) => {
     const authorization = await access(invocation, {